# Conectar WhatsApp

> Conecta un número de WhatsApp al workspace con el registro oficial de Meta.

Fuente: https://developers.plazbot.com/whatsapp/cli/connect/

### Conectar WhatsApp

Obtiene el link de conexión del workspace, lo abre en tu navegador y espera hasta 10 minutos a que aparezca el número nuevo. Cuando lo detecta, lo activa. Para probar además el envío y la recepción, usa el asistente [`plazbot whatsapp setup`](https://developers.plazbot.com/whatsapp/setup).

```bash
plazbot whatsapp connect [opciones]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| WhatsApp Business | `--business` | No | Conecta tu app WhatsApp Business actual (coexistencia, se vincula con QR). Default: WhatsApp API |
| Sin navegador | `--no-browser` | No | Solo imprime el link, sin abrir el navegador (por ejemplo, para abrirlo en otro dispositivo) |

### Ejemplos

```bash
# Número nuevo o dedicado con WhatsApp API
plazbot whatsapp connect

# Tu app WhatsApp Business actual (coexistencia)
plazbot whatsapp connect --business

# Solo imprimir el link
plazbot whatsapp connect --no-browser
```

### Resultado

```text
Connect WhatsApp
────────────────────────────────────────
1 number(s) already connected:
  • Ventas (+51 912 345 678)  active

┃ 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.
┃ The link expires on October 12.

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

WhatsApp connected: Soporte (+51 987 654 321)

Next step:
  plazbot whatsapp setup   Send and receive your first message
```

Con `--no-browser` la primera línea del recuadro es `Open this link in your browser:`. Con `--business` el título es `Connect WhatsApp Business` y la indicación es vincular la app escaneando el código QR.

Si no se puede activar el número automáticamente:

```text
⚠ Could not activate it automatically. Activate it in the panel → Integrations.

WhatsApp connected: Soporte (+51 987 654 321)
The number is not active yet. Activate it in the panel → Integrations.
```

Si en 10 minutos no se detecta ningún número nuevo, el comando termina con código 1:

```text
⚠ No new connection was detected in time.

Try again with: plazbot whatsapp connect
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Could not get the connection link.` | La API no devolvió el link de conexión | Vuelve a intentarlo, o conecta el número desde el panel → Integrations |
| `Could not load the workspace integrations.` | Falló la consulta de números del workspace | Vuelve a intentarlo en unos segundos |
| `Your session is invalid or was revoked.` | La sesión ya no es válida | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login) |

> **Tip:** El link de conexión se reutiliza mientras está vigente y se regenera cuando vence. Si no terminaste el registro a tiempo, termínalo y vuelve a ejecutar el comando.