Eventos dos Webhooks - Notifique

Na API você pergunta; no webhook a Notifique avisa. Ideal para sincronizar CRM, Inbox e métricas sem polling.

Em poucas palavras

Toda entrega é um POST application/json para a URL cadastrada.
Eventos chat.* são só chat in-app. WhatsApp usa message.*, push usa push.*.
instanceId vem vazio (chat não usa instância de canal).
Ative só os eventos que sua integração usa.
Responda 2xx rápido; processamento pesado vai para fila no seu lado.

Cadastre um webhook e ative os eventos chat.* que sua integração usa. O Chat sempre dispara se o webhook estiver inscrito nesse evento — não há interruptor extra de “mensagens recebidas” no canal. Configuração geral: Webhooks. Segurança (HMAC): Segurança de webhooks.

Como vem o POST

{
  "event": "chat.received",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-09-05T14:30:00.000Z",
  "data": {
    "chatAppId": "clxxapp...",
    "conversationId": "clxxconv...",
    "messageId": "clxxmsg...",
    "message": {
      "id": "clxxmsg...",
      "conversationId": "clxxconv...",
      "type": "TEXT",
      "body": "Oi",
      "createdAt": "2026-09-05T14:30:00.000Z"
    }
  }
}

Campo	Descrição
`event`	Nome do evento (ex.: `chat.received`)
`workspaceId`	ID do workspace
`instanceId`	Sempre vazio no chat
`timestamp`	ISO 8601, use para anti-replay
`data`	`chatAppId`, `conversationId`, payload da mensagem ou do membro

Headers: X-Notifique-Signature, X-Notifique-Timestamp, X-Workspace-Id, X-Webhook-Event.

O que seu servidor deve responder

Resposta	Efeito
2xx em até ~10s	Evento entregue; sai da fila
4xx / 5xx / timeout	Retentativa automática (5 min, 30 min, 2 h)

Processamento demorado? Responda 200 logo e processe em background.

Referência por evento

Evento	Quando dispara	O que fazer com isso
`chat.received`	Mensagem de um `USER`	Atender, Inbox, CRM
`chat.sent`	Mensagem de um `AGENT` (painel/API)	Confirmar eco no seu sistema
`chat.message.deleted`	Mensagem apagada	Remover do cache do cliente
`chat.conversation.created`	Nova conversa	Abrir ticket / thread
`chat.conversation.updated`	Título, políticas ou preview	Atualizar lista
`chat.conversation.deleted`	Soft delete	Fechar thread
`chat.member.added`	Membro entrou	ACL no seu lado
`chat.member.removed`	Membro saiu	Revogar acesso local
`chat.user.blocked`	Um `USER` bloqueou outro	Recusar DIRECT e membership
`chat.user.unblocked`	O bloqueio foi removido	Liberar DIRECT de novo

chat.received vs chat.sent segue o kind do remetente (USER → received, AGENT → sent). chat.conversation.updated também dispara quando o interruptor de capacidades da sala muda.

Próximos passos