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

# Vapi

> Conecta una cuenta Vapi con una clave de API y extrae cada llamada a Zelto.

## Conectar

1. Abre **Primeros pasos → Vapi** o **Configuración → Integraciones → Vapi** y haz
   clic en **Conectar Vapi**.
2. Pega tu clave de API de Vapi. La encontrarás en
   [dashboard.vapi.ai](https://dashboard.vapi.ai), en **Claves de API**. Zelto la
   utiliza para obtener los metadatos y las grabaciones de los asistentes.
3. Importa un asistente. Zelto comenzará a sincronizar sus llamadas
   automáticamente.

Para recibir las llamadas con menor latencia, abre la integración en
**Configuración** y copia en Vapi la **URL del webhook** opcional. También hay
disponible una URL gestionada por Hookdeck, que ofrece reintentos y reproducción
de entregas adicionales.

Puedes conectar varias cuentas de Vapi a una misma organización. Las llamadas de
todas las cuentas aparecen en el mismo lugar, identificadas con el
[agente](/es/docs/agents) de origen.

## Lo que se ingiere

Zelto sincroniza periódicamente las llamadas de cada asistente de Vapi importado.
El webhook opcional **`end-of-call-report`** puede enviar cada llamada finalizada
antes; ambos métodos eliminan duplicados mediante el identificador de llamada de
Vapi. Zelto crea la [conversación](/es/docs/conversations) con la transcripción
turno a turno, la grabación, el costo y el motivo de finalización. Los demás tipos
de eventos del webhook se reconocen y se ignoran.

Vapi devuelve una URL de grabación que se mantiene válida, por lo que Zelto la
guarda tal cual. El reproductor de la página de detalles de la conversación sigue
funcionando sin tener que volver a alojar el audio.

Zelto también captura las **invocaciones de herramientas** del agente: las funciones
que ejecuta durante una llamada, a partir de los mensajes `tool_calls` y
`tool_call_result` de Vapi, 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.

## Trazas, sin instrumentalizar nada

Cuando Zelto sincroniza una llamada de Vapi, también descarga sus **registros de
plataforma** y los convierte en una [traza](/es/docs/traces). Así, las llamadas de
Vapi aparecen en **Trazas** sin instalar un exportador de OpenTelemetry ni
modificar el código del agente.

Cada llamada se convierte en una traza cuya raíz es la propia llamada, con un
span por turno y, anidados debajo, los pasos del proveedor ejecutados durante ese
turno:

* Spans **`llm`** con el modelo, el prompt y la respuesta, los recuentos de tokens
  de entrada y salida, y el costo calculado por Vapi. También incluyen las
  solicitudes posteriores a la llamada de **resumen** y **evaluación de éxito**,
  cuyo costo no suele ser visible.
* Spans **`stt`** con el proveedor de transcripción, el modelo y la transcripción
  final.
* Spans **`tts`** y **`vad`** para las etapas de voz y detección de turnos.
* Cada línea de registro emitida por Vapi, vinculada al span correspondiente,
  incluidos los desgloses de latencia por turno (detección del final, primer token
  y primer audio).

La traza utiliza el identificador de llamada de Vapi, por lo que enlaza
directamente con su [conversación](/es/docs/conversations). Si una llamada vuelve
a sincronizarse, Zelto actualiza la misma traza en lugar de duplicarla.

Conviene tener en cuenta dos límites: Vapi solo conserva los registros durante
un periodo limitado, así que una importación histórica de llamadas mucho más
antiguas puede crear conversaciones sin trazas; además, Zelto conserva las trazas
durante 90 días y no solicita registros de llamadas anteriores a ese periodo.

## Verificar la primera llamada

Haz una llamada de prueba a tu asistente de Vapi 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 Vapi desde el chat

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

* **list\_vapi\_assistants** — consulta todos los asistentes de tu cuenta.
* **get\_vapi\_assistant** — obtiene un asistente con su primer mensaje y prompt del
  sistema actuales.
* **list\_vapi\_calls** — consulta las llamadas recientes, opcionalmente de un solo
  asistente, para revisar su rendimiento.
* **list\_vapi\_evals** — consulta las evaluaciones con conversaciones simuladas de
  tu cuenta.
* **update\_vapi\_assistant** — cambia `name`, `firstMessage` o `systemPrompt` de un
  asistente existente.
* **create\_vapi\_assistant** — crea un asistente con nombre, primer mensaje y prompt
  del sistema.
* **create\_vapi\_eval** — crea una evaluación con una conversación simulada para
  puntuar un asistente.

Las lecturas se ejecutan en cuanto las solicitas. Las escrituras (`update_*` y
`create_*`) pasan por una tarjeta de confirmación: no se envía nada a Vapi 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 → Vapi →
Administrar):

* **Todos** (predeterminado) — cualquier miembro puede utilizar Vapi desde el chat.
* **Administradores y propietarios** — solo propietarios, administradores y
  administradores globales.
* **Desactivado** — las herramientas de Vapi 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, la fecha de conexión y la URL del webhook
opcional. **Desconectar** elimina la clave de API guardada y detiene la
sincronización de llamadas nuevas; las conversaciones históricas permanecen en
la organización. Elimina también el webhook de Vapi para detener el envío desde
su plataforma.

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

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

* [MCP](/es/docs/mcp) — administra asistentes 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.
