Eventos de webhook

Con la API usted pregunta; con webhooks Notifique avisa. Excelente para IVR, marcadores y facturación por minuto, sin sondeo de estado.

En breve

Cada entrega es un POST application/json a tu URL registrada.
Las llamadas usan voice.call.*; no confundir con message.* (WhatsApp) o sms.*.
El ciclo de vida del número contratado (phone_number.*) está documentado en Números de teléfono, Eventos.
instanceId está vacío (voz no usa instancia de canal).
Responda 2xx rápidamente; el procesamiento pesado va a su cola.

Configuración general: Webhooks. Seguridad (firma HMAC): Seguridad del webhook.

Cómo se ve el POST

Campo	Descripción
`event`	Nombre del evento (ej. `voice.call.answered`)
`workspaceId`	ID del espacio de trabajo
`instanceId`	Siempre vacío para voz
`timestamp`	ISO 8601, use para anti-replay
`data`	Campos de llamada o número (camelCase)

Encabezados: 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; eliminado de la cola
4xx / 5xx / timeout	Reintento automático (5 min, 30 min, 2 h)

¿Procesamiento lento? Devuelva 200 inmediatamente y procese en segundo plano.

Eventos de llamada (`voice.call.*`)

Evento	Cuándo se dispara	Qué hacer con ello
`voice.call.initiated`	Marcación saliente iniciada	Log, CRM
`voice.call.received`	Llamada entrante al número	Enrutamiento / IVR
`voice.call.ringing`	Destino sonando	UI de estado
`voice.call.answered`	Llamada contestada	Iniciar flujo, facturación
`voice.call.completed`	Llamada finalizada	Cerrar ticket, facturación
`voice.call.failed`	No se completó	Reintentar o alertar
`voice.call.dtmf`	Cliente presionó tecla	Menú interactivo
`voice.call.gather.ended`	Recolección DTMF terminada	Siguiente paso IVR
`voice.call.recording.ready`	Grabación disponible	QA, cumplimiento
`voice.call.machine.detected`	Buzón de voz detectado	Regla de reintento

Carga útil por evento de llamada

voice.call.initiated

voice.call.received

Se activa en llamadas entrantes. Úselo con inboundVoiceAction: WEBHOOK_CONTROL en el número.

voice.call.ringing

voice.call.answered

voice.call.completed

voice.call.failed

voice.call.dtmf

voice.call.gather.ended

voice.call.recording.ready

voice.call.machine.detected

Webhook por llamada

Además de los webhooks globales del workspace (Webhooks), cada origen puede definir su propio destino:

"options": {
  "webhook": {
    "url": "https://api.suempresa.com/voice/hooks",
    "secret": "opcional"
  }
}

Cuando options.webhook.url está presente, todos los eventos voice.call.* de esa llamada van solo a esa URL. Los endpoints del workspace no reciben copia del mismo evento. Firma: encabezado X-Notifique-Signature con el secret indicado. Detalles: Eventos de webhooks.

Entrante con webhook

Cuando el número usa inboundVoiceAction: WEBHOOK_CONTROL:

Reciba voice.call.received
Controle la sesión con acciones API (speak, gather, transfer, hangup)
Siga voice.call.answered, voice.call.dtmf, voice.call.completed, etc.

Configuración del número: Números de teléfono, Inicio rápido.

Próximos pasos

Inicio rápido: originar y controlar
Introducción: ciclo de vida de la llamada
Ámbitos: permisos de clave
Números de teléfono: contratar y configurar línea
Webhooks (guía general)

Voz

Voice: Chamadas

Voice: Fluxos IVR

Números de teléfono

Números de Telefone

Números de teléfono

Eventos de webhook

En breve

Cómo se ve el POST

Qué debe devolver tu servidor

Eventos de llamada (`voice.call.*`)

Carga útil por evento de llamada

Webhook por llamada

Entrante con webhook

Próximos pasos

​En breve

​Cómo se ve el POST

​Qué debe devolver tu servidor

​Eventos de llamada (voice.call.*)

​Carga útil por evento de llamada

​Webhook por llamada

​Entrante con webhook

​Próximos pasos

En breve

Cómo se ve el POST

Qué debe devolver tu servidor

Eventos de llamada (`voice.call.*`)

Carga útil por evento de llamada

Webhook por llamada

Entrante con webhook

Próximos pasos