Retell

​

Conectar

1. Abre Primeros pasos → Retell o Configuración → Integraciones → Retell y haz clic en Conectar Retell.
2. Pega tu clave de API de Retell. La utilizamos para obtener los metadatos, las grabaciones y los análisis de los agentes cuando se necesitan.
3. Importa un agente. Zelto comenzará a sincronizar sus llamadas automáticamente.

Para recibir las llamadas con menor latencia, abre la integración en Configuración y copia su URL de webhook opcional en Retell dashboard → Webhooks. También hay disponible una URL gestionada por Hookdeck, que ofrece reintentos y reproducción de entregas adicionales. Puedes conectar varias cuentas de Retell a una misma organización.

​

Qué se ingiere

Zelto sincroniza periódicamente las llamadas de cada agente importado. Un webhook opcional puede enviar antes dos tipos de eventos de Retell. Los demás se reconocen y se ignoran. Ambos métodos eliminan duplicados mediante el identificador de llamada de Retell. Las grabaciones se guardan en el almacenamiento de Zelto para que el reproductor de la página de detalles de la conversación siga funcionando. La sincronización programada también vincula las llamadas con la versión del agente indicada por agent_version de Retell, incluida la versión 0. Si la lista de llamadas la omite, obtener la llamada completa para importar su transcripción puede completar el vínculo, incluso sin una transcripción disponible. Los vínculos existentes se conservan. Si Retell no indica una versión, la llamada importada queda sin vincular; Zelto no le asigna la última versión del agente. Se captura la identidad de la versión, no una copia histórica del prompt: nunca se usa el prompt actual del agente como prompt de esa versión. Cada llamada de Retell ingerida desde septiembre de 2026 también conserva su contexto de llamada como metadatos, llegue por webhook o por la extracción programada (las llamadas anteriores no tienen contexto, así que un filtro sobre él solo abarca llamadas recientes): call_analysis (incluidos tus campos de custom_analysis_data), retell_llm_dynamic_variables (como dynamic_variables), los metadata personalizados que fijaste en la llamada, direction, call_type, disconnection_reason, un indicador transfer (verdadero cuando la llamada terminó en call_transfer), percentiles de latencia por componente, desglose de costos y uso de tokens. Las llamadas realizadas con el indicador opt_out_sensitive_data_storage de Retell conservan solo los campos operativos (sin números, variables ni metadatos personalizados), y los valores de cabeceras SIP que parecen credenciales se guardan redactados. Vive bajo la clave retell, así que un filtro de metadatos como retell.transfer es verdadero o retell.call_analysis.custom_analysis_data.<campo> igual a … acota la lista de Conversaciones y cada Monitor exactamente a esas llamadas. Zelto también captura las invocaciones de herramientas del agente: las funciones que ejecuta durante una llamada, a partir de transcript_with_tool_calls (tool_call_invocation y tool_call_result), 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. Para filtrar los metadatos de Retell, usa rutas como retell.transfer con «es verdadero» o retell.call_analysis.custom_analysis_data.<field> con «igual». El filtro selecciona esas mismas llamadas en Conversaciones y en Monitores.

​

Trazas y registros

Las nuevas importaciones y las entregas del webhook posterior a la llamada programan una importación independiente de telemetría. En Trazas verás el span de la llamada, las intervenciones con sus tiempos, las invocaciones y resultados de herramientas, las transiciones del flujo y los marcadores de latencia por respuesta. Registros conserva los registros públicos de Retell con sus marcas de tiempo, incluidos los errores de varias líneas, vinculados a la misma traza. Se utiliza tu clave de API actual de Retell; no hace falta otra configuración. Los marcadores conservan las mediciones de latencia total, ASR, LLM y TTS en milisegundos, sin inventar los tiempos de inicio y fin de cada operación. El uso de tokens y el desglose de costos se guardan como atributos en las unidades originales de Retell. Los identificadores estables evitan duplicados al reintentar. Zelto obtiene una URL de registro nueva en cada importación. No guarda las URLs firmadas ni las claves de API en trazas o trabajos. Si Retell ya no conserva el registro, todavía se pueden importar los spans de la llamada y la transcripción. Con redacción de datos personales, solo se usa la transcripción redactada y se omiten los registros sin redactar. Si el almacenamiento de datos sensibles está desactivado, solo se importan metadatos operativos de la llamada. Es telemetría posterior a la llamada, no una transmisión en vivo. Se omiten las llamadas de 89 días o más, según la retención de 90 días. Este cambio no importa en bloque las llamadas existentes. Las descargas se limitan a 5 MiB desde la CDN verificada de Retell o su origen S3 documentado; no se admiten hosts personalizados.

​

Verificar la primera llamada

Haz una llamada de prueba al agente y abre Conversaciones. La siguiente sincronización la añadirá con su transcripción; si configuraste el webhook, aparecerá en pocos segundos. Si no llega, la tarjeta Conexiones del agente muestra si se están recibiendo llamadas y señala el error de ingestión más reciente. Consulta Conectar un proveedor de voz.

​

Administrar Retell desde el chat

Una vez conectada tu cuenta, Pregúntale a Zelto puede leerla y modificarla usando tu propia clave de API de Retell:

• list_retell_agents — consulta todos los agentes de tu cuenta.
• get_retell_agent — obtiene un agente y el prompt actual de su motor de respuesta: general_prompt para un retell-llm o el global_prompt compartido para un flujo de conversación, cuando corresponda.
• list_retell_calls — consulta las llamadas recientes de un agente para revisar su rendimiento.
• update_retell_agent_prompt — sustituye el prompt del retell-llm subyacente. Solo funciona con agentes cuyo motor de respuesta sea retell-llm; todavía no permite editar agentes basados en flujos de conversación.
• update_retell_agent — cambia el name, voiceId o language del agente.

Las lecturas se ejecutan en cuanto las solicitas. Las escrituras (update_*) pasan por una tarjeta de confirmación: no se envía nada a Retell hasta que haces clic en Confirmar.

​

Controlar quién puede usar estas herramientas

Cada integración de voz tiene la opción Acceso a herramientas de chat en el cuadro de diálogo Administrar (Configuración → Integraciones → Retell → Administrar):

• Todos (predeterminado) — cualquier miembro puede utilizar Retell desde el chat.
• Administradores y propietarios — solo propietarios, administradores y administradores globales.
• Desactivado — las herramientas de Retell desaparecen del chat para todos.

Solo los propietarios y administradores pueden cambiar esta opción. El permiso se comprueba al crear el conjunto de herramientas del chat y de nuevo al confirmar una escritura, por lo que desactivarlo elimina por completo la capacidad.

​

Estado de la conexión y desconexión

La tarjeta muestra la cuenta conectada y la URL del webhook opcional. Desconectar elimina la clave de API guardada y detiene la sincronización de llamadas nuevas. Elimina también el webhook de Retell 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 Retell.
• Agentes — cómo representa Zelto a cada agente.
• MCP — administra agentes y consulta tus datos desde el editor.
• Versiones de agentes — identidad del despliegue, configuración capturada y preparación de experimentos.