# Registrar webhook

> Registra la URL que recibe los mensajes entrantes de un número de WhatsApp.

Fuente: https://developers.plazbot.com/whatsapp/cli/register-webhook/

### Registrar webhook

Configura la URL de tu servidor (o de Make, Zapier, etc.) que recibirá los mensajes entrantes de un número de WhatsApp conectado al workspace activo.

```bash
plazbot whatsapp register-webhook -p <número> -u <url> [opciones]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Teléfono | `-p, --phone <number>` | Sí | Tu número de WhatsApp conectado, en formato internacional, por ejemplo `+51912345678` |
| URL | `-u, --url <url>` | Sí | URL pública https que recibirá los mensajes entrantes |
| JSON | `--json` | No | Imprime solo JSON en stdout |

> **Nota:** Las formas anteriores (`--number`) siguen funcionando.

### Ejemplos

```bash
# Registrar un webhook de mensajes entrantes para un número
plazbot whatsapp register-webhook -p +51912345678 -u https://api.example.com/webhooks/whatsapp

# Lo mismo, con salida JSON
plazbot whatsapp register-webhook -p +51912345678 -u https://api.example.com/webhooks/whatsapp --json
```

### Resultado

```text
Registering WhatsApp webhook
────────────────────────────────────────
Number: +51912345678
URL: https://api.example.com/webhooks/whatsapp
✔ Webhook registered
```

### Salida JSON

```json
{
"phone": "51912345678",
"url": "https://api.example.com/webhooks/whatsapp",
"registered": true
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Invalid webhook URL "..."` | La URL no empieza con http(s) | Usa una URL pública, por ejemplo `-u https://api.example.com/webhooks/whatsapp` |
| `The webhook was not registered.` (más el detalle de la API) | El número no está conectado a este workspace | Conéctalo con [`plazbot whatsapp connect`](https://developers.plazbot.com/whatsapp/cli/connect) |
| `Missing phone number.` | No pasaste `-p` | Agrega `-p +51912345678` |

> **Tip:** Registrar de nuevo reemplaza la URL anterior. Para quitarla usa [`plazbot whatsapp delete-webhook`](https://developers.plazbot.com/whatsapp/cli/delete-webhook).