# Listar llamadas

> plazbot calls list: llamadas telefónicas (VoIP) del workspace o de un contacto, con duración y grabación.

Fuente: https://developers.plazbot.com/cli/calls/list/

### Listar llamadas

Muestra las llamadas telefónicas (VoIP) del workspace, de la más reciente a la más antigua: dirección, contacto, agente, duración y si tiene grabación. Con `-c` muestra solo las llamadas de un contacto.

```bash
plazbot calls list [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Contacto | `-c, --contact <contactId>` | No | Solo las llamadas de un contacto. En este modo no hay paginación. |
| Vista | `--view <viewId>` | No | Aplica los filtros de una vista guardada. |
| Límite | `--limit <n>` | No | Se detiene al juntar al menos N llamadas (páginas completas de la API). Por defecto `50`. |
| Cursor | `--cursor <token>` | No | Continúa desde el `nextCursor` de una llamada anterior. |
| Todo | `--all` | No | Trae todas las páginas, hasta 5000 llamadas (ignora `--limit`). |
| Workspace | `-w, --workspace <id>` | No | Workspace donde se ejecuta. Por defecto, el activo. |
| Zona | `-z, --zone <zone>` | No | `LA` o `EU`. Por defecto, la zona de la sesión. |
| JSON | `--json` | No | Imprime el resultado como JSON. |

Con `--json` la salida es `{ "data": [...], "nextCursor": "..." | null }`. Más detalles en [Scripting y agentes de IA](https://developers.plazbot.com/cli/ia/scripting).

### Ejemplos

```bash
# Últimas llamadas
plazbot calls list

# Llamadas de un contacto, con la URL de la grabación
plazbot calls list -c con_AbcDef123 --json | jq -r '.data[] | [.creationDate, .urlCallRecording] | @tsv'
```

### Resultado

```text
Calls (1)
────────────────────────────────────────
┌──────────────────┬───────────┬───────────┬─────────────┬──────────────┬──────────┬───────────┐
│ Date (UTC)       │ Direction │ Contact   │ Number      │ Agent        │ Talk (s) │ Recording │
├──────────────────┼───────────┼───────────┼─────────────┼──────────────┼──────────┼───────────┤
│ 2026-09-29 17:01 │ incoming  │ Ana Pérez │ 51912345678 │ Carlos Ruiz  │ 94       │ yes       │
└──────────────────┴───────────┴───────────┴─────────────┴──────────────┴──────────┴───────────┘
```

| Columna | Descripción |
|---------|-------------|
| Date (UTC) | Fecha de la llamada. |
| Direction | `incoming` (entrante) u `outgoing` (saliente). |
| Contact | Nombre del contacto. |
| Number | Número del contacto. |
| Agent | Agente que atendió o hizo la llamada. |
| Talk (s) | Segundos de conversación. |
| Recording | `yes` si hay grabación. La URL viene en `urlCallRecording` del JSON. |

### Salida JSON

```json
{
"data": [
  {
    "id": "cal_AbcDef123",
    "contactId": "con_AbcDef123",
    "internalWhatsappNumber": "51912345678",
    "contactName": "Ana",
    "contactlastname": "Pérez",
    "direction": "incoming",
    "duration": 110,
    "talkDuration": 94,
    "userCallerId": "usr_AbcDef123",
    "userCallerName": "Carlos",
    "userCallerLastname": "Ruiz",
    "voipExtension": "101",
    "urlCallRecording": "https://...",
    "creationDate": "2026-09-29T17:01:00Z"
  }
],
"nextCursor": null
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |