Webhook do Chat Interno

Quer levar para outro sistema o que a equipe combina no Chat Interno — um recado, uma chamada que terminou, a transcrição de uma reunião gravada? O Webhook do Chat Interno avisa o seu sistema na hora, a cada mensagem, reação, conversa ou chamada da equipe.

O Webhook do Chat Interno cobre só as conversas internas da equipe. As conversas com os clientes são avisadas pelos webhooks da Conexão e do Setor.

Onde ligar

Webhook do chat interno: o ícone fica no topo da tela do Chat Interno e aparece só para o administrador. A URL do webhook recebe os eventos de todas as conversas do Chat Interno da empresa. Com o campo em branco, nada é enviado. Ao salvar, a tela avisa "Webhook do chat interno salvo".

Webhook desta conversa (opcional): na janela de editar uma conversa do Chat Interno, recebe os eventos só daquela conversa.

Pela documentação da API da plataforma, a mesma URL no webhook geral e no de uma conversa recebe cada aviso uma vez só.

O endereço precisa aceitar POST com corpo em JSON.

O campo que separa um aviso do outro

Tudo chega no mesmo endereço, e é o acao que diz o que aconteceu no Chat Interno:

Todo aviso do Webhook do Chat Interno traz também:

companyId — a empresa.

chat — o resumo da conversa: id, uuid, title, somenteAvisos (se é um grupo de avisos), ownerId (quem criou) e participantes, com o id e o nome de cada um.

origem — de onde veio o evento: painel (alguém na tela), sistema (a própria plataforma, como nas chamadas e gravações) ou api. Use o origem para o seu sistema não responder ao eco do que ele mesmo mandou pela API.

enviadoEm — a hora em que o aviso foi enviado.

backendURL — o endereço do backend da sua instalação.

Exemplo de payload de Mensagem

{
  "acao": "mensagem-criada",
  "companyId": 8,
  "chat": {
    "id": 9,
    "uuid": "3f2a9c1e-5b7d-4e8a-9c0f-1a2b3c4d5e6f",
    "title": "Time de Vendas",
    "somenteAvisos": false,
    "imagem": null,
    "ownerId": 16,
    "participantes": [
      { "id": 16, "nome": "Ana Supervisora" },
      { "id": 18, "nome": "Bruno Vendas" }
    ]
  },
  "mensagem": {
    "id": 407,
    "chatId": 9,
    "remetente": { "id": 16, "nome": "Ana Supervisora" },
    "message": "Reunião às 15h para fechar a proposta",
    "mediaName": null,
    "mediaUrl": null,
    "quotedMsgId": null,
    "apagada": false,
    "createdAt": "2026-10-27T09:17:53.895Z",
    "mencionados": []
  },
  "origem": "painel",
  "enviadoEm": "2026-10-27T09:17:53.957Z",
  "backendURL": "https://backend_url.com.br"
}

mensagem.remetente — quem escreveu, com id e nome.

mensagem.message — o texto. Numa mensagem com arquivo, mediaName e mediaUrl trazem o nome e o endereço do arquivo.

mensagem.quotedMsgId — a mensagem respondida, quando é uma resposta.

mensagem.mencionados — os ids de quem foi marcado com @.

No mensagem-apagada, mensagem traz só id e chatId, e por diz quem apagou. No reacao, vêm por, o emoji e reacoes, a lista inteira de reações da mensagem: reagir de novo com o mesmo emoji tira a reação.

Exemplo de payload de Chamada

O aviso do fim da chamada traz a duração e quem participou.

{
  "acao": "chamada-encerrada",
  "companyId": 8,
  "chat": {
    "id": 9,
    "uuid": "3f2a9c1e-5b7d-4e8a-9c0f-1a2b3c4d5e6f",
    "title": "Time de Vendas",
    "somenteAvisos": false,
    "imagem": null,
    "ownerId": 16,
    "participantes": [
      { "id": 16, "nome": "Ana Supervisora" },
      { "id": 18, "nome": "Bruno Vendas" }
    ]
  },
  "chamada": {
    "id": 9,
    "tipo": "chat",
    "ticketId": null,
    "iniciadaPorId": 16,
    "iniciadaEm": "2026-10-27T09:18:17.708Z",
    "encerradaEm": "2026-10-27T09:18:37.872Z",
    "duracaoSegundos": 20
  },
  "participantes": [
    { "nome": "Ana Supervisora", "userId": 16, "cliente": false, "entrouEm": "2026-10-27T09:18:17.718Z", "saiuEm": "2026-10-27T09:18:35.314Z" },
    { "nome": "Bruno Vendas", "userId": 18, "cliente": false, "entrouEm": "2026-10-27T09:18:23.945Z", "saiuEm": "2026-10-27T09:18:37.861Z" }
  ],
  "origem": "sistema",
  "enviadoEm": "2026-10-27T09:18:37.893Z",
  "backendURL": "https://backend_url.com.br"
}

chamada.tipo — chat numa chamada do Chat Interno.

chamada.iniciadaPorId — quem começou a chamada.

chamada.duracaoSegundos e chamada.encerradaEm — preenchidos no chamada-encerrada; no chamada-iniciada vêm vazios, e o aviso traz por, com quem começou.

participantes — só no chamada-encerrada: cada pessoa que entrou na chamada, com a hora em que entrou e saiu.

gravacao — nos avisos de gravação. No gravacao-iniciada, gravacao.automatica é false quando alguém tocou em Gravar a chamada. No gravacao-concluida, gravacao.url é o endereço do vídeo, gravacao.duracaoSegundos a duração e gravacao.messageId a mensagem do vídeo na conversa.

transcricao e analise — só no gravacao-transcrita: o texto inteiro da transcrição e da análise.

Como saber que o aviso veio daqui

Pela documentação da API da plataforma, todo aviso do Webhook do Chat Interno traz o cabeçalho X-Chat-Interno-Evento, que repete o evento. Com o Token da Empresa gerado, traz também o cabeçalho X-Assinatura-Chat-Interno: sha256= seguido do HMAC-SHA256 do corpo, calculado com o Token da Empresa como chave.

Para conferir, calcule o HMAC-SHA256 do corpo recebido com o seu Token da Empresa e compare com o valor do cabeçalho. O token não vai no corpo do aviso.

O aviso não é repetido. Se o endereço não responder em 15 segundos, aquele aviso se perde. Responda rápido e deixe o processamento pesado para depois.