Webhooks posteriores a la llamada
Recibe notificaciones cuando terminen las llamadas y se complete el análisis mediante webhooks.
Descripción general
Los webhooks posteriores a la llamada te permiten recibir información detallada sobre una llamada tras completar el análisis. Cuando están activados, ElevenLabs enviará una solicitud POST a la ruta que especifiques con datos completos de la llamada.
ElevenLabs admite tres tipos de webhooks posteriores a la llamada:
- Webhooks de transcripción (
post_call_transcription): contienen datos completos de la conversación, incluidas transcripciones, resultados de análisis y metadatos. - Webhooks de audio (
post_call_audio): contienen datos mínimos con el audio de toda la conversación codificado en base64. - Webhooks de error al iniciar la llamada (
call_initiation_failure): contienen información sobre intentos fallidos de iniciar llamadas, incluidos los motivos del error y metadatos.
Activar webhooks posteriores a la llamada
Puedes activar webhooks posteriores a la llamada para todos los agentes de tu espacio de trabajo desde la página de configuración de ElevenAgents.

Los webhooks posteriores a la llamada deben devolver un código de estado 200 para considerarse correctos. Los webhooks que fallen repetidamente se desactivan automáticamente si hay 10 o más errores consecutivos y la última entrega correcta fue hace más de 7 días o nunca se entregaron correctamente.
Los webhooks posteriores a la llamada se pueden reintentar automáticamente si fallan. Consulta los reintentos de webhooks.
Autenticación
Es importante que el listener valide todos los webhooks entrantes. Actualmente, los webhooks admiten autenticación mediante firmas HMAC. Configura la autenticación HMAC de esta forma:
- Almacena de forma segura el secreto compartido generado al crear el webhook
- Verifica la cabecera ElevenLabs-Signature en tu ruta de API mediante el SDK
El SDK de JavaScript incluye constructEvent; el SDK de Python incluye construct_event con rawBody, sig_header y secret (en Python no se llaman payload / signature). Ambos verifican la firma, validan la marca de tiempo y analizan la carga útil JSON.
Python
JavaScript
Ejemplo de controlador de webhook con FastAPI:
Encabezados de solicitud personalizados
Además de la validación de firmas HMAC, puedes incluir encabezados personalizados en cada entrega de webhook. Esto resulta útil para transmitir claves de API, tokens bearer u otros encabezados de autenticación que requiera la ruta receptora.
Panel
CLI
SDK
Actualmente no se pueden configurar encabezados personalizados desde el panel de ElevenAgents. Usa el SDK o la API para configurar encabezados personalizados.
Los encabezados personalizados funcionan junto con la autenticación HMAC. auth_type debe seguir configurado como hmac,
y los encabezados personalizados se envían además del encabezado ElevenLabs-Signature.
Los encabezados personalizados son de solo escritura. La ruta para listar webhooks
no devuelve request_headers en su respuesta, por lo que no puedes consultar qué encabezados están
configurados para un webhook.
Lista de IP permitidas
Para mayor seguridad, puedes añadir las IP de salida estáticas de ElevenLabs a tu lista de permitidas. Consulta la lista de IP permitidas para ver la lista completa de direcciones IP.
Usar una lista de IP permitidas junto con la validación de firmas HMAC proporciona varias capas de seguridad.
Anulaciones de webhook por agente
De forma predeterminada, todos los agentes de tu espacio de trabajo usan el webhook configurado en la configuración del espacio de trabajo. Puedes anularlo para cada agente y enviar los datos posteriores a la llamada a rutas distintas según el agente.
Panel
CLI
SDK
Abre la configuración del agente
Ve a tu agente en el panel de ElevenAgents y entra en Configuración.
post_call_webhook_id debe hacer referencia a un webhook que ya exista en tu espacio de trabajo. También puedes especificar qué tipos de eventos enviar mediante la matriz events:
Estructura de respuesta del webhook
ElevenLabs envía tres tipos distintos de webhooks posteriores a la llamada, cada uno con estructuras de datos diferentes:
Webhooks de transcripción (post_call_transcription)
Contienen datos completos de la conversación, incluidas transcripciones completas, resultados de análisis y metadatos.
Campos de nivel superior
Estructura del objeto de datos
El objeto data contiene:
conversation_initiation_client_data.dynamic_variables asigna nombres de variables a cualquier valor JSON, incluidas listas y objetos. Incluye las variables integradas system__, y se pueden añadir otras nuevas, así que no rechaces claves ni tipos de valores que no reconozcas. Consulta variables dinámicas.
Webhooks de audio (post_call_audio)
Contienen datos mínimos con el audio de toda la conversación como MP3 codificado en base64.
Campos de nivel superior
Estructura del objeto de datos
El objeto data contiene únicamente:
Los webhooks de audio contienen únicamente los campos indicados arriba. NO incluyen datos de transcripción, metadatos, resultados de análisis ni ningún otro detalle de la conversación.
Webhooks de error al iniciar la llamada (call_initiation_failure)
Contienen información sobre intentos de iniciar llamadas de telefonía, incluidos los motivos del error y metadatos del proveedor de telefonía.
Los eventos de webhook de error al iniciar la llamada se envían cuando una llamada no se puede iniciar debido a errores de conexión, porque el usuario rechaza la llamada o porque no responde. Si una llamada va al buzón de voz o la contesta un servicio automatizado, no se envía ningún webhook de error al iniciar la llamada, ya que la llamada se inició correctamente.
Campos de nivel superior
Estructura del objeto de datos
El objeto data contiene:
Para las llamadas salientes realizadas mediante Twilio, failure_reason se deriva de CallStatus de Twilio: busy y no-answer se transmiten sin cambios, y failed se informa como unknown. Otros estados de llamadas de Twilio no envían un webhook de error al iniciar la llamada.
Estructura del objeto de metadatos
La estructura del objeto metadata varía según si la llamada saliente se realizó mediante Twilio o mediante trunking SIP. El objeto incluye un campo type que distingue entre ambos y un campo body con detalles específicos del proveedor.
Metadatos SIP (type: "sip"):
El objeto body de los metadatos SIP contiene:
Metadatos de Twilio (type: "twilio"):
Ejemplos de cargas útiles de webhook
Ejemplo de webhook de transcripción
Ejemplo de webhook de audio
Ejemplos de webhooks por error al iniciar la llamada
Ejemplo de metadatos de Twilio
Ejemplo de metadatos de SIP
Entrega de webhooks de audio
Los webhooks de audio se entregan por separado de los webhooks de transcripción y solo contienen los campos esenciales necesarios para identificar la conversación, junto con los datos de audio codificados en base64.
Puedes activar o desactivar los webhooks de audio mediante el interruptor “Enviar datos de audio” en la configuración de tu webhook. Puedes configurar este ajuste tanto a nivel de espacio de trabajo (en la configuración de ElevenAgents) como a nivel de agente (en las anulaciones de webhook de cada agente).
Entrega en streaming
Los webhooks de audio se entregan como solicitudes HTTP en streaming con la cabecera transfer-encoding: chunked para gestionar archivos de audio grandes de forma eficiente. El tiempo de espera de cada solicitud es de 5 minutos.
Reintentos
Cuando los reintentos están activados en el webhook, los envíos de audio fallidos se reintentan con la misma programación que los webhooks de transcripción. Un reintento vuelve a enviar la carga útil de audio completa, así que elimina duplicados mediante conversation_id. Consulta los reintentos de webhooks para ver la programación, los errores que permiten reintentos y los límites de tamaño de audio.
Procesar webhooks de audio
Como los webhooks de audio se entregan mediante codificación de transferencia por fragmentos, tendrás que gestionar correctamente los datos en streaming:
Los webhooks de audio pueden contener archivos grandes, así que asegúrate de que tu ruta de API de webhook pueda gestionar solicitudes en streaming y tenga suficiente capacidad de memoria y almacenamiento. El audio se entrega en formato MP3.
Casos de uso
Seguimientos automáticos de llamadas
Los webhooks posteriores a la llamada te permiten crear workflows automatizados que se activan inmediatamente después de que termine una llamada. Estas son algunas aplicaciones prácticas:
Integración con CRM
Actualiza tu sistema de gestión de relaciones con clientes con los datos de la conversación en cuanto finalice una llamada:
Conversaciones con estado
Mantén el contexto de la conversación entre varias interacciones almacenando y recuperando el estado:
- Cuando comience una llamada, pasa el ID de tu usuario como variable dinámica.
- Cuando termine una llamada, configura tu ruta de API de webhook para almacenar los datos de la conversación en tu base de datos, según el ID de usuario extraído de dynamic_variables.
- Cuando el usuario vuelva a llamar, podrás recuperar este contexto y pasarlo a la nueva conversación en una variable dinámica
{{previous_topics}}. - Esto crea una experiencia fluida en la que el agente “recuerda” interacciones anteriores.