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.

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.

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.

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

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

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.