Producto
WhatsApp

Registrar webhook

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

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ámetroFlagRequeridoDescripció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--jsonNoImprime solo JSON en stdout

Las formas anteriores (--number) siguen funcionando.

Ejemplos

bash
01# Registrar un webhook de mensajes entrantes para un número
02plazbot whatsapp register-webhook -p +51912345678 -u https://api.example.com/webhooks/whatsapp
03 
04# Lo mismo, con salida JSON
05plazbot whatsapp register-webhook -p +51912345678 -u https://api.example.com/webhooks/whatsapp --json

Resultado

text
01 Registering WhatsApp webhook
02 ────────────────────────────────────────
03 Number: +51912345678
04 URL: https://api.example.com/webhooks/whatsapp
05✔ Webhook registered

Salida JSON

json
01{
02 "phone": "51912345678",
03 "url": "https://api.example.com/webhooks/whatsapp",
04 "registered": true
05}

Errores comunes

MensajeCausaSolució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 workspaceConéctalo con plazbot whatsapp connect
Missing phone number.No pasaste -pAgrega -p +51912345678

Registrar de nuevo reemplaza la URL anterior. Para quitarla usa plazbot whatsapp delete-webhook.

¿Quieres probar la API en vivo? Abre el Playground.