# Iniciar sesión

> plazbot login: inicia sesión en el CLI desde el navegador, sin copiar API key

Fuente: https://developers.plazbot.com/whatsapp/login/

## plazbot login

```bash
plazbot login
```

1. Si no pasas `--zone`, el CLI pregunta tu zona: **Americas** o **Europe**.
2. Muestra un código de verificación y abre tu navegador en **Autorizar CLI**.
3. En el navegador (con tu sesión de Plazbot) confirmas que el código coincide, eliges el **workspace** y presionas **Autorizar**.
4. La terminal confirma la sesión.

```text
? Where did you create your Plazbot account? Americas (appla.plazbot.com)

Your verification code: KXPD-7M4Q

We opened your browser. If it did not open, go to:
https://appla.plazbot.com/cli/authorize?code=KXPD-7M4Q&r=...

✔ Signed in to Mi Empresa (LA)
Account: tu@empresa.com

Next steps:
  plazbot whatsapp setup     Connect WhatsApp and send your first message
  plazbot whoami             Show the active session
  plazbot workspace list     Switch workspace
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Zona | `-z, --zone <zone>` | No | `LA` o `EU` (mayúsculas o minúsculas). Si no se indica, el CLI pregunta. Obligatorio sin terminal interactiva |
| Sin navegador | `--no-browser` | No | Solo muestra el link (servidores sin interfaz gráfica) |

> **Tip:** El código de verificación sirve una sola vez y vence si no lo autorizas a tiempo (verás `Login timed out.`). En ese caso vuelve a ejecutar `plazbot login`. Una zona inválida falla con `Invalid zone "..."`.

## Sesión y workspaces

```bash
plazbot whoami                        # cuenta, workspace y zona activos
plazbot workspace list                # tus workspaces (● = activo)
plazbot workspace use wok_AbcDef123   # cambiar el workspace activo
plazbot logout                        # cerrar la sesión local
```

La sesión funciona con todos los workspaces de los que eres miembro en la misma zona. Detalle de cada comando en la referencia del CLI: [whoami](https://developers.plazbot.com/cli/whoami), [workspace](https://developers.plazbot.com/cli/workspace) y [logout](https://developers.plazbot.com/cli/logout).

## Revocar el acceso

Cada login crea un token con el nombre de tu equipo, por ejemplo **CLI · MacBook-Pro**. Lo ves y lo puedes eliminar en el panel, **Configuración → Developer**. Al eliminarlo, el CLI de ese equipo deja de funcionar y pide `plazbot login` otra vez.

## CI y servidores

En CI o servidores no hay navegador. Usa variables de entorno con una API key creada en **Configuración → Developer**:

```bash
export PLAZBOT_API_KEY=tu_api_key
export PLAZBOT_WORKSPACE_ID=wok_AbcDef123
export PLAZBOT_ZONE=LA   # o EU; por defecto LA
```

Las variables de entorno tienen prioridad sobre la sesión guardada. También puedes guardar la key manualmente con [`plazbot init`](https://developers.plazbot.com/cli/init).