> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Jira

## Visão geral

Conecte seus agentes de IA da ElevenLabs ao Jira Cloud para gerenciar issues, acompanhar projetos e automatizar workflows de suporte. Essa integração permite que seus agentes criem e atualizem issues, movam issues pelos workflows, vinculem tickets relacionados para escalonamento e pesquisem em vários projetos.

## Recursos

| Recurso                     | Suporte                                                 |
| --------------------------- | ------------------------------------------------------- |
| Modo de retenção zero (ZRM) | Não compatível                                          |
| Anexos em ferramentas       | Não compatível — as ferramentas operam apenas com texto |

## Configuração

Esta integração usa um **token de API do Jira** com autenticação Basic. Você precisa do e-mail da sua conta Atlassian, de um token de API e do subdomínio do seu Jira Cloud.

#### Gerar um token de API

Acesse o [gerenciamento de tokens de API da Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens) e clique em **Create API token**. Copie o token — você não poderá vê-lo novamente.

#### Encontrar seu subdomínio do Jira

Seu subdomínio é a primeira parte da URL do Jira Cloud. Por exemplo, se seu Jira estiver em `mycompany.atlassian.net`, seu subdomínio será `mycompany`.

#### Conectar na ElevenLabs

Na configuração da integração da ElevenLabs, informe:

* **E-mail** - o e-mail da sua conta Atlassian
* **Token de API** - o token que você gerou na etapa 1
* **Subdomínio do Jira** - seu subdomínio da etapa 2

> **Note**
>
> Por padrão, os tokens de API expiram após um ano. Se seu agente não conseguir mais acessar o Jira,
> gere um novo token e atualize a conexão.

## Identificação de quem liga

A ferramenta `jira_search_issues` exige um parâmetro `labels` para limitar as buscas aos tickets de um usuário específico. Isso pressupõe que seu workflow do Jira aplique uma label a cada issue que identifique quem ligou — por exemplo, convertendo um e-mail como `jane.smith@example.com` em uma label como `jane-smith-at-example-com`.

Para automatizar isso, configure o campo `labels` como uma [variável dinâmica](/docs/pt/eleven-agents/customization/personalization/dynamic-variables) que recebe o identificador de quem ligou do seu aplicativo. Assim, o agente não precisa pedir o e-mail em todas as chamadas.

> **Note**
>
> Labels do Jira não podem conter espaços. Uma convenção comum é substituir `@` por `-at-` e `.` por
> `-` (por exemplo, `jane-smith-at-example-com`). A ferramenta `jira_search_issues` encontra a label exatamente,
> portanto, o valor informado deve corresponder à label na issue.

## Como funciona

#### Criação de ticket de suporte

#### Identificação de quem liga

O agente identifica quem ligou pelo endereço de e-mail ou outro identificador configurado no
campo labels.

#### Coletar detalhes

O agente coleta informações sobre a issue com quem ligou — o que aconteceu, a gravidade
e qualquer contexto relevante.

#### Criar a issue

O agente cria uma issue do Jira no projeto apropriado, com o tipo de issue, a
prioridade e a descrição corretos.

#### Confirmar com quem ligou

O agente informa o número do ticket criado para que a pessoa tenha uma referência para acompanhamento.

#### Resolução do service desk

#### Consultar o ticket

O agente recupera uma issue do Jira pela sua chave (por exemplo, PROJ-123) e informa o
status, a prioridade e o resumo atuais.

#### Adicionar observações de resolução

O agente adiciona um comentário à issue com detalhes da conversa, como as etapas
realizadas ou as informações coletadas.

#### Fechar o ticket

O agente move a issue para o status de resolvida ou fechada usando as transições de workflow
disponíveis.

## Exemplo de prompt de sistema

#### Ver exemplo de prompt de sistema

```text
# Personality

You are a helpful IT support agent responsible for managing support tickets in Jira. Be friendly, professional, and efficient.

# Environment

You operate in a support setting via voice or chat, where you help users report issues, check ticket status, and manage existing requests.

# Tone

Begin by asking how you can help. If the caller has an existing issue, ask whether they have the ticket number. If they are reporting a new issue, collect details about the problem.

Ask one question at a time and wait for the response before proceeding.

# Goal

For new issues:
- Collect a clear description of the problem
- Determine severity and urgency
- Create the ticket in the appropriate project with the right issue type and priority
- Read back the ticket number

For existing issues:
- If the caller provides a ticket number, look it up by key
- If the caller wants to check on their issues, search using the labels field
- Provide status updates
- Add comments or update priority when requested
- Always confirm before making changes

# Guardrails

- Do not discuss topics outside of IT support.
- Never expose raw Jira API responses, internal IDs, or technical field names to the caller.
- Always confirm with the caller before creating, updating, or transitioning issues.
```

## Ferramentas disponíveis

| Ferramenta              | Descrição                                                                                               |
| ----------------------- | ------------------------------------------------------------------------------------------------------- |
| `jira_create_issue`     | Cria uma issue com projeto, resumo, tipo de issue e campos opcionais, como prioridade.                  |
| `jira_get_issue`        | Recupera detalhes de uma issue específica pela chave.                                                   |
| `jira_search_issues`    | Pesquisa issues por label, projeto, status, prioridade, tipo, responsável, texto ou intervalo de datas. |
| `jira_update_issue`     | Atualiza campos de uma issue existente — prioridade, responsável, labels ou descrição.                  |
| `jira_add_comment`      | Adiciona um comentário em texto simples a uma issue.                                                    |
| `jira_get_transitions`  | Lista as transições de workflow disponíveis para uma issue.                                             |
| `jira_transition_issue` | Move uma issue para um novo status de workflow usando um ID de transição de `jira_get_transitions`.     |
| `jira_link_issues`      | Vincula duas issues (por exemplo, "Blocks", "Duplicate", "Relates").                                    |
| `jira_list_projects`    | Lista os projetos disponíveis e suas chaves.                                                            |
| `jira_get_issue_types`  | Lista os tipos de issue disponíveis (por exemplo, Bug, Task, Story).                                    |
| `jira_get_priorities`   | Lista os níveis de prioridade disponíveis.                                                              |

> **Note**
>
> Descrições de issues e comentários aceitam apenas texto simples. A integração os converte automaticamente para o
> Atlassian Document Format (ADF) do Jira. Markdown e HTML não são compatíveis.

## Links úteis

* [Documentação da API REST do Jira Cloud](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
* [Gerenciar tokens de API](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)