# Listar automatizaciones

> plazbot automations list: automatizaciones (flujos) del workspace con su estado, canal y triggers.

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

### Listar automatizaciones

Muestra las automatizaciones (flujos) del workspace con su estado, su canal y cuántos de sus triggers están activos. No trae los nodos: para ver un flujo completo usa [`plazbot automations get`](https://developers.plazbot.com/cli/automations/get). Por defecto oculta los subflujos.

```bash
plazbot automations list [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Publicadas | `--published` | No | Solo las automatizaciones publicadas. |
| Subflujos | `--subflows` | No | Incluye los subflujos (flujos que se llaman desde otro con "Iniciar automatización"). |
| 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 tiene el formato de todos los listados del CLI: `{ "data": [...], "nextCursor": null }`. Este listado no se pagina (la API devuelve todo de una vez). Más detalles en [Scripting y agentes de IA](https://developers.plazbot.com/cli/ia/scripting).

### Ejemplos

```bash
# Todas las automatizaciones
plazbot automations list

# Solo las publicadas, en JSON
plazbot automations list --published --json

# IDs de las automatizaciones con algún trigger activo
plazbot automations list --json | jq -r '.data[] | select(any(.triggers[]; .isActive)) | .id'
```

### Resultado

```text
Automations (2)
────────────────────────────────────────
┌───────────────┬────────────────────┬───────────┬──────────┬──────────────┬──────────────────┐
│ ID            │ Title              │ Status    │ Channel  │ Triggers     │ Opened           │
├───────────────┼────────────────────┼───────────┼──────────┼──────────────┼──────────────────┤
│ aut_AbcDef123 │ Bienvenida         │ published │ whatsapp │ 1/1 active   │ 2026-10-08 12:40 │
├───────────────┼────────────────────┼───────────┼──────────┼──────────────┼──────────────────┤
│ aut_GhiJkl456 │ Calificar leads    │ draft     │ instagram│ 0/1 active   │ 2026-10-01 21:42 │
└───────────────┴────────────────────┴───────────┴──────────┴──────────────┴──────────────────┘
```

| Columna | Descripción |
|---------|-------------|
| ID | ID de la automatización (`aut_...`). |
| Title | Nombre del flujo. |
| Status | `draft` (en edición, nunca publicada o con cambios) o `published`. |
| Channel | Canal del flujo: `webchat`, `whatsapp`, `facebook`, `instagram`, `telegram`. |
| Triggers | Triggers activos sobre el total. |
| Opened | Última vez que se abrió en el editor (UTC). |

### Salida JSON

```json
{
"data": [
  {
    "id": "aut_AbcDef123",
    "title": "Bienvenida",
    "status": 2,
    "channel": 2,
    "isSubflow": false,
    "parentAutomationId": null,
    "isEdited": false,
    "creationDate": "2026-08-12T16:08:37.588Z",
    "openingDate": "2026-10-08T12:40:22.431Z",
    "modificationDate": "2026-08-12T18:31:25.032Z",
    "triggers": [
      { "id": "trigg-94341-835968", "type": 1, "isActive": true }
    ]
  }
],
"nextCursor": null
}
```

`status` es `1` (borrador) o `2` (publicada). `channel`: `1` webchat, `2` WhatsApp, `3` Facebook, `4` Instagram, `5` Telegram.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |
