Vapi

​

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, 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 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 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 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. 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. 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. 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 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 — elige un método y verifica la ingestión.
• Conversaciones — dónde aparecen las llamadas de Vapi.
• Agentes — cómo representa Zelto a cada asistente.
• MCP — administra asistentes y consulta tus datos desde el editor.
• Versiones de agentes — identidad del despliegue, configuración capturada y preparación de experimentos.