Conectar un número | Plazbot Docs

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

bash

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:

text

01  ┃ We opened the Meta sign-up in your browser.
02  ┃ https://co.plzb.link/...
03  ┃ Sign in with Facebook, choose or create your WhatsApp Business account and verify the number.
04 
05✔ Number detected: Soporte (+51 987 654 321)
06✔ Number active
07 
08  WhatsApp connected: Soporte (+51 987 654 321)

Si no se detecta ningún número en 10 minutos, el comando termina con código 1. Si la activación automática falla, activa el número en el panel.

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.

bash

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" }'

respuesta·json

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}

Campo `type`	Conexión
`whatsapp`	WhatsApp API
`whatsapp_business`	WhatsApp Business (coexistencia, con QR)

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

bash

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.