Documentación
API de la plataforma.md

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).
Esc