Listar campañas

Muestra las campañas de WhatsApp (envíos masivos de plantillas), de la más reciente a la más antigua, con su estado y cuántos mensajes se enviaron y fallaron. También funciona como plazbot campaign list.

bash

01plazbot campaigns list [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Búsqueda	`-s, --search <text>`	No	Filtra por nombre de la campaña.
Estado	`--status <status>`	No	`pending`, `scheduled`, `sending`, `complete`, `error` o `canceled`.
Límite	`--limit <n>`	No	Se detiene al llegar a N campañas (páginas completas). Por defecto `20`.
Cursor	`--cursor <token>`	No	Continúa desde el `nextCursor` de una llamada anterior.
Todas	`--all`	No	Trae todas las páginas, hasta 5000 campañas.
Workspace	`-w, --workspace <id>`	No	Workspace a consultar. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona activa.
JSON	`--json`	No	Imprime `{ "data": [...], "nextCursor": ... }`.

Paginación y JSON: ver Scripting y agentes de IA.

Ejemplos

bash

01# Últimas campañas
02plazbot campaigns list
03 
04# Campañas que siguen enviando, en JSON
05plazbot campaigns list --status sending --json
06 
07# Campañas con errores
08plazbot campaigns list --status error

Resultado

text

01  Campaigns (2)
02  ────────────────────────────────────────
03┌────────────────────────────┬──────────────────┬──────────┬───────────┬────────┬──────────────────┐
04│ ID                         │ Name             │ Status   │ Sent      │ Errors │ Created          │
05├────────────────────────────┼──────────────────┼──────────┼───────────┼────────┼──────────────────┤
06│ cam_AbcDef123              │ promo_octubre    │ complete │ 1180/1200 │ 20     │ 2026-10-06 15:42 │
07├────────────────────────────┼──────────────────┼──────────┼───────────┼────────┼──────────────────┤
08│ cam_GhiJkl456              │ recordatorio     │ sending  │ 340/900   │ 2      │ 2026-10-08 09:10 │
09└────────────────────────────┴──────────────────┴──────────┴───────────┴────────┴──────────────────┘

Columna	Descripción
ID	ID de la campaña (`cam_...`). Úsalo con `campaigns records`.
Name	Nombre de la campaña.
Status	`pending`, `scheduled`, `sending`, `complete`, `error` o `canceled`.
Sent	Enviados sobre el total de destinatarios.
Errors	Envíos que fallaron.
Created	Fecha de creación (UTC).

Salida JSON

json

01{
02  "data": [
03    {
04      "id": "cam_AbcDef123",
05      "name": "promo_octubre",
06      "totalSend": 1180,
07      "totalErrors": 20,
08      "totalRecords": 1200,
09      "statusId": 4,
10      "statusText": "COMPLETE",
11      "scheduledSendDate": null,
12      "templates": [{ "id": "tem_AbcDef123", "name": "promo_octubre" }],
13      "userCreationName": "Ana Pérez",
14      "creationDate": "2026-10-06T15:42:32.426Z",
15      "lastUpdatedDate": "2026-10-06T15:44:00.424Z",
16      "errorSummary": null
17    }
18  ],
19  "nextCursor": null
20}

statusId: 1 pending, 2 scheduled, 3 sending, 4 complete, 5 error, 6 canceled.

Errores comunes

Mensaje	Causa	Solución
`error: option '--status <status>' argument '...' is invalid`	Estado no válido	Usa uno de los valores de la tabla
`You are not signed in.`	No hay sesión	Ejecuta `plazbot login`