API de plataforma v1
La API de plataforma v1 está organizada por módulos, cada uno con sus operaciones. Con una sola credencial —tu API Key de cuenta— trabajás con contactos, agentes, llamadas, mensajería, campañas, créditos y webhooks.
Base URL y versión
https://panel.anunzi.net/api/v1/<módulo>/<acción>.php
La versión v1 garantiza estabilidad: si en el futuro cambian los contratos, saldrá una v2 sin romper tus integraciones.
Autenticación
Todas las solicitudes llevan tu API Key de cuenta en el encabezado:
Authorization: Bearer anz_live_TU_API_KEY
Cada operación queda limitada automáticamente a tu cuenta (y a la de tus clientes, si sos partner). Ver API Keys de cuenta.
Formato de respuesta
Todas las respuestas son JSON con esta forma:
{ "ok": true, "data": … , "paging": { "limit": 50, "offset": 0, "total": 120 } }
En caso de error:
{ "ok": false, "error": "Mensaje legible", "code": "codigo_maquina" }
El código HTTP refleja el resultado real: 200 OK · 400 datos inválidos · 401 sin credencial · 402 sin créditos · 403 fuera de alcance · 404 no encontrado · 429 límite de tasa · 500 error del servidor.
Paginación
Los listados aceptan ?limit= (por defecto 50, máx. 200) y ?offset=. La respuesta incluye paging con el total.
Módulos
| Módulo | Para qué |
|---|---|
| Contactos | Crear, actualizar, listar, importar contactos y notas. |
| Agentes | Listar y configurar agentes, activar/pausar. |
| Llamadas | Listar (nivel cuenta), ver detalle con auditoría y disparar llamadas. |
| Mensajería | Enviar mensajes de WhatsApp (texto o plantilla). |
| Campañas | Crear campañas salientes, cargar contactos, activar y ver stats. |
| Créditos | Saldo, movimientos y (partner) asignar/recuperar créditos a clientes. |
| Webhooks | Suscribirte a eventos (lead nuevo, ticket, llamada finalizada). |