Webhook events - Notifique

With the API you ask; with webhooks Notifique tells you. Great for IVR, dialers, and per-minute billing, without status polling.

In brief

Every delivery is a POST application/json to your registered URL.
Calls use voice.call.*, do not confuse with message.* (WhatsApp) or sms.*.
Contracted number lifecycle (phone_number.*) is documented under Phone numbers, Events.
instanceId is empty (voice does not use a channel instance).
Respond 2xx quickly; heavy processing goes to your queue.

General setup: Webhooks. Security (HMAC signature): Webhook security.

How the POST looks

{
  "event": "voice.call.answered",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:30:00.000Z",
  "data": {
    "callId": "clxx_call_1",
    "direction": "OUTBOUND",
    "fromE164": "+5511987654321",
    "toE164": "+5511999887766",
    "status": "ANSWERED",
    "clientState": "campaign-42"
  }
}

Field	Description
`event`	Event name (e.g. `voice.call.answered`)
`workspaceId`	Workspace ID
`instanceId`	Always empty for voice
`timestamp`	ISO 8601, use for anti-replay
`data`	Call or number fields (camelCase)

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

What your server should return

Response	Effect
2xx within ~10s	Event delivered; removed from queue
4xx / 5xx / timeout	Automatic retry (5 min, 30 min, 2 h)

Slow processing? Return 200 immediately and process in the background.

Call events (`voice.call.*`)

Event	When it fires	What to do with it
`voice.call.initiated`	Outbound dial started	Log, CRM
`voice.call.received`	Inbound call to number	Routing / IVR
`voice.call.ringing`	Destination ringing	Status UI
`voice.call.answered`	Call answered	Start flow, billing
`voice.call.completed`	Call ended	Close ticket, billing
`voice.call.failed`	Did not complete	Retry or alert
`voice.call.dtmf`	Customer pressed key	Interactive menu
`voice.call.gather.ended`	DTMF collection finished	Next IVR step
`voice.call.recording.ready`	Recording available	QA, compliance
`voice.call.machine.detected`	Voicemail detected	Retry rule

Payload per call event

voice.call.initiated

{
  "event": "voice.call.initiated",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:29:00.000Z",
  "data": {
    "callId": "clxx_call_1",
    "direction": "OUTBOUND",
    "fromE164": "+5511987654321",
    "toE164": "+5511999887766",
    "status": "INITIATED",
    "clientState": "campaign-42"
  }
}

voice.call.received

Fires on inbound calls. Use with inboundVoiceAction: WEBHOOK_CONTROL on the number.

{
  "event": "voice.call.received",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T15:00:00.000Z",
  "data": {
    "callId": "clxx_call_2",
    "direction": "INBOUND",
    "fromE164": "+5511999887766",
    "toE164": "+5511987654321",
    "status": "RINGING"
  }
}

voice.call.ringing

{
  "event": "voice.call.ringing",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:29:15.000Z",
  "data": {
    "callId": "clxx_call_1",
    "direction": "OUTBOUND",
    "fromE164": "+5511987654321",
    "toE164": "+5511999887766",
    "status": "RINGING"
  }
}

voice.call.answered

{
  "event": "voice.call.answered",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:30:00.000Z",
  "data": {
    "callId": "clxx_call_1",
    "direction": "OUTBOUND",
    "fromE164": "+5511987654321",
    "toE164": "+5511999887766",
    "status": "ANSWERED",
    "answeredAt": "2026-06-11T14:30:00.000Z"
  }
}

voice.call.completed

{
  "event": "voice.call.completed",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:32:00.000Z",
  "data": {
    "callId": "clxx_call_1",
    "direction": "OUTBOUND",
    "fromE164": "+5511987654321",
    "toE164": "+5511999887766",
    "status": "COMPLETED",
    "durationSecs": 120,
    "hangupCause": "normal_clearing"
  }
}

voice.call.failed

{
  "event": "voice.call.failed",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:29:45.000Z",
  "data": {
    "callId": "clxx_call_1",
    "direction": "OUTBOUND",
    "fromE164": "+5511987654321",
    "toE164": "+5511999887766",
    "status": "FAILED",
    "hangupCause": "no_answer"
  }
}

voice.call.dtmf

{
  "event": "voice.call.dtmf",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:30:20.000Z",
  "data": {
    "callId": "clxx_call_1",
    "dtmfDigits": "1"
  }
}

voice.call.gather.ended

{
  "event": "voice.call.gather.ended",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:30:35.000Z",
  "data": {
    "callId": "clxx_call_1",
    "gatherResult": "12345678901"
  }
}

voice.call.recording.ready

{
  "event": "voice.call.recording.ready",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:33:00.000Z",
  "data": {
    "callId": "clxx_call_1",
    "recordingId": "clxx_rec_1"
  }
}

voice.call.machine.detected

{
  "event": "voice.call.machine.detected",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-11T14:30:05.000Z",
  "data": {
    "callId": "clxx_call_1",
    "machineDetectionResult": "machine"
  }
}

Inbound with webhook

When the number uses inboundVoiceAction: WEBHOOK_CONTROL:

Receive voice.call.received
Control the session with API actions (speak, gather, transfer, hangup)
Track voice.call.answered, voice.call.dtmf, voice.call.completed, etc.

Number setup: Phone numbers, Quick Start.

Next steps

Quick Start: originate and control
Introduction: call lifecycle
Scopes: key permissions
Phone numbers: contract and configure line
Webhooks (general guide)

​In brief

​How the POST looks

​What your server should return

​Call events (voice.call.*)

​Payload per call event

​Inbound with webhook

​Next steps

In brief

How the POST looks

What your server should return

Call events (`voice.call.*`)

Payload per call event

Inbound with webhook

Next steps