- Los endpoints de webhook reciben
telephony.complete(llamadas telefónicas) oweb.complete(llamadas web y llamadas de prueba con micrófono del builder) con la carga útil estable documentada a continuación, unevent_idpor entrega, un tiempo de espera de 30 s y reintentos durante hasta 24 h. - El webhook heredado de una sola URL recibe un intento sincrónico (tiempo de espera de 10 s, sin reintentos) con una carga útil ligeramente diferente; consulta Diferencias de la carga útil heredada.
Carga útil de la solicitud (entregas a endpoints)
Motivos de finalización
Formato de transcripción
Cada entrada entranscripts corresponde a un turno conversacional. Los roles son
user (habla de quien llama), model (habla del agente y llamadas a herramientas),
tool (resultados de herramientas) y system (eventos de la llamada, como cambios
de idioma).
Para el historial de turnos completamente estructurado (con marcadores de
interrupción, prompts de confirmación y posiciones sin procesar), usa
GET /v1/calls/{call_id}/history.
Diferencias de la carga útil heredada
El sobre de webhook heredado de una sola URL es{"type": "telephony.complete" | "web.complete", "data": {…}} sin
event_id, y sus data difieren de la carga útil del endpoint:
- El arreglo de turnos está en
history, no entranscripts(con el mismo esquema de turnos que se muestra arriba). - El conjunto de campos es el informe sin procesar del final de la llamada y puede incluir campos internos adicionales además de los de la tabla anterior; trata los campos desconocidos como informativos.
- Las llamadas web (
direction: "web") omitenfrom_number/to_numbery agreganorigin_domain. - Las llamadas de prueba de micrófono del Builder se informan como
telephony.completeen la ruta heredada (el sistema de endpoints las asigna aweb.complete). - Coordinación de transferencia: cuando una llamada termina en una transferencia, el
webhook heredado se llama de forma síncrona y puede responder
{"transfer_ready": false}para indicar que el destino de la transferencia no está listo. Cualquier otra respuesta (o la ausencia de un webhook heredado) permite que la transferencia continúe. Las entregas a endpoints nunca se consultan para esto.
Ejemplo de controlador
Casos de uso comunes
Integración con CRM
Guarda la transcripción y la URL de grabación de cada llamada junto con los
registros de tus clientes.
Analítica
Envía transcripciones a un flujo para modelado de temas, extracción de
señales de CSAT o monitoreo de la tasa de transferencias.
Revisión de calidad
Abre llamadas en una herramienta de control de calidad para revisión humana
o ejecútalas con tu propio modelo de evaluación.
Notificaciones
Notifica a un integrante humano del equipo ante una transferencia o falla.
Relacionado
telephony.incoming / web.incoming
La contraparte bloqueante que se ejecuta al inicio de la llamada.
Catálogo de eventos
Otros tipos de eventos a los que puedes suscribirte.
API de historial de llamadas
Los mismos datos disponibles mediante REST para completar datos históricos o reproducirlos.