Webhooks
Suscríbete a los webhooks para recibir notificaciones sobre los mensajes que reciba tu empresa y las actualizaciones del perfil de cliente.
Crear un extremo
Para poder empezar a recibir notificaciones, debes crear un extremo en el servidor para recibirlas.
El extremo debe ser capaz de procesar dos tipos de solicitudes HTTPS: solicitudes de verificación y notificaciones de eventos. Dado que ambas solicitudes usan HTTPS, el servidor debe tener un certificado TLS o SSL válido configurado e instalado correctamente. Ten en cuenta que no se admiten los certificados autofirmados.
Obtén más información sobre las solicitudes de verificación y las notificaciones de eventos.
Suscribirse a webhooks
Para suscribirte a webhooks, deberás obtener un identificador de la aplicación de Meta y permisos. Para ello, ve al panel de aplicaciones de Meta. Una vez allí, haz lo siguiente:
Permisos
Para recibir los webhooks, necesitarás los siguientes permisos:
- whatsapp_business_messaging: para los webhooks de
messages. - whatsapp_business_management: para los demás webhooks.
Si eres proveedor de soluciones y necesitas estos webhooks para proporcionar servicios de mensajes a fin de incorporar clientes empresariales, cada permiso deberá aprobarse para el acceso avanzado mediante el proceso de revisión de la aplicación.
Comprender los webhooks
Cuando se produce un evento de activación, la Plataforma de WhatsApp Business ve el evento y envía una notificación a la URL de un webhook que se ha especificado previamente. Puedes recibir dos tipos de notificaciones:
- Mensajes recibidos: esta alerta te avisa cuando has recibido un mensaje. También se denominan “notificaciones entrantes” en la documentación.
- Notificaciones de precios y de estado de los mensajes: esta alerta te avisa cuando ha cambiado el estado de un mensaje (por ejemplo, el mensaje se ha leído o entregado). También se denominan “notificaciones salientes” en la documentación.
Todos los webhooks tienen el formato genérico siguiente:
{
"object": "whatsapp_business_account",
"entry": [{
"id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
"changes": [{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "PHONE_NUMBER",
"phone_number_id": "PHONE_NUMBER_ID"
},
# specific Webhooks payload
},
"field": "messages"
}]
}]
}Consulta Componentes para obtener información sobre cada campo.
Si recibes un mensaje que no es compatible con la API de nube, obtendrás un webhook de mensaje desconocido.
Tamaño de las cargas útiles
Las cargas útiles de los webhooks pueden ser de hasta 3 MB.
Aplicación de prueba para webhooks
Implementa una aplicación de prueba para webhooks en Render.com si todavía estás en fase de pruebas y no tienes todo listo para crear el extremo de webhooks de producción.
Error en la entrega del webhook
Si enviamos una solicitud de webhook a tu extremo y tu servidor responde con un código de estado HTTP diferente de 200, o si no hemos podido entregar el webhook por otro motivo, seguiremos intentándolo durante un máximo de siete días con una frecuencia cada vez menor hasta que la solicitud se envíe correctamente.
Ten en cuenta que los reintentos se enviarán a todas las aplicaciones que se hayan suscrito a webhooks (y a sus campos correspondientes) de la cuenta de WhatsApp Business. Esto puede generar notificaciones de webhook duplicadas.
Direcciones IP
Para obtener las direcciones IP de nuestros servidores de webhooks, ejecuta el comando siguiente en tu terminal:
whois -h whois.radb.net — '-i origin AS32934' | grep '^route' | awk '{print $2}' | sort
Cambiamos estas direcciones IP periódicamente. Por tanto, si has añadido nuestros servidores a la lista de permitidos, te recomendamos volver a generar esta lista de vez en cuando y actualizarla en consecuencia.
Solución de problemas
Si no recibes webhooks:
- Asegúrate de que el extremo acepte solicitudes.
- Envía una carga útil de prueba al extremo desde la ventana del panel de aplicaciones > WhatsApp > Configuraciones.
- Asegúrate de que la aplicación esté en modo publicado, ya que es posible que algunos webhooks no se envíen si la aplicación está en modo desarrollo.
Siguientes pasos
Obtén más información sobre los datos que puedes recibir en una notificación de webhooks.