# 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
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guia-de-uso.tiflux.com/integracoes/projetos/integracao-jira.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.