Saltar al contenido principal
Si ya usas un agente de programación con IA (Claude Code, Cursor, Codex o similar), puede hacer casi toda la configuración de Zelto por sí mismo. El camino más corto es una sola frase: install zelto.ai Con el prompt de abajo, el agente te guía al acceso web y a la autorización OAuth, conecta tu código para enviar conversaciones y comprueba que llegó la primera. Desde ahí puede seguir por el servidor MCP: crear un monitor, esperar el primer hallazgo y configurar la entrega. Esta página es a la vez el recorrido para una persona y el guion que sigue el agente (lee los mismos pasos con la herramienta read_docs).

El prompt mínimo

Desde la raíz del proyecto del agente de voz, dile a tu agente de programación:
El agente descubre esta guía desde https://zelto.ai/llms.txt y sigue https://dashboard.zelto.ai/skill.md. Primero inspecciona el proyecto y reutiliza ZELTO_API_KEY, los endpoints configurados o una conexión autenticada existente. No debe registrar otra cuenta ni exigir MCP si ya tiene una clave de API válida. Instala la integración donde termina cada conversación, envía una conversación sintética identificada como tal y lee su transcripción para verificarla. Un acuse de recepción no basta. Los hallazgos y monitores son pasos opcionales. Con credenciales existentes, puede completar el recorrido sin pasos manuales. Una cuenta nueva requiere verificar el email del titular y aceptar los Términos y la Política de Privacidad. El agente no debe eludir esos pasos ni inventar una identidad para crear la cuenta.

Llegá al primer resultado visible en Gratis

Una vez que llegue una conversación real, pedile a tu agente de código que lea la transcripción, proponga un problema con evidencia y sugiera una acción concreta. Si no encuentra un problema fundamentado, revisen otra conversación. Antes de publicar con create_finding, debe pedirte permiso y buscar hallazgos existentes para evitar duplicados. Después debe leerlo con get_finding y entregarte el enlace al hallazgo en la app. No requiere un monitor de pago. La guía /agent-setup.md del dashboard incluye este recorrido aunque la configuración ya esté completa. La pantalla de inicio conserva el prompt para copiar y el enlace a Hallazgos.

Registro mediante un enlace

El agente te entrega un enlace para iniciar sesión o registrarte. Elegís tus credenciales y verificás tu cuenta con el botón del correo. El agente nunca genera una contraseña ni te pide el código del email. El MCP público https://api.zelto.ai/mcp/signup expone start_signup con {}: solo devuelve los enlaces de acceso y la URL del MCP. Después conectás el cliente a https://api.zelto.ai/mcp mediante OAuth y autorizás el acceso en el navegador. Si abrís el enlace en otro navegador o para otra cuenta, Zelto muestra el correo y te pide confirmar antes de iniciar sesión.

Instala Zelto con una frase

Pega esto en tu agente de programación (Claude Code, Cursor, Codex, …) desde la raíz del proyecto que quieres observar:
Pega esto en tu agente de programación
El prompt está en inglés a propósito: los agentes y la documentación de referencia que lee están en inglés. Puedes pedirle al agente que te responda en español.

Acceso e integración

Completá el acceso y la autorización OAuth en el navegador. Para la ingesta desde el servidor, creá una clave en Configuración > Integraciones > Integración API y configurala directamente en tu archivo local de entorno o gestor de secretos. Nunca pegues claves en el chat. Seguí la guía de carga de conversaciones y continuá con el primer hallazgo.

Qué puede y qué no puede hacer el agente

  • Cuentas existentes. Iniciá sesión en el navegador, también con acceso social o MFA, y autorizá el MCP mediante OAuth. Las credenciales quedan con vos.
  • Sin atajos. El agente no omite la verificación ni aprueba el consentimiento por vos. Usá el botón del correo; no compartas códigos ni sesiones.
  • Planes. Las conversaciones, transcripciones y trazas funcionan en el plan Free. Los monitores están disponibles en todos los planes, incluido Free; se mantienen los costos y límites de uso. Los hallazgos aportados por tu propio agente son gratis: create_finding publica un hallazgo abierto, legible y visible inmediatamente en la app. Una organización Free puede tener tres agentes conectados; la conversación de un cuarto agente se rechaza con 403 connected_agent_limit. Consulta Planes.
  • Qué significa «instalar». El paquete oficial de npm para proyectos TypeScript es zelto-sdk. El envío de conversaciones requiere la versión 0.4.0 o posterior. Antes de instalar, consulta npm view zelto-sdk version: si 0.4.0 todavía no está publicada, usa la integración HTTP de esta guía. La versión 0.3.0 solo ofrece la API anterior de analítica web. Cuando esté disponible, ejecuta npm install zelto-sdk@^0.4.0 y usa Zelto.sendConversation en el servidor; consulta el ejemplo TypeScript de la guía de envío. Guarda la clave en variables de entorno exclusivas del servidor. MCP se conecta de forma remota sin paquete npm. «Install Zelto in this project» es una instrucción para el agente de programación, no un comando de terminal.

¿Ya tienes cuenta? Una línea desde Empezar

Si ya tienes una cuenta de Zelto, abre Empezar en el panel. Una organización nueva se abre en Configura Zelto con tu agente de código; si lo omites, la misma línea sigue en O deja que tu agente de código lo configure, debajo de los pasos. Cópiala en tu agente. Tiene este aspecto:
La guía de /agent-setup.md hace que el agente agregue el servidor MCP y se conecte con OAuth, así que la línea no contiene ninguna clave de API: inicias sesión una vez en el navegador y eliges la organización. Después el agente lee get_onboarding_status y recorre contigo el flujo de abajo: conecta tu plataforma de voz o conecta tu propio código a la API de ingesta, y te ofrece un primer monitor. Nunca se registra ni crea otra organización.

Antes de empezar (si ya tienes una clave)

Si ya generaste una clave en el panel, ve directo a conectar el servidor MCP:
  1. Ten una clave de API. En el panel está en Configuración → Integraciones → Integración por API y se muestra una sola vez al crearla.
  2. Conecta el servidor MCP de Zelto en tu editor con esa clave (consulta MCP para la configuración de cada cliente). Confirma con la herramienta health (devuelve el id de tu organización).
Todo lo que sigue usa las herramientas de incorporación de esa conexión.

El flujo

1

Comprueba dónde estás

El agente llama primero a get_onboarding_status. Devuelve los pasos de configuración ordenados (connectCalls: llegan conversaciones, importAgent: existe un agente, createMonitor), cada uno con un indicador done, más nextIncomplete y monitorsAvailable. Repetir la incorporación es seguro: el agente retoma desde el primer paso incompleto. Si ya enviaste conversaciones con la integración, los dos primeros pasos ya están hechos.
2

Conectar un proveedor

El agente consulta list_integrations y llama a connect_provider con el proveedor y una etiqueta opcional. Recibes un enlace válido durante 15 minutos: ábrelo como propietario o administrador e introduce tu clave directamente en Zelto. No la pegues en el chat. El agente confirma que se guardó con check_provider_connection y continúa con la importación de agentes.Para claves de proveedores de IA o transcripción, usa connect_ai_provider y la misma comprobación. Los endpoints personalizados también solicitan la URL y los modelos en la web; su validación hace una pequeña llamada de pago por modelo. Las instrucciones opcionales de webhook están en Configuración → Integraciones.
3

Hacer que las conversaciones fluyan

Las conversaciones llegan una vez que se pega el webhook (o se ejecuta la sincronización horaria para los proveedores basados en pull). list_conversations En una primera conversación, Zelto crea el primer contacto. agente automáticamente. Si ya tienes historial en una cuenta de Retell conectada, el agente puede importarlo con retell_import_agent y retell_import_conversations en lugar de esperar.Si la integración va a ejecutar experimentos, consulta también Versiones de agentes. LiveKit y cargas propias deben indicar version en cada conversación. Verifica dos etiquetas de despliegue bajo el mismo agente antes de configurar la comparación.
4

Crear un monitor

A monitor es un juez de IA que se ejecuta contra cada conversación y marca las que coinciden con una rúbrica. Los monitores están disponibles en todos los planes; estima los costos de uso antes de crear uno. El agente ofrece el catálogo listo para usar de list_starter_monitors (negaciones, fallos de tareas, frustración del usuario y más), luego conversaciones create_monitor con un starterKeyO con un name y un sí/no en lenguaje sencillo instruction de su propio. Se confirma con list_monitors.
5

Espera el primer Hallazgo

A medida que las conversaciones fluyen a través del monitor, Zelto se hallazgos problemas duraderos a nivel de organización agrupados a partir de las conversaciones que coinciden. list_findings hasta que aparezca el primero. El agente también puede crear un hallazgo con create_finding (basta una description en texto plano); se publica abierto y visible inmediatamente, también en Gratis.
6

Ruta hallazgos a tu equipo

Finalmente, el agente llama set_findings_delivery con el channels Quieres email y/o slack. Slack también necesita la aplicación de Slack conectada a través de OAuth bajo Configuración → Integraciones, que el agente marcará para que usted haga.

Utilice su agente de codificación

Pega la siguiente indicación en el agente de codificación de tu editor. Carga el zelto-onboarding habilidad si su cliente apoya las habilidades de los agentes antrópicos, o vuelve a leer esta página a través de read_docs de cualquier manera sigue el flujo anterior y hace una pausa para los pasos que solo usted puede hacer.
Paste into your coding agent

Instalar la habilidad

Tres formas de darle a tu agente la habilidad, primero la fricción más baja:
  1. Zero-install (funciona con cualquier cliente MCP). Cada editor conectado ya tiene el read_docs herramienta el mensaje de pegado anterior le dice al agente que read_docs('onboarding-with-an-agent') y síguelo. Esto siempre refleja la versión en vivo de esta página. Recomendado.
  2. Copia la carpeta de habilidades (Claude Code y otros clientes con capacidad de habilidades). Suelte el zelto-onboarding carpeta de habilidades en el directorio de habilidades de su agente (para Claude Code, .claude/skills/). La habilidad SKILL.md más su references/ archivos conducen el mismo flujo con detalle progresivo.
  3. referencia en línea. Apunta el agente a la URL de esta página en tu propio mensaje; read_docs versión actual a pedido.

Relacionado

¿Un error de la API o una capacidad faltante bloquea tu tarea? Enviá feedback con tu API key habitual.