Crea un agente de voz, llama a tus contactos y recibe el resultado por API o webhook. También puedes probarlo desde el panel de llamadas.
Una llamada simultánea es una conversación activa al mismo tiempo que otra. El límite está incluido en el plan; no se cobra una cuota adicional por cada una.
| Plan | Mensual + IVA | Minutos | A la vez |
|---|---|---|---|
| Esencial | $499 MXN | 250 | 2 |
| Crece | $1,499 MXN | 750 | 5 |
| Pro | $3,999 MXN | 2,000 | 10 |
Cada llamada contestada consume minutos por separado, redondeados por llamada al minuto completo. Los paquetes de minutos adicionales no aumentan el límite de simultáneas. Para pasar de 2 a 5, cambia a Crece (+$1,000 MXN al mes); para pasar de 5 a 10, cambia a Pro (+$2,500 MXN al mes). Diferencias más IVA e incluyen también más minutos y estados. Ver planes y paquetes.
GET /voice/terms y acepta la versión vigente con POST /voice/terms/accept y { "version": "…" }.POST /voice/agents, enviando name, prompt y firstMessage.POST /voice/calls: envía agentId, to en formato +52, purpose y consent.source.GET /voice/calls/:id o recibe el evento call.ended en tu webhook.Si alcanzas el límite, una nueva llamada saliente devuelve 429 voz_simultaneas; espera a que termine una antes de reintentar. Una llamada entrante también se rechaza si el límite está ocupado. Sin minutos disponibles la API devuelve 402 voz_sin_minutos. Consulta tu saldo y límite con GET /billing/llamadas.
Antes de llamar revisa las condiciones de consentimiento, el propósito, horarios y números permitidos. Consulta cuerpos completos, números propios, recepción de llamadas, errores y eventos en la sección «Llamadas con IA (voz)» de llms.txt y los términos de llamadas.
outsideHours, hasta 3 al día por cuenta.429 voz_destino_tope. Si pruebas seguido con tu celular, escribe a soporte@zoosial.com y lo dejamos como número de prueba de tu cuenta.maxWordsPerTurn en 50–60 (descarta frases enteras en vez de cortar a media frase), lo largo en knowledge y dicho por partes, y revisa metrics.turnos[].finishReason: cada "length" es una respuesta cortada.tools, hasta 3: nombre, descripción, parámetros simples, una url https y pública, timeoutMs de 500 a 2500 ms y una frase de espera opcional). Al guardar la primera recibes toolsSecret, solo esa vez. Cada petición llega firmada: X-Zoosial-Signature: sha256=… es el HMAC-SHA256 de "timestamp.cuerpo crudo", con el timestamp en X-Zoosial-Timestamp; verifícala y rechaza timestamps de más de 5 minutos. Contesta 2xx con un objeto JSON (hasta 4 KB) con las horas ya dichas en voz alta; si tu servidor falla o tarda, el agente recibe {"error":"sin_respuesta"} y nunca se reintenta solo. Usa X-Zoosial-Idempotency-Key para que apartar algo dos veces no lo duplique, prueba sin llamar con POST /voice/agents/:id/tools/:name/test y mira metrics.herramientas en cada llamada. Con reglas propias, escribe en tu prompt cuándo usar cada herramienta.keyterms en el agente (hasta 20) hace que la transcripción reconozca mejor el nombre de tu empresa, productos y siglas como «IA». Tiene costo extra: 1 minuto más por cada 40 minutos acumulados de llamadas con keyterms (sale en billedMinutes de la llamada que cruza los 40).POST /voice/calls acepta "stt": "flux" o "stt": "nova-3" para elegir el modelo solo en esa llamada (sin el campo, va el de la cuenta); metrics.stt dice cuál corrió. Flux cierra el turno antes y no da eventos vacíos, pero oye peor las respuestas muy cortas y los nombres; Nova-3 es más precisa y cierra con endOfSpeechMs.endOfSpeechMs es el silencio que cierra el turno de la persona (el defecto es 300 ms). En nuestras pruebas por línea telefónica cerró en ~1.1–1.2 s con 300 ms y entre 1.4 y 3.3 s con 600 ms; las respuestas de una sola palabra («sí», «ajá») tardan más con cualquier valor (2.7–4.7 s). Empieza en 300–400 y sube solo si cortan a quien piensa.metrics.errores de la llamada.recording: false en el agente; para quitar una grabación antes, DELETE /voice/calls/:id/recording (borra el audio; la transcripción y el análisis se quedan y no se puede deshacer).