Webhook (WhatsApp Business)

El webhook de WhatsApp es una dirección HTTPS, mantenida por la empresa o por su CRM, que Meta llama cada vez que pasa algo con el número conectado a la API oficial. Es la forma en que el sistema sabe, sin preguntar, que llegó un mensaje o que una entrega cambió de estado.

Eventos más comunes

• messages: mensaje nuevo del cliente (texto, imagen, audio, documento, ubicación, sticker) y cambio de estado de los mensajes enviados (enviado, entregado, leído, falló).
• message_template_status_update: plantilla aprobada, rechazada o pausada.
• account_alerts y business_capability_update: avisos de la cuenta y cambios del límite de envío.

Cómo funciona

1. La URL del webhook se registra en la app de Meta.
2. En cada evento, Meta envía un POST HTTPS a esa URL.
3. El sistema confirma rápido la recepción y procesa el contenido: crea el contacto, muestra el mensaje, dispara la automatización.
4. Si la dirección no responde, Meta reintenta durante un tiempo; un endpoint caído por mucho tiempo pierde eventos.

Seguridad

Meta firma cada llamada con HMAC-SHA256 usando el secreto de la app; el sistema debe verificar la firma antes de confiar en el contenido. La dirección necesita HTTPS con certificado válido.

Quién se encarga

En una plataforma como CRPRO, el webhook lo gestiona la plataforma — la empresa no necesita configurar nada. Quien integra la Cloud API directamente tiene que implementar, monitorear y mantener el endpoint en línea, porque un webhook detenido es un mensaje que no llega.