Destinatarios de una campaña

Lista cada destinatario de una campaña con su estado de entrega (enviado, entregado, leído o fallido) y el detalle del error que devolvió WhatsApp. Es el comando para responder "¿por qué falló esta campaña?".

bash

01plazbot campaigns records <campaignId> [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
ID de la campaña	`<campaignId>`	Sí	ID `cam_...` (sale en `campaigns list`).
Solo fallidos	`--failed`	No	Muestra solo los envíos con estado `FAILED` o `ERROR`.
Límite	`--limit <n>`	No	Se detiene al llegar a N destinatarios. Por defecto `200`.
Cursor	`--cursor <token>`	No	Continúa desde el `nextCursor` de una llamada anterior.
Todos	`--all`	No	Trae todas las páginas, hasta 5000 destinatarios.
Workspace	`-w, --workspace <id>`	No	Workspace de la campaña. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona activa.
JSON	`--json`	No	Imprime `{ "data": [...], "nextCursor": ... }`.

--failed filtra las páginas ya descargadas: para revisar toda la campaña úsalo junto con --all.

Ejemplos

bash

01# Estado de entrega de todos los destinatarios
02plazbot campaigns records cam_AbcDef123 --all
03 
04# Solo los fallidos, en JSON
05plazbot campaigns records cam_AbcDef123 --all --failed --json
06 
07# Contar los errores por motivo
08plazbot campaigns records cam_AbcDef123 --all --failed --json | jq -r '.data[].errorDetail' | sort | uniq -c

Resultado

text

01  Campaign records (3)
02  ────────────────────────────────────────
03┌─────────────┬────────────┬───────────┬─────────────────────────────────────┬──────────────────┐
04│ Phone       │ Contact    │ Status    │ Detail                              │ Date             │
05├─────────────┼────────────┼───────────┼─────────────────────────────────────┼──────────────────┤
06│ 51912345678 │ Ana Pérez  │ READ      │ Accepted                            │ 2026-10-06 10:43 │
07├─────────────┼────────────┼───────────┼─────────────────────────────────────┼──────────────────┤
08│ 51987654321 │ Luis Rojas │ DELIVERED │ Accepted                            │ 2026-10-06 10:43 │
09├─────────────┼────────────┼───────────┼─────────────────────────────────────┼──────────────────┤
10│ 51911122233 │ —          │ FAILED    │ This message was not delivered to … │ 2026-10-06 10:43 │
11└─────────────┴────────────┴───────────┴─────────────────────────────────────┴──────────────────┘

Status	Significado
`SENT`	WhatsApp aceptó el mensaje.
`DELIVERED`	Llegó al teléfono del contacto.
`READ`	El contacto lo leyó.
`FAILED`	WhatsApp no lo entregó. El motivo está en `Detail`.

Si WhatsApp todavía no informó la entrega, Status muestra el resultado del envío. Detail dice Accepted cuando no hubo error. Las fechas usan la zona horaria del workspace.

Salida JSON

json

01{
02  "data": [
03    {
04      "conversationId": "cnv_AbcDef123",
05      "campaignName": "promo_octubre",
06      "contactId": "con_AbcDef123",
07      "contactName": "Ana Pérez",
08      "phone": "51912345678",
09      "platformSenderName": "Mi Empresa",
10      "deliveryStatusId": 3,
11      "status": "READ",
12      "errorDetail": "Accepted",
13      "templateCode": "promo_octubre",
14      "templateType": "MARKETING",
15      "creationDate": "2026-10-06T10:43:07.839Z"
16    }
17  ],
18  "nextCursor": null
19}

deliveryStatusId: 1 sent, 2 delivered, 3 read, 4 failed.

Errores comunes

Mensaje	Causa	Solución
`No records`	La campaña no tiene destinatarios o el ID es de otro workspace	Revisa el ID con `campaigns list` y el workspace con `-w`
`You are not signed in.`	No hay sesión	Ejecuta `plazbot login`