# Iniciar sesión

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

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

### Iniciar sesión

Es la forma recomendada de conectar el CLI con tu cuenta. No necesitas copiar API key, workspace ni zona: autorizas el acceso desde el navegador.

```bash
plazbot login [--zone <LA|EU>] [--no-browser] [--read-only]
```

### Cómo funciona

1. Si no pasas `--zone`, el CLI pregunta dónde creaste tu cuenta: **Americas** (`appla.plazbot.com`) o **Europe** (`appeu.plazbot.com`).
2. Muestra un **código de verificación** y abre tu navegador en la página **Autorizar CLI**.
3. En el navegador, con tu sesión de Plazbot abierta, confirmas que el código coincide, eliges el **workspace** y presionas **Autorizar**.
4. La terminal confirma la sesión y la guarda en `~/.plazbot/config.json` (con permisos `0600`).

Desde ahí todos los comandos usan esa sesión: no tienes que volver a poner la API key. El token dura **1 año**; después, o si lo revocas, el CLI pide `plazbot login` otra vez.

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Zona | `-z, --zone <zone>` | No | `LA` (América) o `EU` (Europa), en mayúsculas o minúsculas. Si no se indica, el CLI pregunta. Obligatorio sin terminal interactiva |
| Sin navegador | `--no-browser` | No | No abre el navegador; solo muestra el link (útil en servidores sin interfaz gráfica o por SSH) |
| Solo lectura | `--read-only` | No | Crea un token que solo puede consultar datos: la API rechaza cualquier cambio. Recomendado para agentes de IA |

### Ejemplos

```bash
# Pregunta la zona y abre el navegador
plazbot login

# Cuenta creada en Europa
plazbot login --zone EU

# Servidor remoto: copia el link y ábrelo en tu computador
plazbot login --zone LA --no-browser

# Sesión de solo lectura para un agente de IA (no puede cambiar datos)
plazbot login --read-only
```

### Resultado

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

Con `--no-browser` la línea cambia a `Open this link in your browser:`.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Invalid zone "..."` | `--zone` distinto de `LA` o `EU` | Usa `--zone LA` (América) o `--zone EU` (Europa) |
| `The zone is required without an interactive terminal.` | Se ejecutó sin terminal (CI, pipes) y sin `--zone` | Pasa `--zone LA` o `--zone EU` |
| `Login timed out.` | El código venció antes de autorizarlo en el navegador | Vuelve a ejecutar `plazbot login` |
| `Could not reach Plazbot (...)` | Sin conexión con la API | Revisa tu conexión a internet |

> **Tip:** El código de verificación sirve una sola vez y vence si no lo autorizas a tiempo. Puedes cancelar la espera con Ctrl+C.

### Sesión de solo lectura

Con `--read-only` el token solo puede hacer consultas (peticiones GET). Cualquier comando que cree, edite, borre o envíe algo termina con el error `read_only` y no cambia nada. Es la forma más segura de darle el CLI a un agente de IA como Claude Code: puede revisar contactos, campañas o reportes, pero no modificarlos.

```bash
plazbot login --read-only
plazbot whoami          # muestra "Access: read-only (cannot change data)"
```

El token aparece en **Configuración → Developer** como **CLI · MacBook-Pro (solo lectura)**.

| Quieres | Ejecuta |
|---------|---------|
| Que el CLI (o un agente de IA) pueda consultar y también hacer cambios | `plazbot login` |
| Que solo pueda consultar | `plazbot login --read-only` |

El CLI guarda una sola sesión por equipo: cada `plazbot login` reemplaza la anterior. Aun con acceso completo, los comandos que cambian datos piden confirmación (o `--yes` cuando no hay terminal), y los más peligrosos, como borrados masivos o envío de campañas, exigen siempre `--yes`.

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `This session is read-only: it cannot change data.` | Se intentó un cambio con una sesión de solo lectura | Usa `plazbot login` sin `--read-only` |
| `Read-only login is not available.` | El servidor de Plazbot aún no admite tokens de solo lectura. El CLI revoca el token completo que recibió en lugar de guardarlo | Inicia sesión sin `--read-only` |

Más detalles en [Usar el CLI con IA y scripts](https://developers.plazbot.com/cli/ia/scripting).

### Un login, varios workspaces

La sesión es de tu **usuario**, no de un workspace: funciona con todos los workspaces de los que eres miembro en la misma zona. Cambia el activo con [`plazbot workspace use`](https://developers.plazbot.com/cli/workspace).

### Revocar el acceso

Cada login crea un token nuevo con el nombre de tu equipo, por ejemplo **CLI · MacBook-Pro**. Los tokens anteriores no se borran solos. Los ves y los puedes eliminar en el panel, en **Configuración → Developer**: elimina los que ya no uses. Al eliminar el token activo, el CLI de ese equipo deja de funcionar y pide `plazbot login` otra vez.

### CI y servidores

En CI 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 en el equipo con [`plazbot init`](https://developers.plazbot.com/cli/init).
