Skip to main content
Se emite un evento de finalización después de que termina cada llamada: telefonía entrante, telefonía saliente, llamada web o llamada de prueba (sesión de micrófono del builder). Es no bloqueante: responde con cualquier código 2xx. El evento se entrega por ambas rutas:

Carga útil de la solicitud (entregas a endpoints)

Motivos de finalización

Formato de transcripción

Cada entrada en transcripts 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 en transcripts (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") omiten from_number / to_number y agregan origin_domain.
  • Las llamadas de prueba de micrófono del Builder se informan como telephony.complete en la ruta heredada (el sistema de endpoints las asigna a web.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.