Como integrar o Jira ao Cloud Chat
Quando usar
- Você quer criar issues no Jira direto de uma conversa no Cloud Chat, sem trocar de ferramenta
- Você quer vincular uma conversa a um issue já existente no Jira pra ter rastreabilidade
- Você precisa que o time de produto/engenharia receba contexto direto de tickets de suporte
Pré-requisitos
- Conta no Jira Cloud (Atlassian)
- Usuário no Jira com permissão para criar issues nos projetos desejados
- API Token do Jira — gerado em https://id.atlassian.com/manage-profile/security/api-tokens
- Estar logado como administrador no Cloud Chat para configurar a integração
:::warning A integração funciona exclusivamente com Jira Cloud. Jira Server e Jira Data Center não são suportados.
:::
Sobre este artigo
A integração com o Jira permite que agentes criem, vinculem e desvinculem issues do Jira diretamente de uma conversa no
Cloud Chat. Elimina a necessidade de alternar entre ferramentas e garante rastreabilidade entre atendimentos e tickets
de produto/engenharia.
Configurar a integração
Etapa 1 — Acessar Integrações
1. No menu lateral do Cloud Chat, vá em Configurações → Integrações
2. Clique em Jira e depois em Conectar
Etapa 2 — Preencher os dados de conexão
Preencha os campos:
- URL do site Jira — ex: https://suaempresa.atlassian.net
- E-mail — do usuário Jira que será usado nas chamadas à API
- API Token — gerado conforme pré-requisitos
Clique em Salvar.
:::success A integração fica disponível para todos os agentes da conta.
:::
Criar um issue a partir de uma conversa
Etapa 1 — Abrir o painel do Jira
1. Abra uma conversa no Cloud Chat
2. No cabeçalho da conversa, clique no ícone do Jira
3. Clique em Criar issue
Etapa 2 — Preencher campos obrigatórios
Campos marcados com *:
- Título — resumo do issue
- Projeto — projeto do Jira onde o issue será criado
- Tipo de issue — aparece após selecionar o projeto (Bug, Task, Story)
Etapa 3 — Preencher campos opcionais
- Descrição — detalhes adicionais
- Prioridade — nível de urgência
- Responsável — a quem o issue será atribuído
Etapa 4 — Criar
Clique em Criar.
:::success O issue é criado no Jira com um link para a conversa na descrição.
:::
Vincular um issue já existente
1. No painel do Jira dentro da conversa, clique em Vincular issue existente
2. Busque pelo título ou chave do issue (ex: PROJ-123)
3. Clique no issue desejado para vinculá-lo
:::info Um comentário é adicionado automaticamente no issue do Jira informando que foi vinculado à conversa.
:::
Desvincular um issue
1. No painel do Jira dentro da conversa, localize o issue vinculado
2. Clique no ícone de lixeira ao lado do issue
:::info Um comentário é adicionado no Jira informando que o vínculo com a conversa foi removido.
:::
Perguntas frequentes
Um issue pode estar vinculado a mais de uma conversa?
Sim. O mesmo issue do Jira pode ser vinculado a múltiplas conversas. Cada vínculo gera um comentário no Jira com o link
da conversa correspondente.
Quais informações aparecem no card do issue?
O card exibe:
- Chave do issue (ex: PROJ-123)
- Título
- Status atual no Jira (To Do, In Progress, Done, etc.)
As informações são atualizadas automaticamente toda vez que você abre o painel.
Em qual idioma os comentários são adicionados no Jira?
Os comentários são adicionados no idioma configurado na conta do Cloud Chat.
Quais versões do Jira são compatíveis?
:::warning Apenas Jira Cloud. Jira Server e Jira Data Center não são suportados.
:::
Observações
- Para outros tipos de integração via API (consulta, criação de tickets, etc.): Guia Mestre — Como acessar e operar
dados do Cloud Chat via API
- Para integrar com HubSpot (workflows e contatos): Como importar contatos via HubSpot e Como enviar mensagem proativa
pelo WhatsApp via HubSpot
- Para configurar atributos customizados no contexto da conversa (que podem ser usados em integrações): Como criar
campos customizados de contatos e conversas
