API de plataforma

La API de plataforma v1 está organizada por módulos, cada uno con sus operaciones. Con una sola credencial —tu API Key de cuenta— trabajas 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 eres 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).