# Destinatarios de una campaña

> plazbot campaigns records: estado de entrega y error de cada destinatario de una campaña.

Fuente: https://developers.plazbot.com/cli/campaigns/records/

### 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
plazbot 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`](https://developers.plazbot.com/cli/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
# Estado de entrega de todos los destinatarios
plazbot campaigns records cam_AbcDef123 --all

# Solo los fallidos, en JSON
plazbot campaigns records cam_AbcDef123 --all --failed --json

# Contar los errores por motivo
plazbot campaigns records cam_AbcDef123 --all --failed --json | jq -r '.data[].errorDetail' | sort | uniq -c
```

### Resultado

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

| 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
{
"data": [
  {
    "conversationId": "cnv_AbcDef123",
    "campaignName": "promo_octubre",
    "contactId": "con_AbcDef123",
    "contactName": "Ana Pérez",
    "phone": "51912345678",
    "platformSenderName": "Mi Empresa",
    "deliveryStatusId": 3,
    "status": "READ",
    "errorDetail": "Accepted",
    "templateCode": "promo_octubre",
    "templateType": "MARKETING",
    "creationDate": "2026-10-06T10:43:07.839Z"
  }
],
"nextCursor": null
}
```

`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`](https://developers.plazbot.com/cli/campaigns/list) y el workspace con `-w` |
| `You are not signed in.` | No hay sesión | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login) |