# 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)](../../api-calls/README.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.