Jira
Last updated
Last updated
Criando um API Token no Jira
Para gerar um API Token na sua conta Atlassian, siga estas etapas:
Faça o login em https://id.atlassian.com/manage-profile/security/api-tokens com um usuário que pertença ao grupo "site_admins".
Clique em "Criar um token de API".
Na caixa de diálogo exibida, insira uma descrição curta, clara e fácil de lembrar para identificar o token. Além disso, defina uma data de expiração para o token, conforme necessário.
Na sequência, clique em "Criar":
Clique em Copiar. Nota: Por motivos de segurança, não é possível visualizar o token após fechar o diálogo de criação. Se necessário, crie um token.
Você deve armazenar o token de forma segura, assim como para qualquer senha.
A Atlassian passou a expirar os tokens de integração automaticamente. Cada token criado terá validade de apenas 1 ano, sendo necessário gerar um novo token e reconfigurar a integração após esse período. Se o token expirar, basta acessar as configurações da integração e atualizar o novo token. No entanto, lembre-se de que, caso a integração seja excluída, todas as issues vinculadas aos tickets serão permanentemente perdidas.
Para realizar a integração com o Jira, acesse Configurações > Integrações > Projeto > Jira. Em seguida, na seção "Integrações a realizar", clique na opção "Jira Software", conforme ilustrado na imagem abaixo:
Na próxima tela apresentada, marque a opção "Cloud", conforme ilustrado na imagem abaixo.
Ao selecionar a opção Cloud os campos de API KEY, E-mail e URL aparecem em tela para preenchimento.
API KEY: insira aqui o seu API Token gerado no site da Atlassian.
E-mail: informe o e-mail da sua conta no Jira.
URL: cole a URL da sua conta no Jira que também pode ser coletada no site da Atlassian.
Feito o preenchimento do formulário, clique em "Próximo".
Dando continuidade às configurações de integração, na próxima tela exibida, você terá a opção de habilitar as Notificações do Jira. Essa funcionalidade permite que o Tiflux seja notificado sempre que uma issue no Jira for encerrada.
Nessas configurações, também é possível definir se as interações realizadas no Jira serão direcionadas como comunicação com o cliente ou como comunicação interna no Tiflux.
Para garantir o funcionamento correto das notificações, é necessário realizar a seguinte configuração no Jira:
No Jira, clique em Configurações > App:
Na sequência, clique em Gerenciar apps > Configurações:
Após clicar em configurações, habilite a opção ilustrada abaixo e clique sobre o botão "Apply":
Após ativar a opção mostrada acima, clique em "Carregar App". Na tela que será exibida, insira a seguinte URL: https://app.tiflux.com.br/integrations/atlassian_connect.json Em seguida, clique em "Upload" para concluir:
Aguarde a instalação do aplicativo responsável pelas notificações para concluir a sua instalação:
Ao prosseguir com a configuração da integração, a próxima tela exibida será a de automação de status de tickets. Essa funcionalidade permite que, sempre que uma issue for fechada no Jira, o status do ticket no Tiflux seja atualizado automaticamente.
Para adicionar a condição desejada da automação, clique sobre a opção "Adicionar mesa" e na sequência preencha os campos conforme a sua necessidade:
Não é possível selecionar o status padrão: Aberto, Fechado e Cancelado.
Finalizado essa etapa, clique em "Salvar".
Pronto!
Sua conta foi vinculada com o Jira e você já pode criar/associar issues a tickets.
