ElevenLabs

​

Conectar

1. Abre Configuración → Integraciones → ElevenLabs y haz clic en Conectar ElevenLabs.
2. Pega tu clave de API de ElevenLabs. Puedes crearla en elevenlabs.io, dentro de Claves de API en tu perfil. La utilizamos para obtener los metadatos de los agentes y los datos de las llamadas cuando se necesitan.

Puedes conectar varias cuentas de ElevenLabs a una misma organización.

​

Activar la entrega en tiempo real

De forma predeterminada, Zelto sincroniza las llamadas periódicamente. Para que aparezcan en pocos segundos, añade en ElevenLabs un webhook posterior a la llamada que apunte a Zelto y pega su secreto de firma en la integración. Así, Zelto puede verificar cada entrega. El webhook se configura para todo el espacio de trabajo de ElevenLabs y cubre todos sus agentes, aunque también puedes restringirlo por agente mediante sus opciones de webhook. Solo los administradores del espacio de trabajo pueden configurarlo. Mientras no configures un secreto, el webhook permanece inactivo en Zelto y las llamadas siguen llegando mediante la sincronización periódica. La integración funciona de las dos formas.

​

Qué se ingiere

Zelto ingiere las llamadas de IA conversacional de ElevenLabs de dos formas:

• Webhook posterior a la llamada — cada llamada finalizada se envía con la transcripción completa y aparece como una conversación en pocos segundos. Zelto obtiene la grabación desde el endpoint de audio autenticado y la vuelve a alojar, ya que ElevenLabs no proporciona una URL de grabación permanente.
• Sincronización periódica e importación de 14 días — cada agente importado se sincroniza aproximadamente cada 15 minutos. Al importarlo, Zelto también obtiene sus llamadas de los 14 días anteriores. Puedes volver a importarlo para actualizar ese historial. Ambos métodos eliminan duplicados mediante el identificador de conversación de ElevenLabs.

Importa un agente desde Agentes → Añadir agente → ElevenLabs. Allí verás los agentes disponibles en la cuenta conectada. Zelto también captura las invocaciones de herramientas del agente a partir de tool_calls y tool_results, junto con su nombre, argumentos y resultado. Se muestran dentro de la transcripción, se incluyen en el análisis de IA y se registran como trazas de invocaciones de herramientas consultables. No hace falta configurar nada.

​

Trazas y registros de diagnóstico

Para las llamadas nuevas importadas y las entregas del webhook posterior a la llamada, Zelto obtiene la exportación OpenTelemetry de ElevenLabs en un trabajo independiente. Conserva los identificadores de traza, la jerarquía de spans, las marcas de tiempo, los atributos de herramientas y los estados de error, vinculados a la llamada y al agente en Trazas. La clave de API necesita CONVAI_READ. ElevenLabs regenera los identificadores de span en cada exportación. Zelto asigna identificadores estables para evitar duplicados en los reintentos y conserva los originales en los atributos. Registros incluye errores, advertencias y el motivo de finalización presentes en los metadatos de la conversación. Son registros derivados de esos metadatos, no los registros internos del servidor de ElevenLabs. Usan la hora de finalización de la llamada; no indican el momento exacto de cada advertencia. Mantén el webhook en el formato predeterminado de transcripción JSON (post_call_transcription). Zelto solicita OpenTelemetry por separado mediante la API, sin cambiar el formato del webhook ni configurar un colector. Los spans posteriores a la llamada usan los tiempos de la transcripción, no mediciones de cada operación interna de STT, LLM o TTS. No se incluye monitoreo en vivo. Los datos eliminados o no disponibles en el proveedor no se pueden recuperar. Se omiten las llamadas de 89 días o más para evitar importar datos que están por vencer según la retención de telemetría de 90 días de Zelto.

​

Verificar la primera llamada

Haz una llamada de prueba y abre Conversaciones. Con el webhook configurado, debería aparecer con su transcripción en pocos segundos. Si no aparece, la tarjeta Conexiones del agente muestra si se están recibiendo llamadas y señala la entrega fallida más reciente. Una entrega firmada rechazada suele indicar que el secreto guardado en Zelto no coincide con el de ElevenLabs. Consulta Conectar un proveedor de voz.

​

Estado de la conexión y desconexión

La tarjeta muestra la cuenta, la URL del webhook y si hay un secreto de firma configurado. Desconectar elimina la clave de API y el secreto guardados. Elimina también el webhook en ElevenLabs para detener los envíos desde su plataforma.

​

Contenido relacionado

• Conectar un proveedor de voz — elige un método y verifica la ingestión.
• Conversaciones — dónde aparecen las llamadas de ElevenLabs.
• Agentes — cómo representa Zelto a cada agente.
• Hallazgos — los resultados del análisis de cada llamada.
• Speechify · Retell · Vapi — otras integraciones de voz nativas.