Eventos de WhatsApp

Webhooks de WhatsApp listos para tu aplicación.

Easyhook recibe los eventos del proveedor, identifica la organización y el canal, y entrega un contrato normalizado para que tu sistema procese mensajes y estados sin depender del payload interno de Meta.

Crear cuenta Ver contrato completo

Evento message.received

{
  "id": "evt_...",
  "type": "message.received",
  "provider": "whatsapp",
  "account": {
    "id": "980912725115744",
    "phone": "5218661479075"
  },
  "contact": {
    "id": "5215660069997",
    "name": "Cliente"
  },
  "message": {
    "id": "wamid...",
    "direction": "in",
    "type": "text",
    "text": "Hola"
  }
}

Un contrato estable para tráfico en vivo y sincronizaciones.

Filtros por alcance

Suscríbete a toda la organización, un WABA, un número o un canal conectado.

Entrega autenticada

Cada suscripción obtiene un secreto y las solicitudes incluyen firma HMAC verificable.

Reintentos e idempotencia

Las entregas son at-least-once; usa el ID del evento o wamid para procesarlas sin duplicados.

Flujo de entrega

Registra el endpoint
Crea una suscripción desde el portal, la API o el trigger oficial de n8n.
Valida la firma
Comprueba la firma utilizando el body sin modificar antes de procesar el evento.
Responde rápidamente
Devuelve HTTP 2xx y mueve el trabajo pesado a tu propia cola cuando sea necesario.

Semántica importante

Los webhooks pueden repetirse; el consumidor debe ser idempotente.
Los eventos de History son importaciones y no deben activar respuestas automáticas como si fueran mensajes nuevos.
Los lotes de sincronización pueden llegar en más de una entrega y no garantizan orden global entre conversaciones.