Documentación
API de la plataforma.md

Consultar llamadas del sistema

Anunzi ofrece un endpoint para consultar el historial de llamadas de un agente directamente desde tu sistema o herramienta de análisis, sin necesidad de usar el panel web.

¿Para qué sirve?

Este endpoint es útil cuando quieres:

  • Exportar automáticamente los registros de llamadas a tu CRM o base de datos.
  • Analizar llamadas desde una herramienta externa (Excel, Power BI, scripts propios, etc.).
  • Integrar los resultados de llamadas con flujos de Make o Zapier.
  • Auditar el historial de un agente de forma programática.

Obtener el token del agente

Cada agente tiene su propio API Token, que autoriza el acceso a sus datos. Para obtenerlo:

  1. Ve a Agentes de Llamada en el menú lateral.
  2. Selecciona el agente cuyas llamadas quieres consultar.
  3. En la sección Resumen, encontrarás el API Token del agente.
  4. Cópialo para usarlo en tus solicitudes.

🔒 Trata el token como una contraseña. No lo compartas públicamente ni lo incluyas en código que suba a repositorios públicos.

Endpoint

GET https://panel.anunzi.net/api/calls.php

Encabezados requeridos

Authorization: Bearer TU_TOKEN_DE_AGENTE
Content-Type: application/json

También podés usar tu API Key de cuenta (anz_live_…, ver API Keys de cuenta). En ese caso, como este endpoint consulta las llamadas de un agente, indicá cuál con el parámetro ?agent=<assistant_id> (debe ser un agente de tu cuenta).

Parámetros de consulta (opcionales)

Puedes filtrar los resultados con los siguientes parámetros en la URL:

Parámetro Tipo Descripción
from fecha (YYYY-MM-DD) Fecha de inicio del período.
to fecha (YYYY-MM-DD) Fecha de fin del período.
phone texto Filtra por número de teléfono del contacto.
campaign_id texto Filtra por campaña saliente.
limit número Cantidad máxima de resultados por página (por defecto: 50).
offset número Punto de inicio para la paginación.

Ejemplo de solicitud

GET https://panel.anunzi.net/api/calls.php?from=2025-01-01&to=2025-01-31&limit=100
Authorization: Bearer abc123...

Respuesta

La respuesta es un JSON con la lista de llamadas y sus datos:

{
  "total": 142,
  "calls": [
    {
      "id": "call_abc123",
      "phone": "+5491123456789",
      "contact_name": "María López",
      "started_at": "2025-01-15T10:32:00Z",
      "duration_seconds": 187,
      "outcome": "completed",
      "campaign_id": "camp_xyz",
      "transcript_available": true,
      "custom_fields": {
        "interes": "alto",
        "zona": "Palermo"
      }
    }
  ]
}

Obtener la transcripción de una llamada

La transcripción se devuelve como un campo (transcript) dentro de la respuesta estándar. Para obtenerla, busca por el ID de la llamada:

GET https://panel.anunzi.net/api/calls.php?search_field=call_id&search_value={call_id}&fields=transcript
Authorization: Bearer TU_TOKEN_DE_AGENTE

Reemplaza {call_id} con el ID de la llamada que quieres consultar.

Herramientas recomendadas para probar

Si quieres explorar el endpoint antes de integrarlo, puedes usar:

  • Postman — interfaz visual para hacer solicitudes HTTP.
  • curl — herramienta de línea de comandos disponible en cualquier sistema.

Ejemplo con curl

curl -X GET "https://panel.anunzi.net/api/calls.php?from=2025-01-01&limit=10" \
  -H "Authorization: Bearer TU_TOKEN_AQUÍ"

💡 Si usas Make o Zapier, puedes conectar este endpoint como un módulo HTTP personalizado y desencadenar acciones automáticas cada vez que se complete una llamada, como actualizar un contacto en tu CRM o enviar una notificación a tu equipo.

Esc