Cómo configurar Webhooks en Meta Developers para WhatsApp
Aprende paso a paso a configurar webhooks para recibir mensajes, estados y eventos de WhatsApp Cloud API en tiempo real.
Los webhooks son esenciales para cualquier integración profesional con WhatsApp Cloud API. Te permiten recibir notificaciones instantáneas cuando occuren eventos como mensajes entrants, estados de entrega, y más.
¿Qué son los Webhooks?
Los webhooks sonHTTP requests que Meta envía a tu servidor cuando ocurren eventos específicos. En lugar de constantemente preguntar a la API si hay nuevos mensajes (polling), los webhooks te notificann automáticamente.
Esto permite crear respuestas en tiempo real y mantener tu sistema sincronizado con WhatsApp.
Requisitos Previos
Servidor con HTTPS
Tu endpoint debe estar disponible en una URL HTTPS pública. Meta no acepta URLs HTTP.
Token permanente configurado
Debes haber completado la configuración del token permanente para autenticar las requests.
App en Meta Developers
Una app de WhatsApp configurada en Meta Developers con el producto WhatsApp activo.
Paso a Paso: Configurar Webhooks
1. Crea tu Endpoint
Crea un endpoint en tu servidor que pueda recibir requests GET (para verificación) y POST (para eventos). Debe responder a las verificaciones de Meta.
2. Obtén las Credenciales
En Meta Developers, ve a tu app > WhatsApp > Configuration. Aquí encontrarás el Webhook URL y el Verify Token.
3. Registra tu Webhook
Ingresa tu URL de callback y un verify token que tú elijas. Meta verificará que tu servidor responda correctamente.
4. Suscribe a Eventos
Selecciona los eventos a los que deseas suscribirte. Los más comunes son: messages (mensajes entrants), message_template_status (estatus de plantillas), y account_alerts (alertas de cuenta).
5. Verifica la Configuración
Usa la herramienta de prueba en Meta Developers para verificar que los webhooks funcionan correctamente.
Errores Comunes
⚠️ Error: Webhook no se verifica
Solución: Verifica que tu endpoint responde correctamente al GET con hub.challenge. Asegúrate de que la URL es HTTPS.
⚠️ Error: No recibo mensajes
Solución: Verifica que estás suscrito al evento 'messages'. Revisa los logs de tu servidor.
Conclusión
Los webhooks son fundamentales para una integración profesional con WhatsApp Cloud API. Permiten respuestas en tiempo real y una experiencia fluida para tus clientes.
En LETEL, te ayudamos a configurar webhooks y toda tu integración de WhatsApp Business API.
¿Necesitas ayuda con tus webhooks?
Nuestro equipo técnico puede configurar webhooks y toda la integración de WhatsApp. Contactar expertos para tu integración.
LETEL
Expertos en telecomunicaciones y automatización empresarial