Workspaces
Todos los comandos del CLI trabajan sobre el workspace activo. Si eres miembro de varios, puedes listarlos y cambiar de uno a otro sin volver a iniciar sesión.
Requiere una sesión iniciada con plazbot login. Con plazbot init sin --user-id el CLI no conoce tu usuario y no puede listar workspaces; con variables de entorno, cambia PLAZBOT_WORKSPACE_ID.
workspace list
Lista los workspaces de los que eres miembro: solo los activos, cuya invitación ya aceptaste y de la misma zona de tu sesión.
01plazbot workspace list [--json]
Parámetros
| Parámetro | Flag | Requerido | Descripción |
|---|---|---|---|
| JSON | --json | No | Imprime la lista en JSON, con active: true en el workspace activo |
Ejemplos
01# Listar tus workspaces (● marca el activo)02plazbot workspace list0304# Obtenerlos en JSON05plazbot workspace list --json
Resultado
01┌───┬──────────────────┬───────────────┐02│ │ Workspace │ ID │03├───┼──────────────────┼───────────────┤04│ ● │ Mi Empresa │ wok_AbcDef123 │05├───┼──────────────────┼───────────────┤06│ │ Cliente Demo │ wok_XyzUvw456 │07└───┴──────────────────┴───────────────┘08 Switch with: plazbot workspace use <workspaceId>
Si no tienes workspaces, imprime No workspaces found for this account.
Salida JSON
01[02 { "id": "wok_AbcDef123", "name": "Mi Empresa", "active": true },03 { "id": "wok_XyzUvw456", "name": "Cliente Demo", "active": false }04]
workspace use
Cambia el workspace activo. Antes de cambiarlo, comprueba que tienes acceso.
01plazbot workspace use <workspaceId> [--json]
Parámetros
| Parámetro | Flag | Requerido | Descripción |
|---|---|---|---|
| Workspace ID | <workspaceId> | Sí | ID del workspace (sale en plazbot workspace list) |
| JSON | --json | No | Imprime el resultado en JSON |
Ejemplos
01# Cambiar el workspace activo02plazbot workspace use wok_XyzUvw4560304# Cambiar desde un script05plazbot workspace use wok_XyzUvw456 --json
Resultado
01 Active workspace: Cliente Demo (wok_XyzUvw456)
Salida JSON
01{02 "id": "wok_XyzUvw456",03 "name": "Cliente Demo",04 "active": true05}
workspace show
Muestra la configuración del workspace: etiquetas, fases, pipelines, canales y demás catálogos, con sus IDs. Es el punto de partida para otros comandos: por ejemplo, plazbot contacts update --add-tag necesita el ID de la etiqueta (mot_...) y --stage el de la fase (mos_...).
01plazbot workspace show [sección] [--include-inactive] [-w <workspaceId>] [-z <LA|EU>] [--json]
Sin sección muestra un resumen: nombre, zona horaria, contadores y cuántos elementos tiene cada sección.
| Sección | Contenido |
|---|---|
tags | Etiquetas de contacto (mot_...) |
stages | Fases del embudo de contactos (mos_...) |
states | Estados de contacto |
pipelines | Pipelines de oportunidades con sus etapas (pip_...) |
variables | Variables personalizadas de contacto (ctc_...) |
segmentations | Segmentaciones |
groups | Grupos de trabajo del equipo |
projects | Proyectos de tareas |
surveys | Encuestas de satisfacción |
quick-replies | Respuestas rápidas |
rules | Reglas automáticas |
channels | Canales e integraciones (WhatsApp, Instagram, Google…) con su ID (int_...). Nunca muestra tokens ni claves |
Parámetros
| Parámetro | Flag | Requerido | Descripción |
|---|---|---|---|
| Sección | [sección] | No | Una de las secciones de la tabla. Sin sección, el resumen |
| Incluir inactivos | --include-inactive | No | Incluye etiquetas eliminadas y canales inactivos |
| Workspace | -w, --workspace <id> | No | Otro de tus workspaces, sin cambiar el activo |
| Zona | -z, --zone <zone> | No | LA o EU |
| JSON | --json | No | En una sección, imprime { "data": [...], "nextCursor": null }; en el resumen, el objeto |
Ejemplos
01# Resumen del workspace activo02plazbot workspace show0304# Etiquetas con sus IDs05plazbot workspace show tags0607# Números de WhatsApp y canales conectados, en JSON08plazbot workspace show channels --json0910# Pipelines de otro workspace11plazbot workspace show pipelines -w wok_XyzUvw456
Resultado
01 Contact tags (3)02 ────────────────────────────────────────03┌────────────────────────────┬──────────────┬─────────┐04│ ID │ Name │ Color │05├────────────────────────────┼──────────────┼─────────┤06│ mot_AbcDef123 │ Cliente VIP │ #4ade80 │07├────────────────────────────┼──────────────┼─────────┤08│ mot_GhiJkl456 │ Seguimiento │ #c084fc │09├────────────────────────────┼──────────────┼─────────┤10│ mot_MnoPqr789 │ Reclamo │ #ef4444 │11└────────────────────────────┴──────────────┴─────────┘
Salida JSON (resumen)
01{02 "id": "wok_AbcDef123",03 "name": "Mi Empresa",04 "timezone": "America/Lima",05 "timezoneOffset": -5,06 "contactsCount": 308,07 "opportunitiesCount": 42,08 "tasksCount": 9,09 "isAutomationDisabled": false,10 "subscription": [],11 "sections": { "tags": 16, "stages": 6, "pipelines": 2, "channels": 17 }12}
Errores comunes
| Mensaje | Causa | Solución |
|---|---|---|
You do not have access to workspace wok_... | No eres miembro, no aceptaste la invitación o el workspace es de otra zona | Revisa tus workspaces con plazbot workspace list |
The session comes from environment variables. | Las variables de entorno mandan sobre la sesión guardada | Cambia PLAZBOT_WORKSPACE_ID |
This session has no user attached, so workspaces cannot be listed. | La sesión se guardó con plazbot init sin --user-id | Inicia sesión con plazbot login |
You are not signed in. | No hay sesión | Ejecuta plazbot login |
Unknown section "..." | workspace show con una sección que no existe | Usa una de la tabla de secciones |
Workspace wok_... not found in zone LA. | workspace show -w con un workspace de otra zona | Agrega -z EU (o LA) |
Para trabajar con un workspace de otra zona, inicia sesión en esa zona: plazbot login --zone EU (o LA).