Tipos de eventos y mensajes
Consulta la forma normalizada de message.received y los tipos de mensaje que el contrato v1 reconoce.
El único evento público documentado es message.received. El canal operativo del contrato actual es whatsapp.
Sobre del evento
{
"id": "nce_22f983e5-8424-451f-91a4-0a19fd3c98c0",
"type": "message.received",
"deliveryId": "ncd_2f00c5d7-9031-4211-af34-a3fb4af69965",
"projectId": "ncp_a3d88567-3b40-4114-98b8-aab5b736ad23",
"connectionId": "ncc_b26dddab-f94d-44e9-931e-3128aa02c581",
"conversationId": "ncv_8354e263-3958-4602-b54c-6b6fd84720c2",
"channel": "whatsapp",
"contact": {
"id": "yIuNoG4UoT6jDrLRJiFjBd3FdGFQ55GZYUMfPk8A0L4",
"displayName": "Daniel"
},
"message": {
"id": "wamid.HBgNNTIxMzMxMjM0NTY3OBUCABIY...",
"type": "text",
"timestamp": "2026-08-25T18:42:31.000Z",
"text": "Hola, quiero información"
},
"receivedAt": "2026-08-25T18:42:32.217Z"
}Texto
{
"id": "wamid...",
"type": "text",
"timestamp": "2026-08-25T18:42:31.000Z",
"text": "Contenido del mensaje"
}Máximo de text: 4,000 caracteres.
Botón
{
"id": "wamid...",
"type": "button",
"timestamp": "2026-08-25T18:42:31.000Z",
"button": "Confirmar"
}Interactivo
{
"id": "wamid...",
"type": "interactive",
"timestamp": "2026-08-25T18:42:31.000Z",
"interactive": {
"type": "button_reply",
"id": "confirm_booking",
"title": "Confirmar"
}
}interactive.type puede reflejar, entre otros, button_reply o list_reply según Meta.
Imagen, audio, video, documento o sticker
{
"id": "wamid...",
"type": "document",
"timestamp": "2026-08-25T18:42:31.000Z",
"media": {
"id": "META_MEDIA_ID",
"mimeType": "application/pdf",
"caption": "Cotización",
"filename": "cotizacion.pdf"
}
}Tipos reconocidos: image, audio, video, document, sticker. El contrato entrega metadatos e identificador de Meta; no garantiza incluir el archivo binario ni una URL pública de descarga.
Tipo desconocido
{
"id": "wamid...",
"type": "unknown",
"timestamp": "2026-08-25T18:42:31.000Z"
}Tu integración debe tolerar tipos desconocidos para mantener compatibilidad futura.