ConfigurarIntegrações

Jira

Conecte seus agentes da ElevenLabs ao Jira Cloud

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

RecursoSuporte
Modo de retenção zero (ZRM)Não compatível
Anexos em ferramentasNã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.

1

Gerar um token de API

Acesse o gerenciamento de tokens de API da Atlassian e clique em Create API token. Copie o token — você não poderá vê-lo novamente.

2

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.

3

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

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 que recebe o identificador de quem ligou do seu aplicativo. Assim, o agente não precisa pedir o e-mail em todas as chamadas.

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

1

Identificação de quem liga

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

2

Coletar detalhes

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

3

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.

4

Confirmar com quem ligou

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

Exemplo de prompt de sistema

# 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

FerramentaDescrição
jira_create_issueCria uma issue com projeto, resumo, tipo de issue e campos opcionais, como prioridade.
jira_get_issueRecupera detalhes de uma issue específica pela chave.
jira_search_issuesPesquisa issues por label, projeto, status, prioridade, tipo, responsável, texto ou intervalo de datas.
jira_update_issueAtualiza campos de uma issue existente — prioridade, responsável, labels ou descrição.
jira_add_commentAdiciona um comentário em texto simples a uma issue.
jira_get_transitionsLista as transições de workflow disponíveis para uma issue.
jira_transition_issueMove uma issue para um novo status de workflow usando um ID de transição de jira_get_transitions.
jira_link_issuesVincula duas issues (por exemplo, “Blocks”, “Duplicate”, “Relates”).
jira_list_projectsLista os projetos disponíveis e suas chaves.
jira_get_issue_typesLista os tipos de issue disponíveis (por exemplo, Bug, Task, Story).
jira_get_prioritiesLista os níveis de prioridade disponíveis.

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.