Eventos de Webhook

Con la API preguntas; con Webhooks Notifique notifica. Ideal para pausar campañas externas, abrir tickets de soporte o auditar ejecuciones sin sondeo.

En resumen

Cada entrega es un POST con application/json a tu URL registrada.
Los eventos automation.* cubren la definición (habilitar/deshabilitar) y las ejecuciones (runs).
instanceId está vacío (las automatizaciones pertenecen al Workspace, no a un canal).
Habilita solo los eventos que usa tu integración.
Responde 2xx rápido; el procesamiento pesado va a una cola de tu lado.

Configuración general: Webhooks.

Este es un Webhook saliente (Notifique → tu servidor). Para disparar una automatización con un POST desde tu sistema, configura el activador HTTP en el editor de automatización o usa Eventos.

Cómo se ve el POST

{
  "event": "automation.run.completed",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-07-25T16:05:00.000Z",
  "data": {
    "automationId": "clxx...",
    "runId": "clxx...",
    "contactId": "clxx...",
    "status": "COMPLETED",
    "previousStatus": "RUNNING",
    "eventName": "whatsapp.inbound",
    "isSandbox": false,
    "errorMessage": null,
    "startedAt": "2026-07-25T16:04:50.000Z",
    "completedAt": "2026-07-25T16:05:00.000Z"
  }
}

Campo	Descripción
`event`	Nombre del evento (p. ej. `automation.run.completed`)
`workspaceId`	ID del Workspace
`instanceId`	Siempre vacío para automatizaciones
`timestamp`	ISO 8601, úsalo para anti-replay
`data`	Campos de la definición o de la ejecución

Headers: X-Notifique-Signature, X-Notifique-Timestamp, X-Workspace-Id, X-Webhook-Event.

Qué debe devolver tu servidor

Respuesta	Efecto
2xx en ~10 s	Evento entregado; se elimina de la cola
4xx / 5xx / timeout	Reintento automático (5 min, 30 min, 2 h)

¿Procesamiento lento? Devuelve 200 de inmediato y procesa en segundo plano.

Referencia de eventos

Definición de automatización

Evento	Cuándo se dispara	Qué hacer con ello
`automation.enabled`	La definición pasa a `ENABLED`	Habilita el flujo en tu sistema
`automation.disabled`	La definición pasa a `DISABLED`	Pausa dependencias externas
`automation.status_changed`	Cualquier cambio `ENABLED` ↔ `DISABLED`	Actualiza el estado en CRM/ERP

Ejecución (run)

Evento	Cuándo se dispara	Qué hacer con ello
`automation.run.started`	Se crea una ejecución y comienza	Abre ticket / log de ejecución
`automation.run.completed`	La ejecución termina con éxito	Cierra el flujo / marca éxito
`automation.run.failed`	La ejecución falla en un paso crítico	Alerta e inspecciona `errorMessage`
`automation.run.cancelled`	Ejecución cancelada (stop)	Limpia el estado pendiente

Payload por evento

automation.disabled

{
  "event": "automation.disabled",
  "workspaceId": "clxx...",
  "instanceId": "",
  "timestamp": "2026-07-25T16:00:00.000Z",
  "data": {
    "automationId": "clxx...",
    "name": "WhatsApp welcome",
    "status": "DISABLED",
    "previousStatus": "ENABLED",
    "triggerKind": "CHANNEL_INBOUND",
    "triggerChannel": "WHATSAPP",
    "triggerEventName": null,
    "graphVersion": 3
  }
}

automation.run.completed

{
  "event": "automation.run.completed",
  "workspaceId": "clxx...",
  "instanceId": "",
  "timestamp": "2026-07-25T16:05:00.000Z",
  "data": {
    "automationId": "clxx...",
    "runId": "clxx...",
    "contactId": "clxx...",
    "status": "COMPLETED",
    "previousStatus": "RUNNING",
    "eventName": "whatsapp.inbound",
    "isSandbox": false,
    "errorMessage": null,
    "startedAt": "2026-07-25T16:04:50.000Z",
    "completedAt": "2026-07-25T16:05:00.000Z"
  }
}

Automatizaciones

Eventos de Webhook

En resumen

Cómo se ve el POST

Qué debe devolver tu servidor

Referencia de eventos

Definición de automatización

Ejecución (run)

Payload por evento

Próximos pasos

​En resumen

​Cómo se ve el POST

​Qué debe devolver tu servidor

​Referencia de eventos

​Definición de automatización

​Ejecución (run)

​Payload por evento

​Próximos pasos

En resumen

Cómo se ve el POST

Qué debe devolver tu servidor

Referencia de eventos

Definición de automatización

Ejecución (run)

Payload por evento

Próximos pasos