# Listar vistas

> plazbot views list: vistas guardadas (bandeja, Kanban, tareas, oportunidades) y sus filtros.

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

### Listar vistas

Muestra las vistas guardadas que puedes ver (las tuyas, las compartidas y las del equipo), con su módulo, modo y un resumen de sus filtros. El ID de la vista (`viw_...`) sirve para listar los contactos que ve esa vista con [`contacts list --view`](https://developers.plazbot.com/cli/contacts/list). También funciona como `plazbot view list`.

```bash
plazbot views list [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Módulo | `-m, --module <module>` | No | Solo vistas de un módulo: `chat`, `tasks`, `deals` o `voip`. |
| 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": null }`. |

Necesita tu ID de usuario: funciona con la sesión de [`plazbot login`](https://developers.plazbot.com/cli/login). Con `PLAZBOT_API_KEY`, define también `PLAZBOT_USER_ID`.

### Ejemplos

```bash
# Todas las vistas que puedes ver
plazbot views list

# Solo las vistas de la bandeja de chats
plazbot views list -m chat

# Contactos de una vista
plazbot contacts list --view viw_AbcDef123
```

### Resultado

```text
Views (2)
────────────────────────────────────────
┌───────────────┬──────────────────────┬─────────────┬───────────────┬──────────────────────┬─────────┐
│ ID            │ Title                │ Module      │ Mode          │ Filters              │ Private │
├───────────────┼──────────────────────┼─────────────┼───────────────┼──────────────────────┼─────────┤
│ viw_AbcDef123 │ Mis chats            │ CHAT.MODULE │ MODE.CHAT     │ agent IS 1           │ yes     │
├───────────────┼──────────────────────┼─────────────┼───────────────┼──────────────────────┼─────────┤
│ viw_GhiJkl456 │ Pendientes VIP       │ CHAT.MODULE │ MODE.KANBAN   │ tags IS 1            │ —       │
└───────────────┴──────────────────────┴─────────────┴───────────────┴──────────────────────┴─────────┘
```

`Filters` resume cada filtro como `campo operador cantidad-de-valores` (por ejemplo `tags IS 2`). El detalle completo está en [`views get`](https://developers.plazbot.com/cli/views/get).

### Salida JSON

```json
{
"data": [
  {
    "id": "viw_AbcDef123",
    "workspaceId": "wok_AbcDef123",
    "title": "Mis chats",
    "viewType": "CHAT.MODULE",
    "mode": "MODE.CHAT",
    "isPrivate": true,
    "filters": [
      { "field": "agent", "connector": "IS", "value": ["usr_AbcDef123"] }
    ],
    "userCreator": "usr_AbcDef123",
    "indexOrder": 4
  }
],
"nextCursor": null
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Listing views needs your user ID.` | La sesión viene de `PLAZBOT_API_KEY` sin `PLAZBOT_USER_ID` | Inicia sesión con [`plazbot login`](https://developers.plazbot.com/cli/login) o define `PLAZBOT_USER_ID` |
| `You are not signed in.` | No hay sesión | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login) |