Usar webhooks para realizar un seguimiento de las infracciones de la política de las cuentas de WhatsApp Business
Las empresas pueden integrar webhooks para recibir notificaciones en tiempo real sobre los cambios de la cuenta de WhatsApp Business (WABA), incluso cuando una empresa infringió la política de WhatsApp. Esta guía te enseña cómo configurar los webhooks para recibir estas notificaciones. De esta manera, las empresas podrán adaptar rápidamente su comportamiento para evitar recibir advertencias y/o medidas de cumplimiento de normas adicionales.
Antes de empezar
Para completar esta guía, es necesario que te registres como desarrollador de Meta. Una vez que te registres, deberás configurar una cuenta de administrador comercial de Meta y una app de Meta for Developers.
Cuando crees la app de Meta, asegúrate de seleccionar el tipo "Negocio" y de enlazar la nueva app con el administrador comercial de Meta.
Después de crear la app, agrega WhatsApp como producto a tu aplicación. Sigue estos pasos:
- Ve a developers.facebook.com/apps y haz clic en la app. Luego, se te redireccionará al panel de tu app.
- Busca Productos en el panel lateral izquierdo y haz clic en Agregar producto. Después de hacer clic, verás una lista de los productos que pueden agregarse a una app.
- En WhatsApp, haz clic en Configurar.
Asimismo, asegúrate de que la app haya completado la revisión de apps y de haber solicitado el permiso whatsapp_business_management.
Paso 1: Establece el punto de conexión y configura los webhooks
Sigue nuestra Guía introductoria sobre webhooks para crear tu extremo y configurar los webhooks.
Paso 2: Suscribe la app a la cuenta de WhatsApp Business
Es necesario que suscribas la app a las notificaciones de webhooks de la cuenta de WhatsApp Business. Puedes suscribirla de dos maneras diferentes:
Paso 3: Regístrate para recibir actualizaciones de la cuenta
Ahora que tu cuenta está suscrita para recibir webhooks relacionados con tu cuenta de WhatsApp Business, puedes acotar qué tipos de actualizaciones deseas recibir. Para hacer seguimiento del estado de la cuenta de WhatsApp Business, es necesario que selecciones la opción "account_update". De esta manera, te notificaremos cuando una cuenta de WhatsApp Business infrinja las políticas de WhatsApp.
Para seleccionar esta opción, ve al panel de apps y busca la opción Configuración. Verás la sección Webhooks con toda la información que proporcionaste en los pasos anteriores. En Campos del webhook, haz clic en Gestionar. Aparecerá un cuadro de diálogo con los campos a los que puedes suscribirte. Haz clic en Suscribir en "account_update".
A partir de ahora, cada vez que tu cuenta de WhatsApp Business infrinja una política, recibirás una notificación, que se verá así:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "whatsapp-business-account-id",
"time": 1604703058,
"changes": [
{
"field": "account_update",
"value": {
"phone_number": "16505551111",
"event": "ACCOUNT_VIOLATION",
"violation_info": {
"violation_type": "ALCOHOL",
}
}
}
]
}
]
}
Se pueden encontrar aquí todas las infracciones a la política.
Paso 4: Hacer seguimiento de las restricciones de la cuenta de WhatsApp Business
Te recomendamos revisar los webhooks para verificar si tu cuenta de WhatsApp Business tiene alguna restricción por haber infringido las políticas. Si se impuso una restricción, recibirás un webhook que incluirá un campo restriction_info dentro del objeto de valor. El campo restriction_info enumera todas las restricciones que se le impusieron a tu cuenta y el momento en que caducan esas restricciones.
Es posible que tu cuenta de WhatsApp Business reciba una o más restricciones por infringir las políticas. En el siguiente ejemplo, el webhook reporta que se restringió una cuenta de WhatsApp Business y no puede agregar nuevos números de teléfono:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION",
"expiration": TIMESTAMP
},
]
}
}Puedes ver aquí que una cuenta de WhatsApp Business no puede enviar más mensajes iniciados por la empresa:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
"expiration": TIMESTAMP
},
]
}
}Puedes ver aquí que una cuenta de WhatsApp Business no puede enviar más mensajes iniciados por el usuario:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [{
"restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
"expiration": TIMESTAMP
}
]
}
}