{
"eventType": "message.incoming",
"messageId": "wamid.HBgNNTU0Mzk2NjQ3NjM5...",
"chatId": "665f1c2b8a9d4e2fb1c39d8e",
"contactId": "664a0b1c2d3e4f5a6b7c8d9e",
"direction": "incoming",
"timestamp": "2026-07-14T12:34:56.789Z",
"engine": "whatsapp",
"origin": "contact",
"state": "received",
"content": {
"type": "text",
"text": "Olá, preciso de ajuda"
}
}Mensagem recebida
Disparado quando uma mensagem é recebida de um contato no canal. Enviado como POST para a URL configurada na aba Webhook do canal, com assinatura HMAC-SHA256 nos headers X-Webhook-Signature e X-Webhook-Timestamp.
{
"eventType": "message.incoming",
"messageId": "wamid.HBgNNTU0Mzk2NjQ3NjM5...",
"chatId": "665f1c2b8a9d4e2fb1c39d8e",
"contactId": "664a0b1c2d3e4f5a6b7c8d9e",
"direction": "incoming",
"timestamp": "2026-07-14T12:34:56.789Z",
"engine": "whatsapp",
"origin": "contact",
"state": "received",
"content": {
"type": "text",
"text": "Olá, preciso de ajuda"
}
}X-Webhook-Signature e X-Webhook-Timestamp — veja Configuração e assinatura.Authorizations
Chave de API do canal, gerada na aba API das configurações do canal (Dashboard → Suporte → Canais). A chave é exibida uma única vez ao ser gerada; gerar uma nova invalida a anterior.
Headers
sha256=<hex> — HMAC-SHA256 do texto "{timestamp}.{body}" calculado com o secret do canal.
Timestamp da assinatura em milissegundos (epoch). Usado na composição do texto assinado.
Body
message.incoming para o evento message_received; message.outgoing para message_sent.
message.incoming, message.outgoing Direção da mensagem.
incoming, outgoing Data/hora da mensagem em ISO 8601.
Conteúdo da mensagem. A estrutura varia conforme o tipo (texto, mídia, template etc.).
ID da mensagem (quando disponível, o ID do provider).
ID do chat no Zazz Chat.
ID do contato no Zazz Chat.
Provider/engine do canal (quando disponível).
"whatsapp"
Origem da mensagem (quando disponível).
Estado da mensagem no momento do evento (quando disponível).
Response
Responda com qualquer status 2xx para confirmar o recebimento. Timeout de 10s por tentativa; erros de rede, 5xx e 429 são retentados até 5 vezes com backoff exponencial.