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. También funciona como plazbot view list.

bash

01plazbot 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. Con PLAZBOT_API_KEY, define también PLAZBOT_USER_ID.

Ejemplos

bash

01# Todas las vistas que puedes ver
02plazbot views list
03 
04# Solo las vistas de la bandeja de chats
05plazbot views list -m chat
06 
07# Contactos de una vista
08plazbot contacts list --view viw_AbcDef123

Resultado

text

01  Views (2)
02  ────────────────────────────────────────
03┌───────────────┬──────────────────────┬─────────────┬───────────────┬──────────────────────┬─────────┐
04│ ID            │ Title                │ Module      │ Mode          │ Filters              │ Private │
05├───────────────┼──────────────────────┼─────────────┼───────────────┼──────────────────────┼─────────┤
06│ viw_AbcDef123 │ Mis chats            │ CHAT.MODULE │ MODE.CHAT     │ agent IS 1           │ yes     │
07├───────────────┼──────────────────────┼─────────────┼───────────────┼──────────────────────┼─────────┤
08│ viw_GhiJkl456 │ Pendientes VIP       │ CHAT.MODULE │ MODE.KANBAN   │ tags IS 1            │ —       │
09└───────────────┴──────────────────────┴─────────────┴───────────────┴──────────────────────┴─────────┘

Filters resume cada filtro como campo operador cantidad-de-valores (por ejemplo tags IS 2). El detalle completo está en views get.

Salida JSON

json

01{
02  "data": [
03    {
04      "id": "viw_AbcDef123",
05      "workspaceId": "wok_AbcDef123",
06      "title": "Mis chats",
07      "viewType": "CHAT.MODULE",
08      "mode": "MODE.CHAT",
09      "isPrivate": true,
10      "filters": [
11        { "field": "agent", "connector": "IS", "value": ["usr_AbcDef123"] }
12      ],
13      "userCreator": "usr_AbcDef123",
14      "indexOrder": 4
15    }
16  ],
17  "nextCursor": null
18}

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` o define `PLAZBOT_USER_ID`
`You are not signed in.`	No hay sesión	Ejecuta `plazbot login`