# 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://api.anunzi.com/v1/calls
```

### 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://api.anunzi.com/v1/calls?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

Para acceder a la transcripción completa de una llamada específica:

```
GET https://api.anunzi.com/v1/calls/{call_id}/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://api.anunzi.com/v1/calls?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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.anunzi.net/api-widgets/consultar-llamadas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.