O Cloud Chat permite enviar eventos para sistemas externos através da funcionalidade “Enviar Evento Webhook” nas automações.

Com essa funcionalidade, é possível integrar o Cloud Chat com praticamente qualquer sistema — incluindo o Jira — utilizando um intermediador de automações, como:

• n8n

• Zapier

• Make

• Plugga

O fluxo da integração costuma seguir esta lógica:

1. Uma automação no Cloud Chat dispara um webhook.

2. A ferramenta intermediária (ex.: n8n) recebe o evento.

3. Os dados são processados ou adaptados conforme necessário.

4. Um ticket (issue) é criado automaticamente no Jira.

Geralmente, essa integração é acionada a partir de atualizações no ticket, como:

• adição de tag

• alteração de atributo personalizado da conversa

• mudança de prioridade

• mudança de time responsável

Quando uma dessas condições ocorre, o webhook é disparado e inicia o fluxo de criação do ticket no Jira.

Esse tipo de integração é bastante utilizado para encaminhar atendimentos do suporte para outros times, principalmente em casos como:

• bugs reportados por clientes

• incidentes técnicos

• problemas que exigem análise de engenharia

• escalonamento para times técnicos.

Fluxo da integração:

Ticket atualizado no CloudChat
(tag ou atributo personalizado)
        ↓
Automação dispara Webhook
        ↓
n8n recebe o evento
        ↓
n8n transforma os dados
        ↓
n8n cria Issue no Jira

⚠️ Integrações bidirecionais (duas vias) — onde o Jira também atualiza o CloudChat — são mais complexas e normalmente exigem uso combinado de Webhook + APIs do CloudChat + APIs do Jira.

Passo 1 — Criar a automação no CloudChat

O primeiro passo é criar uma automação baseada em atualização de ticket.

Essa automação será responsável por disparar o webhook.

Exemplos de gatilhos

Você pode usar diferentes condições, como:

Tag adicionada ao ticket

Exemplo:

tag adicionada = bug

Atributo personalizado atualizado

Exemplo:

conversation_custom_field = engineering_escalation
valor = true

Mudança de prioridade

priority = high

Exemplo de automação

Evento

Ticket atualizado

Condição

Tag adicionada = bug

ou

Campo personalizado engineering_escalation = true

Ação

Enviar Evento Webhook

Passo 2 — Criar o Webhook no n8n

No n8n, crie um fluxo com um Webhook Node.

Configuração

Node: Webhook
Método: POST

Path

cloudchat-jira

O n8n irá gerar uma URL como:

https://n8n.seudominio.com/webhook/cloudchat-jira

Essa URL deve ser configurada na automação do CloudChat.

Passo 3 — Entender o payload enviado pelo CloudChat

Quando a automação dispara, o CloudChat envia um POST com JSON contendo informações do evento.

Exemplo de payload

{
  "event": "conversation_updated",
  "message_type": "incoming",
  "content": "Cliente reportou erro ao gerar boleto",
  "conversation": {
    "id": 678,
    "status": "open"
  },
  "sender": {
    "id": 90,
    "name": "João Silva",
    "email": "[email protected]",
    "phone_number": "+5511999999999"
  },
  "inbox": {
    "id": 10,
    "name": "WhatsApp"
  }
}

Campos mais utilizados na integração:

CampoUsoconversation.idID do ticketcontentmensagem mais recentesender.namenome do clientesender.emailemail do clientesender.phone_numbertelefoneinbox.namecanal

Passo 4 — Enriquecer dados (opcional)

Dependendo da integração, pode ser necessário coletar mais informações antes de criar o ticket no Jira.

Nesse caso, o n8n pode usar as APIs de Consulta em Tempo Real do CloudChat.

Exemplo de usos comuns:

• buscar histórico da conversa

• buscar dados do contato

• buscar outras mensagens do ticket

Exemplo de endpoint:

GET /api/client/accounts/{ACCOUNT_ID}/conversations/{CONVERSATION_ID}/messages

Esse passo é útil quando o time técnico precisa de mais contexto da conversa.

Passo 5 — Criar o ticket no Jira no n8n

Após receber o webhook e preparar os dados, o fluxo do n8n pode criar uma Issue no Jira.

Configuração típica

Operation

Create Issue

Campos principais

Campo JiraOrigemProjectprojeto de engenhariaIssue TypeBugSummarybug reportado via CloudChatDescriptionmensagem do clienteReporteremail do cliente

Exemplo de descrição enviada ao Jira

Bug reportado via CloudChat

Cliente:
{{sender.name}}

Email:
{{sender.email}}

Telefone:
{{sender.phone_number}}

Mensagem:
{{content}}

Link do ticket:
https://cloudchat.cloudhumans.com/app/accounts/{ACCOUNT_ID}/conversations/{{conversation.id}}

Isso permite que o time técnico acesse rapidamente o ticket original no CloudChat.

Passo 6 — Testar a integração

Fluxo recomendado de teste:

1. Criar a automação no CloudChat

2. Criar o webhook no n8n

3. Atualizar o ticket manualmente (ex: adicionar tag bug)

4. Verificar se o webhook foi disparado

5. Confirmar execução do fluxo no n8n

6. Validar se o ticket foi criado no Jira

Boas práticas

Use gatilhos claros

Evite criar tickets no Jira para qualquer atualização de ticket.

Prefira usar:

• tags específicas (bug, engineering)

• campos personalizados (escalate_to_tech)

• prioridade alta

Sempre enviar o link do ticket

Inclua no Jira o link direto da conversa no CloudChat.

Exemplo:

https://cloudchat.cloudhumans.com/app/accounts/{ACCOUNT_ID}/conversations/{CONVERSATION_ID}

Isso facilita a investigação do problema.

Evite duplicações

Se o ticket for atualizado várias vezes, a automação pode disparar múltiplos webhooks.

Para evitar isso, você pode:

• usar uma tag específica de escalonamento

• validar no n8n se já existe issue criada para aquele ticket

Limitações da integração

Esse tipo de integração possui algumas limitações:

Integração normalmente é de via única

CloudChat → Jira

O Jira não atualiza automaticamente o ticket no CloudChat.

Para uma integração bidirecional seria necessário utilizar:

• Webhooks do Jira

• APIs de Atualização do CloudChat

• lógica adicional no n8n