- Integrações
- Jira
Integração com o Jira: um bug relatado por um cliente vira uma issue no Jira
A integração da Agenola com o Jira cria uma issue no seu projeto do Jira para um bug ou pedido relatado por um visitante, lê o status da issue e informa o visitante, e adiciona comentários e anexos à issue. A conexão é feita com um clique na sua conta da Atlassian.
Como funciona
Uma issue é criada por uma etapa do Jira adicionada ao fluxo, ou por uma ação ativada na aba Integrações da etapa Assistente de IA. Solicitações de suporte não chegam sozinhas ao Jira.
O site, o projeto e o tipo de issue são escolhidos na etapa, não na página de conexão. Se sua conta da Atlassian tem acesso a um único site do Jira, você pode deixar o site vazio; se tem acesso a vários, precisa escolher o site na etapa.
As etapas cobrem criar, obter, buscar, atualizar e excluir issues; histórico de alterações, opções de status, notificações do Jira, comentários, anexos e detalhes de usuários.
- Toda issue recebe a etiqueta "agenola", e registros marcados como urgentes também recebem a etiqueta "acil", para você filtrar no Jira as issues vindas do chat.
- As etapas do Jira são executadas em nome da pessoa que fez a conexão: as issues são criadas em nome dela e apenas em projetos aos quais ela tem acesso.
- Etapas de exclusão só são executadas quando a caixa de confirmação da etapa está marcada.
- Se a conexão ficar sem uso por 90 dias, a Atlassian revoga o acesso e você precisa reconectar.
O que ele faz
Esta lista é gerada da mesma fonte que a página de Jira no painel: se não está listado aqui, não fazemos com Jira. As etapas de fluxo ficam no editor de fluxos, em Adicionar etapa → Integrações → Jira.
IssueAção · Etapa do fluxo8
Criar issue
Cria uma issue no projeto escolhido em nome da pessoa que conectou o Jira. Toda issue recebe a etiqueta "agenola"; as urgentes também "acil".
Excluir issue
Exclui a issue permanentemente; não pode ser desfeito. Se a issue tiver subtarefas, o Jira só a exclui com “Excluir também as subtarefas” ativado.
Obter issue
Lê o título, o status, o tipo, o responsável, as etiquetas e a descrição da issue.
Buscar issues
Encontra issues no projeto escolhido ou com sua consulta e as retorna como lista. Se ambos estiverem vazios, retorna as atualizadas nos últimos 30 dias.
Obter histórico de alterações
Retorna as alterações da issue, as mais recentes primeiro; cada campo alterado tem sua própria linha.
Enviar notificação
Envia a notificação por e-mail do Jira sobre a issue. Sem destinatário escolhido, vai para o responsável e os observadores.
Obter opções de status
Retorna como lista os status para os quais a issue pode ir agora.
Atualizar issue
Altera o título, a descrição, o status, a prioridade, o responsável, as etiquetas ou o prazo; campos vazios não mudam. As etiquetas são adicionadas e as existentes ficam.
AnexoAção · Etapa do fluxo4
Adicionar anexo
Cria um arquivo de texto com o conteúdo que você escrever e o anexa à issue.
Obter anexo
Lê o nome, a URL, o tamanho e o tipo do anexo.
Obter anexos
Retorna como lista todos os anexos da issue.
Excluir anexo
Exclui um anexo da issue permanentemente.
ComentárioAção · Etapa do fluxo5
Adicionar comentário
Escreve um comentário na issue em nome da pessoa que conectou o Jira.
Obter comentário
Lê o texto, o autor e a data do comentário.
Obter comentários
Retorna como lista os comentários da issue, os mais recentes primeiro.
Atualizar comentário
Altera o texto de um comentário da issue.
Excluir comentário
Exclui um comentário da issue permanentemente.
UsuárioAção · Etapa do fluxo1
Obter usuário
Lê o nome, o e-mail e o fuso horário de um usuário do Jira. Se as configurações de privacidade ocultarem o e-mail, ele volta vazio.
Exemplos de conversas
Visitante: Seu app móvel fecha quando toco em "Pagar" na tela de checkout.
Agente: Vou passar para nossa equipe de desenvolvimento. Pode me informar o modelo do seu telefone e a versão do app?
Visitante: iPhone 13, versão 4.2.1
Agente: Registrei como MOB-482. Você pode perguntar o status com esse número.
Nos bastidores: A etapa "Criar issue" cria um bug com o título "App fecha na tela de checkout" no projeto MOB; a descrição traz o dispositivo, a versão e um resumo da conversa, e a issue recebe a etiqueta "agenola".
Visitante: Qual é o status do MOB-482, que relatei na semana passada?
Agente: O MOB-482 está "Em andamento"; nossa equipe está trabalhando em uma correção.
Nos bastidores: A etapa "Obter issue" lê o título e o status da issue no Jira, e o agente informa o status no idioma do visitante.
Visitante: Quero acrescentar algo ao MOB-482: só acontece ao pagar com cartão de crédito.
Agente: Adicionei à issue; nossa equipe vai ver.
Nos bastidores: A etapa "Adicionar comentário" escreve a observação do visitante no MOB-482 como comentário.
Configuração
- 1Na Agenola, vá para Integrações → Jira e clique em "Conectar ao Jira".
- 2Na tela de consentimento da Atlassian, escolha seu site do Jira e conceda acesso.
- 3No editor de fluxos, adicione a etapa "Criar issue" em Adicionar etapa → Integrações → Jira, e escolha o site, o projeto e o tipo de issue na etapa.
Configuração detalhada: Como criar registros no Trello e no Jira?
Permissões e para onde vão seus dados
- Enviado ao Jira: título, descrição, etiquetas, comentários e anexos da issue; os campos definidos na etapa.
- Lido do Jira: apenas quando uma etapa pede, detalhes de issues, comentários, histórico e usuários; os sites e projetos que a conta conectada acessa, para os seletores de site e projeto.
- Permissões solicitadas: ler e escrever issues do Jira, ler detalhes de usuários e acesso offline para a conexão continuar funcionando.
- Os dados de conexão são armazenados criptografados no servidor. Apenas o proprietário e os administradores do espaço de trabalho podem conectar ou remover; você também pode revogar o acesso na página Apps conectados da sua conta da Atlassian.
Integrações relacionadas
Ver todas as integrações
Perguntas frequentes
Como diferencio as issues que vieram do chat?
Toda issue recebe a etiqueta "agenola", e registros marcados como urgentes também recebem a etiqueta "acil". Você pode filtrar por essas etiquetas no Jira ou criar um quadro separado.
Usamos vários sites do Jira. O que fazer?
Se sua conta da Atlassian tem acesso a vários sites, escolha o site em cada etapa do Jira; sem isso, a etapa não é executada. Com um único site, você pode deixar o campo vazio.
Em nome de quem as issues são criadas?
Da pessoa que fez a conexão, e apenas em projetos aos quais ela tem acesso. Conectar com uma conta compartilhada da equipe mantém a conexão funcionando quando as pessoas mudam de função.