{
"id": "01a0d4a1-3b4c-7d5e-8f60-7a8b9c0d1e2f",
"event": "message.received",
"createdAt": "2026-09-24T17:31:08.412Z",
"data": {
"id": "01a0d4a1-3a10-7b21-9c32-4d5e6f7a8b9c",
"wamid": "wamid.HBgNNTQ5MTE1NTU1MDEwMRUCABIYFjNFQjBDMEY2RTc1QjQ4QjM1QTI0AA==",
"conversationId": "01a0d456-e5a1-7b2c-8d3e-4f5a6b7c8d9e",
"phoneNumberId": "109876543210987",
"contact": {
"id": "01a0d456-e419-7c69-a35f-38a00ae65b81",
"phone": "5491155550101",
"name": "Marta Gómez"
},
"type": "text",
"text": "Hola, ¿tienen envío a Rosario?",
"receivedAt": "2026-09-24T17:31:07.000Z"
}
}Eventos de webhook
message.received
Un cliente te escribió por WhatsApp o por Instagram. Las reacciones no disparan este evento.
WEBHOOK
message.received
{
"id": "01a0d4a1-3b4c-7d5e-8f60-7a8b9c0d1e2f",
"event": "message.received",
"createdAt": "2026-09-24T17:31:08.412Z",
"data": {
"id": "01a0d4a1-3a10-7b21-9c32-4d5e6f7a8b9c",
"wamid": "wamid.HBgNNTQ5MTE1NTU1MDEwMRUCABIYFjNFQjBDMEY2RTc1QjQ4QjM1QTI0AA==",
"conversationId": "01a0d456-e5a1-7b2c-8d3e-4f5a6b7c8d9e",
"phoneNumberId": "109876543210987",
"contact": {
"id": "01a0d456-e419-7c69-a35f-38a00ae65b81",
"phone": "5491155550101",
"name": "Marta Gómez"
},
"type": "text",
"text": "Hola, ¿tienen envío a Rosario?",
"receivedAt": "2026-09-24T17:31:07.000Z"
}
}Encabezados
Nombre del evento, igual que event en el cuerpo.
Id de la entrega, igual que id en el cuerpo. Se repite en los reintentos: úsalo para no procesar dos veces lo mismo.
Firma: t=<unix>,v1=<hex>, donde v1 es el HMAC-SHA256 de "<t>.<cuerpo>" con tu secreto de firma.
Cuerpo
application/json
Id de la entrega. Se repite en los reintentos.
Opciones disponibles:
message.received, message.status, contact.created, contact.opted_out, campaign.completed Allowed value:
"message.received"Cuándo ocurrió el evento.
- WhatsApp
- Instagram
Show child attributes
Show child attributes
Solo en el evento de prueba del botón Probar.
Respuesta
200
Responde con cualquier 2xx para confirmar que lo recibiste.