Producto
CLI

Iniciar sesión

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

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
01plazbot 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ámetroFlagRequeridoDescripción
Zona-z, --zone <zone>NoLA (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-browserNoNo abre el navegador; solo muestra el link (útil en servidores sin interfaz gráfica o por SSH)
Solo lectura--read-onlyNoCrea un token que solo puede consultar datos: la API rechaza cualquier cambio. Recomendado para agentes de IA

Ejemplos

bash
01# Pregunta la zona y abre el navegador
02plazbot login
03 
04# Cuenta creada en Europa
05plazbot login --zone EU
06 
07# Servidor remoto: copia el link y ábrelo en tu computador
08plazbot login --zone LA --no-browser
09 
10# Sesión de solo lectura para un agente de IA (no puede cambiar datos)
11plazbot login --read-only

Resultado

text
01? Where did you create your Plazbot account? Americas (appla.plazbot.com)
02 
03 Your verification code: KXPD-7M4Q
04 
05 We opened your browser. If it did not open, go to:
06 https://appla.plazbot.com/cli/authorize?code=KXPD-7M4Q&r=...
07 
08✔ Signed in to Mi Empresa (LA)
09 Account: tu@empresa.com
10 
11 Next steps:
12 plazbot whatsapp setup Connect WhatsApp and send your first message
13 plazbot whoami Show the active session
14 plazbot workspace list Switch workspace

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

Errores comunes

MensajeCausaSolución
Invalid zone "..."--zone distinto de LA o EUUsa --zone LA (América) o --zone EU (Europa)
The zone is required without an interactive terminal.Se ejecutó sin terminal (CI, pipes) y sin --zonePasa --zone LA o --zone EU
Login timed out.El código venció antes de autorizarlo en el navegadorVuelve a ejecutar plazbot login
Could not reach Plazbot (...)Sin conexión con la APIRevisa 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.

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

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

QuieresEjecuta
Que el CLI (o un agente de IA) pueda consultar y también hacer cambiosplazbot login
Que solo pueda consultarplazbot 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.

MensajeCausaSolución
This session is read-only: it cannot change data.Se intentó un cambio con una sesión de solo lecturaUsa 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 guardarloInicia 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:

bash
01export PLAZBOT_API_KEY=tu_api_key
02export PLAZBOT_WORKSPACE_ID=wok_AbcDef123
03export 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.

¿Quieres probar la API en vivo? Abre el Playground.