Asistente de configuración

plazbot whatsapp setup

bash

01plazbot whatsapp setup

Un asistente de 4 pasos para dejar WhatsApp funcionando y comprobarlo con tu propio celular.

Parámetros

Parámetro	Flag	Requerido	Descripción
Sin navegador	`--no-browser`	No	No abre el navegador; solo muestra los links
Entorno dev	`--dev`	No	Usa el backend local

Paso 1 · Tu cuenta

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

text

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

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:

text

01[2/4] Tu número de WhatsApp
02? ¿Qué número quieres usar?
03❯ Soporte (+51 966 446 311)
04  ──────────────
05  Conectar un número nuevo

Al conectar uno nuevo eliges el tipo:

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:

text

01✔ Número detectado: Soporte (+51 966 446 311)
02✔ Número activo

Los números conectados por QR (no oficial) no aparecen en este asistente: WhatsApp for Developers usa solo la API oficial de Meta.

Paso 3 · Prueba de ida y vuelta

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

text

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

Escribir primero es obligatorio: crea el contacto y abre la ventana de 24 horas en la que WhatsApp permite responder con texto libre. Ver Conceptos clave.

Si el número tiene un agente IA asignado, el agente también responderá a tu "hola". Para una prueba limpia usa un número sin agente.

Paso 4 · Webhook (opcional)

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

text

01[4/4] Webhook (opcional)
02? URL de tu webhook para recibir los mensajes entrantes (Enter para omitir): https://tu-app.com/api/whatsapp
03✔ Webhook registrado: https://tu-app.com/api/whatsapp

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:

send.ts·ts

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: "Hola desde mi 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.