Integração com Problemas do GitHub
Funciona com GitHub
Conecte o ReplyRabbit ao GitHub Issues para que conversas de suporte no FreeScout se tornem issues estruturadas no repositório correto. Os agentes podem criar uma issue a partir de uma conversa, manter a issue vinculada visível no FreeScout e deixar o ReplyRabbit preparar a passagem para a engenharia.
Procurando a visão geral?
Visão geral
A integração com o GitHub Issues adiciona um painel do GitHub ao ReplyRabbit em uma conversa do FreeScout. Quando o GitHub está configurado, o ReplyRabbit pode criar uma issue com um título amigável para desenvolvedores, um resumo útil, rótulos, responsáveis, contexto do repositório e um link de volta para a conversa de suporte.
Cada caixa de correio escolhe um rastreador de issues: nenhum, Linear ou GitHub. GitHub e Linear são alternativas para o mesmo fluxo de suporte para engenharia, não dois rastreadores que rodam juntos em uma caixa de correio.
A criação manual de issues no GitHub está disponível no Pro e no Team. A criação automática de issues no GitHub a partir de novos e-mails de clientes está disponível no Team.
Pré-requisitos
Antes de começar, certifique-se de ter:
- Uma instalação funcional do FreeScout.
- ReplyRabbit instalado e ativado.
- Um plano do ReplyRabbit que inclua o recurso do GitHub que você deseja usar.
- Acesso a uma conta ou organização do GitHub onde as issues devem ser criadas.
- Um repositório com o GitHub Issues habilitado.
Se o ReplyRabbit ainda não estiver instalado, comece com Como instalar o módulo ReplyRabbit, então conclua Como configurar o ReplyRabbit.
Permissões e escopo de token
O ReplyRabbit se conecta ao GitHub com um token de acesso pessoal que você fornece nas configurações da caixa de correio. Recomenda-se um token refinado, limitado aos repositórios que o ReplyRabbit deve usar. Você pode criar um em Configurações de token refinado do GitHub.
Conceda ao token acesso suficiente para ler metadados do repositório, ler rótulos e responsáveis, criar e atualizar problemas e adicionar comentários a problemas. Para um token refinado, comece com Metadados: leitura, Conteúdo: leitura, e Issues: leitura e escrita para os repositórios selecionados.
Para trilhas de auditoria mais rigorosas, crie o token a partir de uma conta de bot dedicada do GitHub que tenha acesso apenas aos repositórios que o ReplyRabbit deve usar.
Mantenha o token privado. Se o token for rotacionado ou removido no GitHub, atualize as configurações da caixa de correio antes de criar mais issues.
Conectar GitHub Issues
Abra as configurações da caixa de correio
No FreeScout, abra a caixa de correio que deve criar issues no GitHub, depois abra Configurações e escolha ReplyRabbit.Escolha GitHub como rastreador de issues
No seletor de rastreador de issues, escolha Problemas do GitHub. O ReplyRabbit mostra as configurações do GitHub e oculta as configurações do Linear para essa caixa de correio.Cole o token
Cole sua Token de Acesso Pessoal do GitHub. Se você já salvou um token, o ReplyRabbit mostra uma prévia mascarada em vez do segredo completo.Carregar repositórios
Clique no botão para carregar repositórios do GitHub e escolha o repositório padrão onde novas issues devem ser criadas.Salvar configurações
Salve as configurações da caixa de correio. O ReplyRabbit armazena a conexão do GitHub para essa caixa de correio.
Configurar padrões
Depois que o repositório padrão for selecionado, configure os padrões de issue a partir dos quais seus agentes devem começar:
- Repositório padrão: escolha onde as issues são criadas quando nenhuma regra de roteamento corresponde.
- Envio automático de chamados: no nível Team, deixe o ReplyRabbit criar problemas do GitHub automaticamente quando o resultado da triagem indicar que é necessário trabalho de engenharia.
- Roteamento de repositório: ative a seleção automática de repositório quando quiser que o ReplyRabbit associe conversas aos repositórios disponíveis.
- Mapeamentos de domínio: mapeie domínios de e-mail de clientes para repositórios específicos quando precisar de roteamento determinístico.
- Rótulos: escolha rótulos que o ReplyRabbit pode aplicar para tipo de issue, prioridade ou outras tags de fluxo de trabalho.
- Rótulos de prioridade: mapeie os níveis de prioridade do ReplyRabbit para rótulos do GitHub, já que o GitHub Issues não tem um campo de prioridade nativo.
- Responsável padrão: escolha o usuário do GitHub que deve receber novas issues por padrão.
- Aviso de revisão: quando a criação automática de issues está ativada, adicione uma nota no FreeScout informando aos agentes que a issue foi criada automaticamente e deve ser revisada.
O roteamento de repositório é opcional. Se nenhum repositório for correspondido com confiança, o ReplyRabbit usa o repositório padrão.
Criar uma issue do GitHub a partir de uma conversa do FreeScout
Abra uma conversa em uma caixa de correio onde o GitHub está configurado. O painel do ReplyRabbit pode criar uma issue no GitHub a partir da thread do cliente e depois mostrar a issue vinculada no FreeScout.
O conteúdo da issue é gerado para uma transferência de engenharia, não copiado cegamente de toda a thread de e-mail. Revise o título, o resumo, os rótulos, os responsáveis e o repositório antes de criar a issue quando a criação manual for usada.
O ReplyRabbit também pode adicionar o contexto da conversa de e-mail como comentário em uma issue do GitHub, para que a engenharia tenha os detalhes do cliente sem pedir ao suporte para colar a mesma conversa novamente.
Mantenha conversas e issues em sincronia
Depois que uma issue estiver vinculada, a conversa do FreeScout pode mostrar o identificador, título, estado, rótulos e responsáveis atuais da issue no GitHub. Os agentes podem abrir a issue no GitHub quando precisarem da visão completa de engenharia.
O ReplyRabbit também suporta um ciclo de conclusão: ele verifica as issues vinculadas do GitHub em uma programação, normalmente a cada 5 minutos. Quando o GitHub fecha uma issue, o ReplyRabbit pode ajudar a redigir o acompanhamento ao cliente para que o suporte possa encerrar a conversa com contexto. Se sua equipe usa motivos de fechamento do GitHub, você pode restringir os rascunhos de conclusão a issues fechadas como concluídas.
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| Os repositórios não carregarão | Confirme se o token está atualizado e pode acessar os repositórios GitHub selecionados. |
| As issues não são criadas | Confirme se o GitHub é o rastreador de issues selecionado, se um repositório padrão está selecionado e se seu plano do ReplyRabbit inclui o recurso. |
| Chamados automáticos não são criados | Confirme se você está no plano Team e Envio automático de chamados está ativado. |
| O repositório está errado ou ausente | Confirme se o roteamento de repositórios ou os mapeamentos de domínio estão configurados. O ReplyRabbit usa o repositório padrão quando não há uma correspondência confiável. |
| Rótulos ou responsáveis não serão atualizados | Recarregue a conversa e confirme que o token ainda tem acesso ao repositório vinculado. |
| O GitHub retorna erros de limite de taxa | Aguarde a redefinição do limite da API do GitHub do token e depois considere restringir o acesso aos repositórios ou reduzir a atividade automatizada de issues. |
| Issues fechadas não geram rascunhos | Confirmar Rascunho automático ao concluir está ativado e, se o modo somente concluídos estiver ativado, o problema do GitHub foi fechado como concluído. |
Para correções mais amplas, consulte Solução de problemas do ReplyRabbit.
Privacidade e tratamento de dados
O ReplyRabbit envia ao GitHub o conteúdo da issue necessário para a transferência à engenharia. Isso pode incluir contexto relevante do cliente, o título da issue gerado, o resumo gerado, rótulos, responsáveis e o link ou identificador da conversa no FreeScout.
Não coloque informações sensíveis em uma issue do GitHub, a menos que o repositório tenha permissão para recebê-las. Se os dados do cliente precisarem permanecer inteiramente no seu próprio servidor, mantenha o GitHub desativado para essa caixa de correio.
Próximos passos
- Continuar com Como configurar o ReplyRabbit se a caixa de correio ainda precisa de configurações de provedor, contexto ou estilo.
- Ler Integração com o Slack se sua equipe quer notificações de criação ou conclusão de problemas no Slack.
- Comparar com Integração com Linear se você está decidindo qual rastreador de problemas uma caixa de correio deve usar.
FAQ
Preciso de um token de acesso pessoal do GitHub?
Sim. O ReplyRabbit se conecta ao GitHub com um token da sua própria conta ou organização do GitHub.
Uma caixa de correio pode usar Linear e GitHub ao mesmo tempo?
Não. Cada caixa de correio escolhe um rastreador de problemas: nenhum, Linear ou GitHub.
O ReplyRabbit pode escolher o repositório do GitHub?
Sim, quando o roteamento de repositório estiver configurado. O ReplyRabbit suporta mapeamentos de domínio e correspondência de repositório por IA para repositórios que seu token pode acessar.
Qual plano inclui GitHub Issues?
A criação manual de issues no GitHub é um recurso do Pro. A criação automática de issues no GitHub é um recurso do Team.
O ReplyRabbit envia toda a conversa do cliente para o GitHub?
O ReplyRabbit envia o conteúdo da issue necessário para a transferência à engenharia, incluindo contexto relevante do cliente e o resumo gerado.