Documentación
API de Anunzi.md

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.

Esc