Integração Jira no CloudChat
O que é a integração com Jira?
A integração com o Jira permite que agentes criem, vinculem e desvinculem issues do Jira diretamente de dentro de uma
conversa no CloudChat. Isso elimina a necessidade de alternar entre ferramentas e garante rastreabilidade entre
atendimentos e tickets de produto/engenharia.
Pré-requisitos
- Conta no Jira Cloud (Atlassian)
- Um usuário no Jira com permissão para criar issues nos projetos desejados
- Um API Token do Jira (gerado em https://id.atlassian.net/manage-profile/security/api-tokens)
Como configurar a integração?
1. Acesse Configurações > Integrações no menu lateral do CloudChat.
2. Clique em Jira e depois em Conectar.
3. Preencha os campos:
- URL do site Jira — ex: https://suaempresa.atlassian.net
- E-mail — o e-mail do usuário Jira que será usado para as chamadas à API
- API Token — o token gerado no passo anterior
4. Clique em Salvar.
A integração ficará disponível para todos os agentes da conta.
Como criar um issue no Jira a partir de uma conversa?
1. Abra uma conversa no CloudChat.
2. No cabeçalho da conversa, clique no ícone do Jira.
3. Clique em Criar issue.
4. Preencha os campos obrigatórios (marcados com *):
- Título — resumo do issue
- Projeto — o projeto do Jira onde o issue será criado
- Tipo de issue — só aparece após selecionar o projeto (ex: Bug, Task, Story)
5. Opcionalmente, preencha:
- Descrição — detalhes adicionais
- Prioridade — nível de urgência
- Responsável — a quem o issue será atribuído
6. Clique em Criar.
O issue será criado no Jira com um link para a conversa na descrição.
Como 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.
Um comentário será adicionado automaticamente no issue do Jira informando que ele foi vinculado à conversa.
Como 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.
Um comentário será adicionado no Jira informando que o vínculo com a conversa foi removido.
Um issue pode estar vinculado a mais de uma conversa?
Sim. O mesmo issue do Jira pode ser vinculado a múltiplas conversas no CloudChat. 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 (ex: To Do, In Progress, Done)
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 CloudChat.
Quais versões do Jira são compatíveis?
A integração funciona exclusivamente com o Jira Cloud. Jira Server e Jira Data Center não são suportados.
