Introducción
Referencia de la API de Anunzi - una sola API Key para operar tu cuenta, tus agentes y tus llamadas de voz con el motor VPower.
Con la API de Anunzi integras tu cuenta con tus sistemas: CRM, ERP, formularios, automatizaciones (Zapier, Make, n8n) o tu propio software. Una sola API Key te da acceso a todo lo que haces desde el panel: contactos, agentes, llamadas, mensajes, campañas, créditos y webhooks.
Empieza en 3 pasos
Genera tu API Key desde el panel: menú de tu usuario → API Keys. Más detalle en API Keys de cuenta.
Envíala en cada solicitud, en el encabezado:
Authorization: Bearer anz_live_TU_API_KEYElige el módulo que necesitas en la tabla de abajo.
Cada operación queda limitada automáticamente a tu cuenta (y a las de tus clientes, si eres partner): no puedes ver ni modificar datos de otras cuentas.
Qué puedes hacer
La API se organiza en dos partes, con la misma API Key:
https://panel.anunzi.net/api/v1/…
Contactos, agentes, historial de llamadas con auditoría, WhatsApp, campañas, créditos y webhooks.
https://calls.anunzi.net/…
Llamar en tiempo real: crear llamadas telefónicas y web, controlarlas, y configurar a fondo tus agentes de voz (prompt, modelo, funciones, voz).
¿Cuál uso?
Crear o actualizar contactos, importar una lista, agregar notas
Que mi agente llame a alguien ahora mismo
Poner un botón "hablar con el agente" en mi web o app
Lanzar una campaña de llamadas o WhatsApp a muchos contactos
Enviar un WhatsApp (texto o plantilla)
Ver el historial de llamadas con resumen, datos extraídos y auditoría
Consultar el estado de una llamada puntual (en curso o terminada)
Cambiar el prompt, el modelo, las funciones o la voz de un agente de voz
Activar o pausar un agente
Recibir un aviso cuando termina una llamada o entra un contacto nuevo
Ver mi saldo o (partner) asignar créditos a un cliente
Motor de voz VPower
Las llamadas de voz funcionan con VPower, el motor de voz de Anunzi. Todos los agentes nuevos se crean en VPower y los existentes se van pasando sin cambiar su agent_id, sus números ni las rutas de la API.
⚠️ El motor de voz anterior está deprecado. Sus agentes siguen funcionando mientras terminamos el pase, pero las funciones nuevas de la API (gestión de agentes, prompt, modelo, funciones, voces) solo están disponibles en VPower. Si tu integración usa llamadas web, revisa la guía de migración a VPower.
Convenciones
Formato: las solicitudes y respuestas son JSON (UTF-8).
Errores: el código HTTP refleja el resultado:
400datos inválidos ·401API Key ausente o inválida ·402sin créditos o prueba vencida ·403fuera del alcance de tu cuenta ·404no encontrado ·409conflicto (por ejemplo, un agente que todavía no está en VPower) ·429límite de solicitudes o de líneas simultáneas ·500error del servidor.Llamadas simultáneas: cada plan tiene un límite de líneas en uso a la vez; si lo superas, la API responde
429. Ver Suscripción.Créditos: las llamadas, mensajes y campañas que lanzas por API consumen créditos igual que desde el panel. Ver Créditos.
Webhooks y eventos
Además de consultar la API, puedes recibir eventos en tu servidor:
Webhooks de la plataforma (contacto nuevo, ticket, llamada finalizada): Plataforma → Webhooks.
Webhook por agente de voz (inicio, fin y análisis de cada llamada, a elección): se configura en la ficha del agente. Ver Ficha del agente.
Funciones de tu agente que llaman a tu API durante la conversación: Funciones webhook y Funciones de código.
Partners
Si eres partner, tu API Key alcanza también las cuentas de tus clientes: puedes operar sus agentes, contactos y llamadas, y asignarles créditos desde Plataforma → Créditos.
Endpoints anteriores
Los endpoints autenticados con el token de cada agente siguen funcionando pero están deprecados: Endpoints por token de agente (legacy).
Última actualización