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.
01plazbot login [--zone <LA|EU>] [--no-browser] [--read-only]
Cómo funciona
- Si no pasas
--zone, el CLI pregunta dónde creaste tu cuenta: Americas (appla.plazbot.com) o Europe (appeu.plazbot.com). - Muestra un código de verificación y abre tu navegador en la página Autorizar CLI.
- En el navegador, con tu sesión de Plazbot abierta, confirmas que el código coincide, eliges el workspace y presionas Autorizar.
- La terminal confirma la sesión y la guarda en
~/.plazbot/config.json(con permisos0600).
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
01# Pregunta la zona y abre el navegador02plazbot login0304# Cuenta creada en Europa05plazbot login --zone EU0607# Servidor remoto: copia el link y ábrelo en tu computador08plazbot login --zone LA --no-browser0910# Sesión de solo lectura para un agente de IA (no puede cambiar datos)11plazbot login --read-only
Resultado
01? Where did you create your Plazbot account? Americas (appla.plazbot.com)0203 Your verification code: KXPD-7M4Q0405 We opened your browser. If it did not open, go to:06 https://appla.plazbot.com/cli/authorize?code=KXPD-7M4Q&r=...0708✔ Signed in to Mi Empresa (LA)09 Account: tu@empresa.com1011 Next steps:12 plazbot whatsapp setup Connect WhatsApp and send your first message13 plazbot whoami Show the active session14 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 |
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.
01plazbot login --read-only02plazbot 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.
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.
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:
01export PLAZBOT_API_KEY=tu_api_key02export PLAZBOT_WORKSPACE_ID=wok_AbcDef12303export 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.