En breve
- Cada entrega es un POST
application/jsona tu URL registrada. - Los eventos
sms.*son solo SMS; WhatsApp usamessage.*. instanceIdsiempre está vacío (SMS no utiliza instancias).- Habilite solo los eventos que su integración necesita.
- Responda 2xx rápidamente; el trabajo pesado va a una cola de tu lado.
Cómo se ve el POST
Encabezados:
X-Notifique-Signature, X-Notifique-Timestamp, X-Workspace-Id, X-Webhook-Event.
Qué debe devolver tu servidor
¿Procesamiento lento? Responda 200 inmediatamente y procese en segundo plano. Más de ~10 s cuenta como timeout y el evento puede reenviarse.
X-Notifique-Signature y una marca de tiempo reciente. Detalles: Seguridad de webhooks.
Referencia de eventos
Use estos eventos al integrar ERP, e-commerce o automatización con SMS.Envío y estado
Mensajes entrantes (MO)
MO sigue las reglas de entrantes en Configuración → Mensajes recibidos, como otros canales. Guía: Mensajes entrantes.
Carga útil por evento
Cuerpo POST completo. El sobre (event, ids, timestamp) coincide con el ejemplo anterior; abajo cambia lo que va en data.
sms.sent
sms.sent
sms.delivered
sms.delivered
sms.failed
sms.failed
sms.cancelled
sms.cancelled
sms.clicked
sms.clicked
Se activa en el primer clic en un enlace corto rastreado de este SMS.
sms.received
sms.received
sms.replied
sms.replied
Cuando el MO está vinculado a su envío saliente (ej. respuesta de encuesta).
Próximos pasos
- Inicio rápido: primer envío
- Introducción: ciclo de vida del estado
- Ámbitos: permisos de clave
- Webhooks (guía general)

