# Workspaces

> plazbot workspace list | use | show: lista tus workspaces, cambia el activo y muestra su configuración

Fuente: https://developers.plazbot.com/cli/workspace/

### 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.

> **Nota:** Requiere una sesión iniciada con [`plazbot login`](https://developers.plazbot.com/cli/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.

```bash
plazbot 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

```bash
# Listar tus workspaces (● marca el activo)
plazbot workspace list

# Obtenerlos en JSON
plazbot workspace list --json
```

### Resultado

```text
┌───┬──────────────────┬───────────────┐
│   │ Workspace        │ ID            │
├───┼──────────────────┼───────────────┤
│ ● │ Mi Empresa       │ wok_AbcDef123 │
├───┼──────────────────┼───────────────┤
│   │ Cliente Demo     │ wok_XyzUvw456 │
└───┴──────────────────┴───────────────┘
Switch with: plazbot workspace use <workspaceId>
```

Si no tienes workspaces, imprime `No workspaces found for this account.`

### Salida JSON

```json
[
{ "id": "wok_AbcDef123", "name": "Mi Empresa", "active": true },
{ "id": "wok_XyzUvw456", "name": "Cliente Demo", "active": false }
]
```

---

## workspace use

Cambia el workspace activo. Antes de cambiarlo, comprueba que tienes acceso.

```bash
plazbot 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

```bash
# Cambiar el workspace activo
plazbot workspace use wok_XyzUvw456

# Cambiar desde un script
plazbot workspace use wok_XyzUvw456 --json
```

### Resultado

```text
Active workspace: Cliente Demo (wok_XyzUvw456)
```

### Salida JSON

```json
{
"id": "wok_XyzUvw456",
"name": "Cliente Demo",
"active": true
}
```

---

---

## 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`](https://developers.plazbot.com/cli/contacts/update) necesita el ID de la etiqueta (`mot_...`) y `--stage` el de la fase (`mos_...`).

```bash
plazbot 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

```bash
# Resumen del workspace activo
plazbot workspace show

# Etiquetas con sus IDs
plazbot workspace show tags

# Números de WhatsApp y canales conectados, en JSON
plazbot workspace show channels --json

# Pipelines de otro workspace
plazbot workspace show pipelines -w wok_XyzUvw456
```

### Resultado

```text
Contact tags (3)
────────────────────────────────────────
┌────────────────────────────┬──────────────┬─────────┐
│ ID                         │ Name         │ Color   │
├────────────────────────────┼──────────────┼─────────┤
│ mot_AbcDef123              │ Cliente VIP  │ #4ade80 │
├────────────────────────────┼──────────────┼─────────┤
│ mot_GhiJkl456              │ Seguimiento  │ #c084fc │
├────────────────────────────┼──────────────┼─────────┤
│ mot_MnoPqr789              │ Reclamo      │ #ef4444 │
└────────────────────────────┴──────────────┴─────────┘
```

### Salida JSON (resumen)

```json
{
"id": "wok_AbcDef123",
"name": "Mi Empresa",
"timezone": "America/Lima",
"timezoneOffset": -5,
"contactsCount": 308,
"opportunitiesCount": 42,
"tasksCount": 9,
"isAutomationDisabled": false,
"subscription": [],
"sections": { "tags": 16, "stages": 6, "pipelines": 2, "channels": 17 }
}
```

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

> **Tip:** Para trabajar con un workspace de otra zona, inicia sesión en esa zona: `plazbot login --zone EU` (o `LA`).
