Quickstart

Esta guía sigue el orden recomendado. Cada paso indica qué hacer y qué vas a ver. Tiempo total: unos 10 minutos (la mayor parte es el registro del número en Meta).

Antes de empezar

• Una cuenta de Plazbot. Si no tienes, créala gratis en appla.plazbot.com (América) o appeu.plazbot.com (Europa).
• Node.js 18.17 o superior.
• Tu celular con WhatsApp a mano (para la prueba).
• Para conectar un número nuevo: una cuenta de Facebook con acceso al Business Manager de tu empresa.

1. Instala el CLI

01npm i -g plazbot-cli
02plazbot --version

Qué vas a ver: la versión instalada (0.4.0 o superior).

2. Inicia sesión

01plazbot login

1. Elige dónde creaste tu cuenta: América o Europa.
2. Se abre tu navegador en la pantalla Autorizar CLI. Si no tenías sesión en Plazbot, primero inicias sesión y vuelves solo.
3. Confirma que el código que ves en el navegador es el mismo de tu terminal, elige el workspace y presiona Autorizar.

Qué vas a ver en la terminal:

01  Tu código de verificación: KXPD-7M4Q
02 
03  Abrimos tu navegador. Si no se abrió, entra a:
04  https://appla.plazbot.com/cli/authorize?code=KXPD-7M4Q&r=...
05 
06✔ Sesión iniciada en Mi Empresa (LA)
07  Cuenta: tu@empresa.com

No copiaste ninguna API key: el CLI la recibió y la guardó en ~/.plazbot/config.json. Más detalles en Iniciar sesión.

3. Conecta tu número y prueba tu primer mensaje

01plazbot whatsapp setup

El asistente tiene 4 pasos:

[1/4] Tu cuenta. Confirma la sesión activa.

[2/4] Tu número de WhatsApp. Elige un número ya conectado o Conectar un número nuevo:

• WhatsApp API: un número nuevo o dedicado. Ideal para enviar a escala.
• WhatsApp Business: tu app actual del celular, en coexistencia. Se vincula escaneando un QR.

Si conectas uno nuevo, se abre el registro de Meta en tu navegador. El CLI espera y te avisa cuando el número queda conectado y activo.

[3/4] Prueba de ida y vuelta.

1. Escribe tu celular con código de país (por ejemplo 51912345678).
2. Desde ese celular envía "hola" por WhatsApp al número conectado. El CLI te da un atajo wa.me.
3. El CLI detecta tu mensaje y pregunta si te responde desde la API. Acepta.

[4/4] Webhook (opcional). Escribe la URL que recibirá los mensajes entrantes, o presiona Enter para omitirlo.

Qué vas a ver:

01[3/4] Prueba de ida y vuelta
02? ¿Desde qué celular vas a escribir? 51912345678
03  Desde ese celular envía "hola" por WhatsApp a +51966446311
04  Atajo: https://wa.me/51966446311?text=hola
05✔ Recibimos tu mensaje: "hola"
06? ¿Te respondemos desde la API? Yes
07✔ Mensaje enviado. Revisa tu WhatsApp.

En tu celular llega: "¡Funciona! 🎉 Este mensaje lo envió tu código a través de la API de Plazbot."

Detalle de cada paso y posibles errores en Asistente de configuración.

4. Usa la API en tu app

Al final el asistente imprime el código con tus datos. Para tu servidor necesitas una API key propia (la del CLI es de tu computadora): créala en el panel, Configuración → Developer, y guárdala en una variable de entorno.

01npm i plazbot

01import { Plazbot } from "plazbot"
02 
03const bot = new Plazbot({
04  apiKey:      process.env.PLAZBOT_KEY!,
05  workspaceId: "tu_workspace_id",
06  zone:        "LA", // "LA" | "EU"
07})
08 
09await bot.message.onWhatsappMessage({
10  to:      "51912345678",
11  message: "Hola desde mi app",
12})

Más tipos de mensaje en Enviar mensajes.

5. Recibe las respuestas

Si registraste un webhook en el paso 3, cada mensaje que llegue a tu número se envía por POST a tu URL. El formato del JSON y un ejemplo de handler están en Recibir mensajes.

Resumen