Evento
POST messenger/chatbot/NodeHttpWebhookComo receber
Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload.
Payload
- Content-Type: application/json
| Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição |
|---|---|---|---|---|
| roomId | string | Sim | ID da sala (room) no banco | |
| chId | string | Sim | Identificador do canal. No WhatsApp (chSrc=1) é o número do cliente. | |
| chSrc | integer | Sim | Canal de origem (1=WhatsApp, 2=Facebook, 3=Instagram, 4=SMS) | |
| message | string,null | Não | Texto da mensagem atual (quando houver) | |
| interactiveReply | string,null | Não | Resposta interativa do usuário (payload/id) quando aplicável | |
| currNodeId | string | Sim | ID do node atual no fluxo | |
| vars | object | Sim | Variáveis persistidas no contexto do fluxo (roomData.vars) | |
| media | NodeHttpWebhookMedia | null | Não | Mídia/arquivo quando a mensagem contém anexo | |
| _waReferral | NodeHttpWebhookReferral | null | Não | Referral do WhatsApp quando o webhook de mensagem veio com message.referral |
Estruturas internas
media
{
"url": "string (uri)",
"mimeType": "string"
}_waReferral
{
"body": "string",
"ctwa_clid": "string",
"headline": "string",
"image": {
"id": "string"
},
"source_id": "string",
"source_type": "string",
"source_url": "string"
}Exemplo básico recebido:
{
"roomId": "valor",
"chId": "valor",
"chSrc": 1,
"currNodeId": "valor",
"vars": {}
}Respostas
| Status | Descrição | Conteúdo |
|---|---|---|
| 200 | Qualquer resposta 2xx é considerada sucesso | |
| 500 | Erro no processamento do receiver |
Boas práticas
- Trate reenvios como possibilidade real.
- Valide o payload antes de executar regras de negócio.
- Registre o identificador do evento ou do registro recebido para auditoria.