Resumen
Como empresa, es esencial mantenerse al tanto de cualquier cambio en tu Cuenta de Negocios de WhatsApp (WABA), especialmente cuando se trata de violaciones de la Política de WhatsApp. Al integrarte con webhooks, puedes recibir notificaciones en tiempo real sobre cambios en tu WABA, lo que te permite ajustar rápidamente tu comportamiento y evitar advertencias adicionales y/o acciones de ejecución.
Instrucciones
Antes de comenzar
Para completar esta guía, necesitarás:
Registrarte como Desarrollador de Meta
Configurar una cuenta de Gestor de Negocios
Crear una aplicación de Meta para Desarrolladores con el tipo Negocio y vincularla a tu Gestor de Negocios
Añadir WhatsApp como producto en tu aplicación
Asegúrate de que tu aplicación haya completado la Revisión de la aplicación y solicite el permiso
whatsapp_business_management
Para añadir WhatsApp como producto en tu aplicación, sigue estos pasos:Ve al Portal de Desarrolladores de Facebook y haz clic en tu aplicación
En el panel de control de la aplicación, busca Productos en el panel izquierdo y haz clic en Añadir producto
Busca WhatsApp y haz clic en Configurar
Paso 1: Configurar el punto final y los webhooks
Sigue nuestra guía de Introducción a Webhooks para crear tu punto final y configurar tus webhooks.
Paso 2: Suscribir tu aplicación a tu WABA
Necesitas suscribir tu aplicación a las notificaciones de webhooks para tu WABA. Puedes hacerlo de dos maneras:
Paso 3: Regístrate para recibir actualizaciones de la cuenta
Ahora que tu aplicación está suscrita a webhooks, puedes definir qué tipos de actualizaciones deseas recibir. Para rastrear el estado de tu WABA, selecciona la opción account_update
. Esto te notificará cuando tu WABA haya violado las políticas de WhatsApp. Para seleccionar esta opción:
Ve a tu Panel de la aplicación y busca la opción Configuración
Haz clic en Webhooks y luego en Administrar
Aparecerá una ventana emergente con todos los campos a los que puedes suscribirte. Haz clic en Suscribir para
account_update
Recibirás una notificación como esta cuando tu WABA haya violado una política:
json { "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", } } } ] } ]}
Paso 4: Rastrear restricciones de WABA
Mantén un ojo en tus webhooks para verificar si tu WABA ha sido restringido debido a violaciones de políticas. Si se ha impuesto una restricción, recibirás un webhook con el campo restriction_info
, que lista todas las restricciones impuestas en tu cuenta y cuándo expira esas restricciones. Aquí tienes algunos ejemplos de webhooks que informan restricciones:
Restricción de añadir nuevos números de teléfono:
json { "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [ { "restriction_type": "RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION", "expiration": TIMESTAMP }, ] }}
Restricción de enviar mensajes iniciados por el negocio:
json { "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [ { "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING", "expiration": TIMESTAMP }, ] }}
Restricción de responder a mensajes iniciados por el usuario:
json { "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [{ "restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING", "expiration": TIMESTAMP } ] }}
Al seguir estos pasos, podrás configurar webhooks para tu WABA y recibir notificaciones en tiempo real sobre cambios en tu cuenta, ayudándote a mantenerte conforme con las políticas de WhatsApp y evitar cualquier posible problema.
Preguntas frecuentes (FAQ)
Empezar
¿Qué debo hacer antes de configurar webhooks para mi Cuenta de Negocios de WhatsApp? Debes registrarte como Desarrollador de Meta, configurar una cuenta de Gestor de Negocios, crear una aplicación de Meta para Desarrolladores con el tipo "Negocio", y vincularla a tu Gestor de Negocios. Además, debes añadir WhatsApp como producto en tu aplicación y asegurarte de que tu aplicación haya completado la Revisión de la aplicación y solicitado el permiso
whatsapp_business_management
.¿Cómo añado WhatsApp como producto en mi aplicación? Puedes añadir WhatsApp como producto en tu aplicación yendo al sitio web de Meta para Desarrolladores, haciendo clic en tu aplicación y luego haciendo clic en Añadir Producto. Desde allí, puedes encontrar y configurar WhatsApp.
Configurar Webhooks
¿Cómo configuro webhooks para mi Cuenta de Negocios de WhatsApp? Puedes configurar webhooks siguiendo nuestra guía de Introducción a Webhooks, que te guiará a través del proceso de crear un punto final y configurar tus webhooks.
¿Qué tipos de actualizaciones puedo recibir a través de webhooks? Puedes recibir actualizaciones sobre actualizaciones de cuenta, incluidas violaciones de políticas y restricciones impuestas en tu Cuenta de Negocios de WhatsApp.
Recepción de notificaciones
¿Cómo recibiré notificaciones cuando mi Cuenta de Negocios de WhatsApp haya sido restringida? Recibirás una notificación de webhook con el campo
restriction_info
, que lista todas las restricciones impuestas en tu cuenta y cuándo expira esas restricciones.¿Qué información recibiré en una notificación de webhook cuando mi Cuenta de Negocios de WhatsApp haya violado una política? Recibirás una notificación con el campo
account_update
, que incluye información sobre la violación de la política, como el tipo de violación y el número de teléfono asociado a la cuenta.
Solución de problemas
¿Qué debo hacer si no estoy recibiendo notificaciones de webhooks? Verifica que tus webhooks estén configurados correctamente y que tu aplicación tenga los permisos necesarios. También puedes consultar la documentación de Meta para Desarrolladores para obtener consejos de solución de problemas.
¿Cómo puedo asegurarme de que mi Cuenta de Negocios de WhatsApp esté conforme con las políticas de WhatsApp? Puedes asegurar el cumplimiento revisando regularmente las Políticas de Comercio y Negocios de WhatsApp y ajustando tu comportamiento en la plataforma en consecuencia. También puedes usar webhooks para recibir notificaciones cuando tu cuenta haya sido restringida o haya violado una política.