# 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FbZQvYyFgTZ3kKtrqSU2X%2Fimage.png?alt=media&#x26;token=cffc839c-1aab-4a5b-ae01-d0db79827345" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FXs8RPdoNx2SSfJXUhXir%2Fimage.png?alt=media&#x26;token=0393faac-b0b8-4a96-a689-0e4b6b17a277" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F2ZbCWERM4yxmAgvP48Nr%2Fimage.png?alt=media&#x26;token=18234a86-051d-43b3-a7a1-6e81e696711a" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FRtRjfs3c6kiYPeHUun48%2Fimage.png?alt=media&#x26;token=27438d5b-a7a3-4cef-984d-38bfeadf15df" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FDvHbhgYjccxGM77u3OTz%2Fimage.png?alt=media&#x26;token=63125150-f484-45b7-b161-1f5001b10d4f" alt=""><figcaption></figcaption></figure>

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

   <figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FFfXHqVsvptNLThkfm9jL%2Fimage.png?alt=media&#x26;token=da98ab54-476d-4460-8d71-2eb6bceb315a" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F3EZkVkh94KsC1MuYq2Uu%2Fimage.png?alt=media&#x26;token=820d429b-5104-4432-bb09-a3c9c05eb610" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FSTObIdZ37Ffnq7fKnDFF%2Fimage.png?alt=media&#x26;token=6c72eb97-775e-4295-88a1-0681fff55fba" 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 (Imagem 2)
   * **URL**: da instância Jira (Imagem 3)
5. Clique em **Próximo**.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FBxi6HuJYwulaTcLLlx0f%2Fimage.png?alt=media&#x26;token=64e2eb70-8e47-44ac-bc6c-582552d46dff" alt=""><figcaption><p>Etapas 3 e 4</p></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FE8L9jCd0bbd7fLaNqBqm%2Fimage.png?alt=media&#x26;token=8ce1e438-0ae5-422e-8894-9f1e438ff9dc" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FkHFqF6B4q15a8ICQKCCm%2Fimage.png?alt=media&#x26;token=15ab7b5a-cfc0-423b-ad65-828cc7f35bb2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FK96jr4IOQlpEkob1gShC%2Fimage.png?alt=media&#x26;token=7dc676b2-f022-4856-b0e2-d96ce811cfdc" alt=""><figcaption><p>Email a ser utilizado na configuração</p></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F8cStWB8CpxUk8kLD1YDq%2Fimage.png?alt=media&#x26;token=e1ee8598-be97-400f-96b4-522ec69e53d7" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Fj80RTbUsbe4i8sBHB2JN%2Fimage.png?alt=media&#x26;token=47beb190-ad96-4de9-8d91-64b23fc87c55" 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
```