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

01plazbot 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.

Ejemplos

bash

01# Últimas llamadas
02plazbot calls list
03 
04# Llamadas de un contacto, con la URL de la grabación
05plazbot calls list -c con_AbcDef123 --json | jq -r '.data[] | [.creationDate, .urlCallRecording] | @tsv'

Resultado

text

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

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

01{
02  "data": [
03    {
04      "id": "cal_AbcDef123",
05      "contactId": "con_AbcDef123",
06      "internalWhatsappNumber": "51912345678",
07      "contactName": "Ana",
08      "contactlastname": "Pérez",
09      "direction": "incoming",
10      "duration": 110,
11      "talkDuration": 94,
12      "userCallerId": "usr_AbcDef123",
13      "userCallerName": "Carlos",
14      "userCallerLastname": "Ruiz",
15      "voipExtension": "101",
16      "urlCallRecording": "https://...",
17      "creationDate": "2026-09-29T17:01:00Z"
18    }
19  ],
20  "nextCursor": null
21}

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.