Integração com Jira
Funciona com Jira
Conecte o ReplyRabbit ao Jira Cloud para que conversas de suporte no FreeScout se tornem issues estruturadas do Jira. Os agentes podem criar uma issue do Jira a partir de uma conversa, manter a issue vinculada visível no FreeScout e usar o ReplyRabbit para preparar o acompanhamento com o cliente quando o trabalho estiver concluído.
Procurando a visão geral?
Visão geral
A integração com o Jira adiciona um painel do Jira ao ReplyRabbit em uma conversa do FreeScout. Quando o Jira está configurado para uma caixa de correio, o ReplyRabbit pode criar uma issue com título, descrição, prioridade, rótulos, responsável, tipo de issue, projeto e link de volta para a conversa de suporte.
O Jira está selecionado como rastreador de issues ativo de uma caixa de correio. Se uma caixa de correio já usa Linear ou GitHub Issues, mantenha esse rastreador selecionado até estar pronto para migrar essa caixa de correio para o Jira.
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 Jira que você deseja usar.
- Um site do Jira Cloud como
https://example.atlassian.net. - Um e-mail de conta do Jira e um token de API com acesso ao projeto de destino.
- Pelo menos um projeto e tipo de chamado do Jira que suportem a criação de chamados.
- Permissões de projeto do Jira para o fluxo de trabalho que você habilitar: Browse Projects e Create Issues são obrigatórias; Edit Issues, Assign Issues, Transition Issues e Add Comments são necessárias quando você usa edições de prioridade/rótulo, atribuição, transições de status ou comentários na conversa.
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 tokens de API
O ReplyRabbit se conecta à API REST v3 do Jira Cloud com autenticação Basic. A caixa de correio armazena três valores de conexão:
- URL do site Jira: o
https://example.atlassian.netURL do site. - E-mail da conta: o e-mail da conta Atlassian usado com o token de API.
- Token de API: o token de API do Jira Cloud para essa conta.
O token de API é armazenado como uma configuração de caixa de correio criptografada e não é exibido novamente por completo depois de salvo. Se o token for rotacionado ou removido na Atlassian, atualize as configurações da caixa de correio antes de criar mais issues.
Conectar Jira
Abra as configurações da caixa de correio
No FreeScout, abra a caixa de correio que deve criar issues no Jira, depois abra Configurações e escolha ReplyRabbit.Escolha Jira como rastreador de issues
No Integrações seção, defina o rastreador de issues como Jira. Uma caixa de correio pode usar Linear, GitHub Issues, Jira ou nenhum rastreador de issues.Adicionar credenciais do Jira
Cole a URL do site do Jira Cloud, o e-mail da conta e o token de API.Carregar projetos do Jira
Carregue projetos do Jira e escolha o projeto padrão para novas issues.Escolha o tipo de issue
Carregue os tipos de issue do projeto e escolha o tipo de issue padrão, como Task ou Bug.Salvar configurações
Salve as configurações da caixa de correio. O ReplyRabbit armazena a conexão do Jira para essa caixa de correio.
Configurar padrões
Depois que o Jira estiver conectado, configure os padrões que sua equipe precisa:
- Projeto padrão: o projeto Jira usado quando nenhum mapeamento de domínio ou correspondência de projeto por IA escolhe um projeto diferente.
- Tipo de issue padrão: o tipo de issue para novas issues, geralmente Task ou Bug.
- Mapeamento de prioridade: mapeie os níveis de prioridade do ReplyRabbit para nomes de prioridade nativos do Jira.
- Roteamento de projeto: mapeie domínios de e-mail de clientes para projetos do Jira quando o roteamento precisar ser determinístico.
- Envio automático de chamados: no nível Team, deixe o ReplyRabbit criar problemas do Jira automaticamente quando a triagem indicar que é necessário trabalho de engenharia.
- Rascunho automático ao concluir: deixe o ReplyRabbit preparar um acompanhamento com o cliente quando o problema vinculado do Jira atingir a categoria de status Done.
O roteamento de projeto é opcional. Se nenhum projeto for correspondido com confiança, o ReplyRabbit usa o projeto padrão da caixa de correio.
Criar uma issue do Jira a partir de uma conversa do FreeScout
Abra uma conversa em uma caixa de correio onde o Jira está configurado. O painel do ReplyRabbit pode criar uma issue no Jira a partir da thread do cliente e depois mostrar a issue vinculada no FreeScout.
O ReplyRabbit envia ao Jira uma descrição estruturada no Atlassian Document Format. A descrição inclui o resumo de suporte, o contexto do cliente e o link da conversa no FreeScout. O texto do cliente é tratado como conteúdo, não como instruções.
Após a criação, revise a issue do Jira vinculada e ajuste status, prioridade, responsável ou etiquetas no painel do ReplyRabbit quando necessário.
Mantenha conversas e issues em sincronia
Depois que uma issue estiver vinculada, a conversa do FreeScout pode mostrar o status, prioridade, responsável, rótulos e chave da issue atuais no Jira. Os agentes podem abrir a issue no Jira quando precisarem da visão completa de engenharia.
O ReplyRabbit altera o status do Jira por meio das transições do Jira. Ele não grava diretamente no campo de status.
O ReplyRabbit também suporta um ciclo de conclusão. Uma verificação de status agendada consulta as issues vinculadas do Jira. Quando o Jira informa a categoria de status Concluído, o ReplyRabbit pode ajudar a redigir o acompanhamento ao cliente para que o suporte possa encerrar a conversa com contexto.
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| Os projetos não carregam | Confirme se a URL do site é um Jira Cloud atlassian.net URL, o e-mail está correto e o token de API tem acesso ao projeto. |
| Os tipos de issue estão faltando | Confirme se o projeto selecionado suporta o tipo de issue que você espera usar. |
| As issues não são criadas | Confirme se o Jira está selecionado como rastreador de issues da caixa de correio, se um projeto 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 status não será atualizado | Recarregue a conversa e confirme que o Jira expõe uma transição válida para o status de destino. |
| Os rascunhos de conclusão não estão aparecendo | Confirmar Rascunho automático ao concluir está ativado e o problema vinculado do Jira atingiu a categoria de status Done. |
Para correções mais amplas, consulte Solução de problemas do ReplyRabbit.
Privacidade e tratamento de dados
O ReplyRabbit envia ao Jira o conteúdo da issue necessário para a transferência à engenharia. Isso pode incluir contexto relevante do cliente, texto da issue gerado, prioridade, rótulos, responsável e um link ou identificador da conversa no FreeScout.
Não coloque informações sensíveis em uma issue do Jira, a menos que o seu workspace do Jira Cloud tenha permissão para recebê-las. Se os dados do cliente precisarem permanecer inteiramente no seu próprio servidor, mantenha o Jira desativado para essa caixa de correio.
FAQ
O ReplyRabbit suporta Jira Data Center ou Server?
Não. O ReplyRabbit suporta sites do Jira Cloud que usam uma URL atlassian.net.
Preciso de OAuth para o Jira?
Não. O ReplyRabbit usa autenticação Basic do Jira Cloud por caixa de correio com uma URL do site, e-mail da conta e token de API do Jira.
Uma caixa de correio pode usar Jira com Linear ou GitHub Issues ao mesmo tempo?
Não. Cada caixa de correio escolhe um rastreador de problemas ativo. As configurações de Linear e GitHub Issues continuam disponíveis quando qualquer um deles está selecionado.
O ReplyRabbit pode redigir um acompanhamento ao cliente quando uma issue do Jira é concluída?
Sim. O ReplyRabbit consulta periodicamente issues vinculadas do Jira e pode preparar um rascunho de acompanhamento ao cliente quando o Jira informa a categoria de status Done.