# Listar campañas

> plazbot campaigns list: campañas de WhatsApp con su estado y totales de envío.

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

### 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
plazbot 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](https://developers.plazbot.com/cli/ia/scripting).

### Ejemplos

```bash
# Últimas campañas
plazbot campaigns list

# Campañas que siguen enviando, en JSON
plazbot campaigns list --status sending --json

# Campañas con errores
plazbot campaigns list --status error
```

### Resultado

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

| Columna | Descripción |
|---------|-------------|
| ID | ID de la campaña (`cam_...`). Úsalo con [`campaigns records`](https://developers.plazbot.com/cli/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
{
"data": [
  {
    "id": "cam_AbcDef123",
    "name": "promo_octubre",
    "totalSend": 1180,
    "totalErrors": 20,
    "totalRecords": 1200,
    "statusId": 4,
    "statusText": "COMPLETE",
    "scheduledSendDate": null,
    "templates": [{ "id": "tem_AbcDef123", "name": "promo_octubre" }],
    "userCreationName": "Ana Pérez",
    "creationDate": "2026-10-06T15:42:32.426Z",
    "lastUpdatedDate": "2026-10-06T15:44:00.424Z",
    "errorSummary": null
  }
],
"nextCursor": null
}
```

`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`](https://developers.plazbot.com/cli/login) |