Eventos de las llamadas (webhook)
SendApp puede avisar a tu sistema cuando una llamada empieza, termina, pasa a una persona o cuando quien llama pide que le devuelvan la llamada. Se activa en Agenda → Webhook: elige la dirección y marca los eventos de Voice AI. Cada evento llega con una solicitud POST firmada, como los eventos de las reservas.
Los eventos de Voice AI solo llegan si los marcaste: un webhook creado antes, o sin eventos elegidos, sigue recibiendo solo las reservas.
El cuerpo es
{event, occurred_at, account_ref, call, delivery_id}: call tiene los mismos campos que GET /api/voice/calls/{call_id}, sin transcripción. account_ref identifica la cuenta y no es una clave: el cuerpo nunca contiene tu clave API.voice.call.ended es la foto de la llamada en el momento en que termina: el resumen de la IA y la categoría llegan después, así que léelos en GET /api/voice/calls/{call_id}. El estado de la devolución de llamada llega con voice.callback.requested. Cada evento se envía una sola vez por llamada.Verifica la firma: el header
X-SendApp-Signature vale t=<timestamp>,v1=<HMAC-SHA256 de "timestamp.cuerpo"> con la clave secreta del webhook. Responde con un código 2xx: si no, reintentamos tras 1, 5 y 30 minutos.Parámetros
4 · 0 obligatorios
voice.call.started
opcional
Una llamada ha empezado.
voice.call.ended
opcional
Una llamada ha terminado: con resultado, duración y resumen.
voice.call.escalated
opcional
La IA pasó la llamada a una persona.
voice.callback.requested
opcional
Quien llamó pide que le devuelvan la llamada.
¿Necesitas ayuda con la integración? info@sendapp.live