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]
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).
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) |
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-browser
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.
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 con el nombre de tu equipo, por ejemplo CLI · MacBook-Pro. Lo ves y lo puedes eliminar en el panel, en Configuración → Developer. Al eliminarlo, 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.