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?
-
Acesse Configurações > Integrações no menu lateral do CloudChat.
-
Clique em Jira e depois em Conectar.
-
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
-
-
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?
-
Abra uma conversa no CloudChat.
-
No cabeçalho da conversa, clique no ícone do Jira.
-
Clique em Criar issue.
-
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)
-
-
Opcionalmente, preencha:
-
Descrição — detalhes adicionais
-
Prioridade — nível de urgência
-
Responsável — a quem o issue será atribuído
-
-
Clique em Criar.
O issue será criado no Jira com um link para a conversa na descrição.
Como 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 será adicionado automaticamente no issue do Jira informando que ele foi vinculado à conversa.
Como 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 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.