Eventos dos Webhooks

Na API você pergunta; no webhook a Notifique avisa. Ideal para pausar campanhas externas, abrir tickets de suporte ou auditar execuções sem polling.

Em poucas palavras

Toda entrega é um POST application/json para a URL cadastrada.
Eventos automation.* cobrem definição (ativar/pausar) e runs (execuções).
instanceId vem vazio (automação é do workspace, não de um canal).
Ative só os eventos que sua integração usa.
Responda 2xx rápido; processamento pesado vai para fila no seu lado.

Configuração geral: Webhooks.

Isto é webhook outbound (Notifique → seu servidor). Para disparar uma automação com POST do seu sistema, configure o gatilho HTTP no editor da automação ou use Eventos.

Como vem o 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	Descrição
`event`	Nome do evento (ex.: `automation.run.completed`)
`workspaceId`	ID do workspace
`instanceId`	Sempre vazio em automações
`timestamp`	ISO 8601, use para anti-replay
`data`	Campos da definição ou da run

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

O que seu servidor deve responder

Resposta	Efeito
2xx em até ~10s	Evento entregue; sai da fila
4xx / 5xx / timeout	Retentativa automática (5 min, 30 min, 2 h)

Processamento demorado? Responda 200 logo e processe em background.

Referência por evento

Definição da automação

Evento	Quando dispara	O que fazer com isso
`automation.enabled`	Definição passa para `ENABLED`	Liberar o fluxo no seu sistema
`automation.disabled`	Definição passa para `DISABLED`	Pausar dependências externas
`automation.status_changed`	Qualquer troca `ENABLED` ↔ `DISABLED`	Atualizar status no CRM/ERP

Execução (run)

Evento	Quando dispara	O que fazer com isso
`automation.run.started`	Uma run é criada e começa	Abrir ticket / log de execução
`automation.run.completed`	Run termina com sucesso	Fechar fluxo / marcar sucesso
`automation.run.failed`	Run falha em passo crítico	Alertar e investigar `errorMessage`
`automation.run.cancelled`	Run cancelada (stop)	Limpar estado pendente

Payload de cada evento

automation.disabled

{
  "event": "automation.disabled",
  "workspaceId": "clxx...",
  "instanceId": "",
  "timestamp": "2026-07-25T16:00:00.000Z",
  "data": {
    "automationId": "clxx...",
    "name": "Boas-vindas WhatsApp",
    "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"
  }
}

Automações

Eventos dos Webhooks

Em poucas palavras

Como vem o POST

O que seu servidor deve responder

Referência por evento

Definição da automação

Execução (run)

Payload de cada evento

Próximos passos

​Em poucas palavras

​Como vem o POST

​O que seu servidor deve responder

​Referência por evento

​Definição da automação

​Execução (run)

​Payload de cada evento

​Próximos passos

Em poucas palavras

Como vem o POST

O que seu servidor deve responder

Referência por evento

Definição da automação

Execução (run)

Payload de cada evento

Próximos passos