API de llamadas de voz

Crea y controla llamadas de voz en tiempo real y configura tus agentes de voz VPower por API.

Con la API de llamadas de voz haces que tus agentes llamen y atiendan en tiempo real desde tu sistema: inicias llamadas telefónicas y web, las consultas o detienes, y configuras a fondo tus agentes de voz (prompt, modelo, funciones, voz y números). Funciona con VPower, el motor de voz de Anunzi.

Es parte de la API de Anunzi: usa la misma API Key que la API de plataforma.

---

URL base y autenticación

https://calls.anunzi.net

Authorization: Bearer anz_live_TU_API_KEY

Genera tu API Key desde el menú de tu usuario → API Keys (ver API Keys de cuenta). Cada operación queda limitada a los agentes de tu cuenta (y a los de tus clientes, si eres partner).

---

Llamadas

Método	Ruta	Descripción
POST	/v2/create-phone-call	Inicia una llamada telefónica
POST	/v3/create-web-call	Crea una llamada web (desde el navegador o tu app)
GET	/v2/get-call/{call_id}	Obtiene el detalle de una llamada
POST	/v3/list-calls	Lista llamadas con filtros y paginación
PATCH	/v2/update-call/{call_id}	Actualiza los metadatos de una llamada
POST	/v2/stop-call/{call_id}	Detiene una llamada en curso
DELETE	/v2/delete-call/{call_id}	Elimina el registro de una llamada

Agentes de voz

Método	Ruta	Descripción
GET	/list-agents	Lista tus agentes de voz
GET	/get-agent/{agent_id}	Obtiene la configuración completa de un agente
PATCH	/update-agent/{agent_id}	Cambia voz, idioma, comportamiento, extractores…
POST	/publish-agent/{agent_id}	Pone en uso los cambios
GET	/get-agent-versions/{agent_id}	Historial de versiones
GET	/get-agent-llm/{llm_id}	Prompt, mensaje inicial, modelo y funciones
PATCH	/update-agent-llm/{llm_id}	Cambia prompt, mensaje inicial, modelo y funciones
GET	/list-voices	Voces disponibles
GET	/get-voice/{voice_id}	Una voz
GET	/list-phone-numbers	Números de tu cuenta

Los cambios de configuración van a un borrador: el agente sigue atendiendo con la versión publicada hasta que llamas a publish-agent.

Para contactos, campañas, mensajes, créditos y webhooks, usa la API de plataforma.

---

Motor de voz anterior (deprecado)

Todos los agentes nuevos se crean en VPower y los existentes se van pasando sin cambiar su agent_id, sus números ni estas rutas.

• Mientras un agente siga en el motor anterior, las llamadas funcionan igual, pero las rutas de agentes de voz responden 409 con "code": "agent_not_migrated".

• Si tu integración usa llamadas web, revisa la guía de migración a VPower: con el SDK de Anunzi no tienes que cambiar nada.

---

Códigos de error

Código	Descripción
400	Solicitud inválida (la respuesta indica qué campo).
401	API Key ausente o inválida.
402	Sin créditos o período de prueba vencido.
403	El agente o la llamada no pertenecen a tu cuenta.
404 / 422	El recurso no existe bajo tu API Key.
409	Agente todavía en el motor anterior (agent_not_migrated) o sin cambios para publicar.
429	Límite de solicitudes, o todas las líneas simultáneas de tu plan en uso (concurrency_limit).
500	Error interno.

💡 Para hacer muchas llamadas en paralelo, revisa las líneas simultáneas de tu plan en Suscripción. Para llamar a una lista de contactos, una campaña gestiona los reintentos y el ritmo por ti.