Conectar un número

Todas las formas usan el registro oficial de Meta (Embedded Signup). Necesitas una cuenta de Facebook con acceso al Business Manager de la empresa dueña del número.

Desde el CLI

01plazbot whatsapp connect              # WhatsApp API
02plazbot whatsapp connect --business   # tu app WhatsApp Business (coexistencia)

El CLI obtiene el link de conexión, lo abre en tu navegador y espera hasta detectar el número nuevo. Luego lo activa:

01  ┃ Abrimos el registro de Meta en tu navegador.
02  ┃ https://co.plzb.link/La_tk...
03  ┃ Inicia sesión con Facebook, elige o crea tu cuenta de WhatsApp Business y verifica el número.
04 
05✔ Número detectado: Soporte (+51 966 446 311)
06✔ Número activo
07 
08  WhatsApp conectado: Soporte (+51 966 446 311)

También lo hace plazbot whatsapp setup, que además prueba el envío. Referencia: plazbot whatsapp connect.

Desde el panel

En el panel de Plazbot: Configuración → Integraciones → WhatsApp → Agregar Configuración. Se abre el registro de Meta en una pestaña nueva.

Link para tus clientes

Si conectas números de tus clientes (por ejemplo, eres una agencia o un SaaS), genera un link y compártelo. Tu cliente abre el link, hace el registro de Meta con su propia cuenta y el número queda conectado en tu workspace, sin darte accesos de Meta.

01curl -X POST \
02  https://api.plazbot.com/api/workspace/$PLAZBOT_WORKSPACE_ID/onboarding-link \
03  -H "Authorization: Bearer $PLAZBOT_API_KEY" \
04  -H "x-workspace-id: $PLAZBOT_WORKSPACE_ID" \
05  -H "Content-Type: application/json" \
06  -d '{ "type": "whatsapp" }'

01{
02  "success": true,
03  "data": {
04    "token": "La_tk...",
05    "shortUrl": "https://co.plzb.link/La_tk...",
06    "expiresAt": "2026-10-02T12:00:00Z"
07  }
08}

• El link dura 7 días. Para generar uno nuevo: POST .../onboarding-link/regenerate con el mismo cuerpo.
• Para consultar el link vigente: GET .../onboarding-link?type=whatsapp.
• En el panel también lo generas en Configuración → Integraciones → WhatsApp → Generar link.

Ver los números conectados

01plazbot whatsapp connect   # muestra los números ya conectados antes de generar el link

Los números conectados aparecen en el panel, Configuración → Integraciones → WhatsApp, donde puedes activarlos, desactivarlos o eliminarlos.