# Conectar un número

> Tres formas de conectar WhatsApp: desde el CLI, desde el panel o con un link para tus clientes

Fuente: https://developers.plazbot.com/whatsapp/conectar-numero/

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
plazbot whatsapp connect              # WhatsApp API
plazbot 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
┃ We opened the Meta sign-up in your browser.
┃ https://co.plzb.link/...
┃ Sign in with Facebook, choose or create your WhatsApp Business account and verify the number.

✔ Number detected: Soporte (+51 987 654 321)
✔ Number active

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`](https://developers.plazbot.com/whatsapp/cli/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
curl -X POST \
https://api.plazbot.com/api/workspace/$PLAZBOT_WORKSPACE_ID/onboarding-link \
-H "Authorization: Bearer $PLAZBOT_API_KEY" \
-H "x-workspace-id: $PLAZBOT_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{ "type": "whatsapp" }'
```

```json respuesta
{
"success": true,
"data": {
  "token": "La_tk...",
  "shortUrl": "https://co.plzb.link/La_tk...",
  "expiresAt": "2026-10-02T12:00:00Z"
}
}
```

| 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
plazbot 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.