> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/integracoes/projetos/integracao-jira.md).

# Integração Jira

## 🔗 Integração com Jira

### 🎯 Introdução

Esta documentação detalha o processo de **integração do Tiflux com o Jira**, desde a geração de um token de API até a automação do status dos tickets. Siga os passos para garantir a comunicação correta entre as duas plataformas.

***

### 📚 Sumário

* ⚙️ Gerando o API Token no Jira
* 📢 Configuração de Notificações do Jira
* 🚀 Realizando a integração com o Tiflux
* ⚖️ Automatizando o status dos tickets
* ❓ Perguntas Frequentes (FAQ)
* 🔍 Palavras-chave para IA, indexação e busca

***

### ⚙️ Gerando o API Token no Jira

1. Acesse: <https://id.atlassian.com/manage-profile/security/api-tokens>
2. Clique em **Criar um token de API**.
3. Preencha com uma descrição clara e defina uma data de expiração (tokens são válidos por 1 ano).
4. Clique em **Criar**<br>

   <figure><img src="/files/j1ileWEy3olG9IXUkX7A" alt=""><figcaption><p>Tela para geração de Token do Jira com data de expiração<br></p></figcaption></figure>
5. Na próxima tela clique em **Copiar.**&#x20;

> ⚠️ **Importante:** Não é possível visualizar o token novamente após fechar o diálogo. Copie guarde-o em local seguro, para utilização nos próximos passos.

<div data-full-width="false"><figure><img src="/files/GdjDOG13y3EtaHImq8Sy" alt=""><figcaption><p>Copiando Token gerado no Jira para integrar ao Tiflux</p></figcaption></figure></div>

***

### 📢 Configuração de Notificações do Jira

1. **Acesse o menu de administração do Jira**\
   Clique no **ícone de engrenagem (⚙️)** no canto superior direito e selecione:\
   **Aplicativos de marketplace → Gerenciar aplicativos**<br>

   <figure><img src="/files/jYs2uvJtzRxmfIiUBzMV" alt=""><figcaption></figcaption></figure>

2. **Avance para o gerenciamento de aplicativos conectados**\
   Na tela seguinte, clique em **“Ir para lá”** para ser redirecionado à administração dos apps.<br>

   <figure><img src="/files/Esh0FIlnUQnL1m2CSCu2" alt=""><figcaption></figcaption></figure>

3. **Ative o modo de desenvolvedor (se necessário)**\
   Vá em **Configurações → Modo de desenvolvedor** e clique em **Ativar o modo de desenvolvimento**, permitindo a instalação de apps não listados no Atlassian Marketplace.<br>

   <figure><img src="/files/b0i3rqoz4ueg9OyysXuw" alt=""><figcaption></figcaption></figure>

4. **Instale o aplicativo privado**\
   Acesse a aba **Aplicativos instalados** e clique em **“Instalar um aplicativo privado”**.

   <figure><img src="/files/Pg3Ct0oNlhEoTmtbFzCX" alt=""><figcaption></figcaption></figure>

5. **Informe a URL do aplicativo Tiflux**\
   No campo **URL do descritor do app**, cole o seguinte link:

   ```
   https://app.tiflux.com.br/integrations/atlassian_connect.json
   ```

   Clique em **Instalar aplicativo** para concluir a instalação.\ <br>

   <figure><img src="/files/D5kpPGW0mZhfDLo5HV4l" alt=""><figcaption></figcaption></figure>

6. **Confirme a instalação**\
   Aguarde até que a mensagem **“Instalação bem-sucedida”** seja exibida.\
   Isso confirma que o aplicativo Tiflux foi instalado corretamente em sua instância Jira.\ <br>

   <figure><img src="/files/vHMCIyoRqPiAGAQEazjL" alt=""><figcaption></figcaption></figure>

***

### 🚀 Realizando a integração com o Tiflux

1. Acesse: `Configurações > Integrações > Projeto > Jira`
2. Clique em **Jira Software** em "Integrações a realizar".
3. Na tela seguinte, selecione a opção **Cloud**.
4. Preencha os campos:
   * **API KEY**: o [token ](#gerando-o-api-token-no-jira)gerado anteriormente
   * **E-mail**: da conta Jira que foi criado o Token (Imagem 2)
   * **URL**: da instância Jira (Imagem 3)
5. Clique em **Próximo**.

<figure><img src="/files/A5BqjgXUtPDYCF5SosQp" alt=""><figcaption><p>Etapas 3 e 4</p></figcaption></figure>

<figure><img src="/files/xgfkf1BJwKgNbVKgoTDj" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/cx1LUCO10pIMPo4K4Nqb" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/yaAKUT0XL4TNAJTEZGk4" alt=""><figcaption><p>Email a ser utilizado na configuração</p></figcaption></figure>

<figure><img src="/files/bpgq1OqDN5J72FYg2iBz" alt=""><figcaption><p><strong>URL</strong>: da instância Jira a ser utilizado</p></figcaption></figure>

***

### ⚖️ Automatizando o status dos tickets

1. Ao prosseguir na integração, acesse a etapa de **automação de status**.
2. Clique em **Adicionar mesa**
3. Preencha os campos conforme o fluxo desejado

> ❌ Não é possível selecionar os status padrões: **Aberto**, **Fechado** e **Cancelado**.

4. Clique em **Salvar**.

Pronto! A sua conta está integrada e você pode criar e associar issues a tickets diretamente do Tiflux.

<figure><img src="/files/A8gt6O5kFrIUDAClVc2F" alt=""><figcaption></figcaption></figure>

***

### ❓ Perguntas Frequentes (FAQ)

**🔑 O token expira?**\
Sim. Os tokens têm validade de 1 ano. Gere um novo token e atualize a integração.

**📅 Posso atualizar apenas o token sem refazer a integração?**\
Sim. Basta acessar as configurações da integração e atualizar o token.

**⚠️ O que acontece se eu excluir a integração?**\
As issues vinculadas aos tickets serão permanentemente perdidas.

**🚀 A automação de status é obrigatória?**\
Não é obrigatória, mas altamente recomendada para manter a sincronia entre Jira e Tiflux.

**🔹 Excluir uma issue no Tiflux exclui a isso do Jira?**\
Não, excluir no Tiflux não remove do Jira, precisa ser excluido manualmente no Jira

***

### 🔍 Palavras-chave para IA, indexação e busca

```
integração Tiflux Jira,
API Token Atlassian,
configurar Jira Tiflux,
automação Jira Tiflux,
notificacões Jira Tiflux,
vincular tickets Jira,
Atlassian Connect Tiflux,
sincronizar status Jira Tiflux
```