> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zelto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Retell

> Conecta una cuenta de Retell y sincroniza sus llamadas con Zelto.

## 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.

| Evento de Retell | Se convierte en |
| - | - |
| `call_ended` | La llamada finalizada: transcripción, grabación, costo y motivo de finalización. |
| `call_analyzed` | El procesamiento posterior de Retell: `call_analysis` (resumen, sentimiento, éxito y tus campos de `custom_analysis_data`), fusionado en los metadatos de la llamada. |

Las grabaciones se guardan en el almacenamiento de Zelto para que el reproductor
de la página de detalles de la [conversación](/es/docs/conversations) 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](/es/docs/conversations#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](/es/docs/monitors#filtrar-por-metadatos-de-la-llamada).

## 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](/es/docs/conversations).
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](/es/docs/guides/connect-a-voice-provider#diagnosticar-una-llamada-ausente).

## 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](/es/docs/guides/connect-a-voice-provider) — elige un método y verifica la ingestión.

* [Conversaciones](/es/docs/conversations) — dónde aparecen las llamadas de Retell.

* [Agentes](/es/docs/agents) — cómo representa Zelto a cada agente.

* [MCP](/es/docs/mcp) — administra agentes y consulta tus datos desde el editor.

* [Versiones de agentes](/es/docs/agent-versions) — identidad del despliegue, configuración capturada y preparación de experimentos.