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
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
-
No menu lateral do Cloud Chat, vá em Configurações → Integrações
-
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.

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
-
Abra uma conversa no Cloud Chat
-
No cabeçalho da conversa, clique no ícone do Jira
-
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.

O issue é criado no Jira com um link para a conversa na descrição.
Vincular um issue já existente
-
No painel do Jira dentro da conversa, clique em Vincular issue existente
-
Busque pelo título ou chave do issue (ex:
PROJ-123) -
Clique no issue desejado para vinculá-lo
Um comentário é adicionado automaticamente no issue do Jira informando que foi vinculado à conversa.
Desvincular um issue
-
No painel do Jira dentro da conversa, localize o issue vinculado
-
Clique no ícone de lixeira ao lado do issue
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?
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