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
01plazbot 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 |
Las formas anteriores (--number) siguen funcionando.
Ejemplos
bash
01# Registrar un webhook de mensajes entrantes para un número02plazbot whatsapp register-webhook -p +51912345678 -u https://api.example.com/webhooks/whatsapp0304# Lo mismo, con salida JSON05plazbot whatsapp register-webhook -p +51912345678 -u https://api.example.com/webhooks/whatsapp --json
Resultado
text
01 Registering WhatsApp webhook02 ────────────────────────────────────────03 Number: +5191234567804 URL: https://api.example.com/webhooks/whatsapp05✔ Webhook registered
Salida JSON
json
01{02 "phone": "51912345678",03 "url": "https://api.example.com/webhooks/whatsapp",04 "registered": true05}
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 |
Missing phone number. | No pasaste -p | Agrega -p +51912345678 |
Registrar de nuevo reemplaza la URL anterior. Para quitarla usa plazbot whatsapp delete-webhook.