Documentación
API de Anunzi.md

Llamadas

Consulta y dispara llamadas a nivel de toda la cuenta, por teléfono o por WhatsApp. Base: https://panel.anunzi.net/api/v1/calls/.

Método Ruta Descripción
GET list.php Lista llamadas de todos los agentes de la cuenta, con filtros.
GET get.php?id= Detalle de una llamada (transcripción, grabación, auditoría IA).
POST create.php Dispara una llamada saliente, por teléfono o por WhatsApp.
GET whatsapp-permission.php Consulta si un contacto dio permiso para que lo llamen por WhatsApp.
POST whatsapp-permission.php Le pide permiso a un contacto para llamarlo por WhatsApp.

Esta es la vista de plataforma (multi-agente, con auditoría). La API de bajo nivel para crear/controlar llamadas está en API de llamadas (voz).


Listar

GET /api/v1/calls/list.php — filtros: agent, from (YYYY-MM-DD), to, status, score_band (good|mid|bad|ne|none), sentiment (positivo|neutral|negativo), más limit/offset.

curl "https://panel.anunzi.net/api/v1/calls/list.php?from=2026-09-01&score_band=bad" \
  -H "Authorization: Bearer anz_live_TU_API_KEY"

Cada ítem incluye audit con el puntaje (/5), si es no evaluable y el sentimiento, y channel: whatsapp si fue una llamada de WhatsApp o phone en el resto.

Detalle

GET /api/v1/calls/get.php?id=CALL_ID — devuelve transcripción, grabación, motivo de finalización, canal (channel: whatsapp o phone) y la auditoría IA completa (puntaje, precisión, alucinación, comentario).

Disparar una llamada

POST /api/v1/calls/create.php

{ "to_number": "+12137774445", "from_number": "+14157774444", "agent_id": "agent_…" }
  • to_number es obligatorio.
  • from_number puede omitirse si el agent_id tiene número asignado.
  • Opcionales: metadata, dynamic_variables y channel (ver abajo).

El costo de la llamada se cobra cuando finaliza (flujo normal). El número de origen debe pertenecer a tu cuenta.

La respuesta incluye call_id y channel, el canal por el que salió la llamada (phone o whatsapp).


Llamar por WhatsApp

La forma recomendada de llamar por WhatsApp desde tu sistema está en la API de llamadas de voz: Crear llamada de WhatsApp y Permiso para llamar por WhatsApp.

Desde esta API también puedes hacerlo:

  • create.php con "channel": "whatsapp" (solo WhatsApp) o "whatsapp_first" (WhatsApp si dio permiso, si no por teléfono), con agent_id del agente de voz. Opcional: whatsapp_number.
  • GET whatsapp-permission.php?agent_id=…&phone=… consulta el permiso y POST whatsapp-permission.php con { "agent_id", "phone", "text" } lo pide.

Los errores (no_call_permission, no_whatsapp_line, number_cannot_call, whatsapp_call_limit, permission_request_limit) y los costos son los mismos que en la API de llamadas de voz.

Esc