Asistente de configuración

plazbot whatsapp setup

Un asistente de 4 pasos para dejar WhatsApp funcionando y comprobarlo con tu propio celular. Necesita una terminal interactiva; los textos del asistente están en inglés.

01plazbot whatsapp setup [opciones]

Parámetros

Ejemplos

01# Configurar WhatsApp paso a paso
02plazbot whatsapp setup
03 
04# Imprimir los links en lugar de abrir el navegador
05plazbot whatsapp setup --no-browser

Paso 1 · Tu cuenta

Usa la sesión activa. Si no tienes sesión, inicia el login por navegador sin salir del asistente.

01[1/4] Your account
02  ✓ Mi Empresa (LA) · tu@empresa.com

Sin sesión verás No active session. Let's sign in from the browser. y se abre el login.

Paso 2 · Tu número de WhatsApp

Si ya tienes números conectados, eliges uno. Si está inactivo, el asistente lo activa. También puedes conectar uno nuevo:

01[2/4] Your WhatsApp number
02? Which number do you want to use?
03❯ Soporte (+51 912 345 678)
04  ──────────────
05  Connect a new number

Al conectar uno nuevo eliges el tipo (How do you want to connect WhatsApp?):

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

Se abre el registro de Meta en tu navegador (inicias sesión con Facebook, eliges la cuenta de WhatsApp Business y verificas el número). El asistente espera hasta 10 minutos y avisa cuando detecta el número:

01✔ Number detected: Soporte (+51 912 345 678)
02✔ Number active

Si no se detecta ningún número a tiempo, el asistente imprime Run plazbot whatsapp setup again when you finish the Meta sign-up. y termina con código 1. Es el mismo flujo de plazbot whatsapp connect.

Paso 3 · Prueba de ida y vuelta

1. Escribe el celular desde el que vas a escribir, con código de país.
2. Desde ese celular envía "hello" al número conectado. El asistente muestra un atajo wa.me que abre WhatsApp con el mensaje escrito.
3. Cuando llega tu mensaje, el asistente pregunta si responde desde la API.

01[3/4] Round-trip test
02? Which phone will you write from? (international format, e.g. +51912345678) +51987654321
03 
04  From that phone, send "hello" on WhatsApp to +51912345678
05  Shortcut: https://wa.me/51912345678?text=hello
06  Your message creates the contact and opens the 24h window in which WhatsApp allows free-form replies.
07 
08✔ Message received: "hello"
09? Reply to you from the API? Yes
10✔ Message sent. Check your WhatsApp.

En tu celular llega una respuesta que empieza con "It works!" y termina con "This message was sent by your code through the Plazbot API."

Si tu mensaje no llega en 5 minutos, verás Your message did not arrive within 5 minutes.: revisa que el número esté activo y vuelve a ejecutar el asistente.

Paso 4 · Webhook (opcional)

Escribe la URL https:// que recibirá los mensajes entrantes del número, o presiona Enter para omitirlo:

01[4/4] Webhook (optional)
02? Webhook URL to receive incoming messages (Enter to skip): https://tu-app.com/api/whatsapp
03✔ Webhook registered: https://tu-app.com/api/whatsapp

Si lo omites, el asistente te recuerda el comando para hacerlo después: plazbot whatsapp register-webhook -p +51912345678 -u <url>.

Para probar sin servidor propio puedes usar una URL de webhook.site. El formato del mensaje está en Recibir mensajes.

Al final: código para tu app

El asistente imprime el snippet del SDK con tu workspace, tu zona y tu celular:

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

Para tu servidor crea una API key en el panel, Configuración → Developer, y guárdala en PLAZBOT_KEY.

Si algo falla, revisa Solución de problemas.