> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/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-ia-documentation/api-de-la-plataforma/calls.md).

# Llamadas

Consultá y dispará llamadas a nivel de toda la cuenta. 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 telefónica saliente.                         |

> 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)](/anunzi-ia-documentation/api-de-llamadas-voz/api-calls.md).

***

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

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

## Detalle

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

## Disparar una llamada

`POST /api/v1/calls/create.php`

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

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