> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-docs/api-widgets/consultar-llamadas.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
```

***

## 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:

```json
{
  "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

```bash
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.