Resumen

Como empresa, es esencial estar al tanto de cualquier cambio en su cuenta de WhatsApp Business (WABA), especialmente cuando se trata de violaciones de la política de WhatsApp. Al integrarse con webhooks, puede recibir notificaciones en tiempo real sobre cambios en su WABA, lo que le permite ajustar rápidamente su comportamiento y evitar advertencias y acciones de aplicación adicionales.

Instrucciones

Antes de empezar

Para completar esta guía, necesitará:

Registrarse como Desarrollador de Meta
Configurar una cuenta de Administrador de negocios
Crear una aplicación de Meta para desarrolladores con el tipo Negocio y vincularla a su Administrador de negocios
Agregar WhatsApp como producto a su aplicación
Asegurarse de que su aplicación haya completado la Revisión de la aplicación y haya solicitado el permiso whatsapp_business_management Para agregar WhatsApp como producto a su aplicación, siga estos pasos:
Vaya al Portal de desarrolladores de Facebook y haga clic en su aplicación
En el panel de la aplicación, busque Productos en el panel lateral izquierdo y haga clic en Agregar producto
Encuentre WhatsApp y haga clic en Configurar

Paso 1: Configurar el punto de conexión y configurar webhooks

Siga nuestra Guía de inicio de webhooks para crear su punto de conexión y configurar sus webhooks.

Paso 2: Suscribir su aplicación a su WABA

Necesita suscribir su aplicación a notificaciones de webhooks para su WABA. Puede hacerlo de dos maneras:

Paso 3: Registrarse para obtener actualizaciones de cuenta

Ahora que su aplicación está suscrita a webhooks, puede definir qué tipos de actualizaciones desea recibir. Para realizar un seguimiento del estado de su WABA, seleccione la opción account_update. Esto lo notificará cuando su WABA haya violado las políticas de WhatsApp. Para seleccionar esta opción:

Vaya a su panel de aplicación y encuentre la opción Configuración
Haga clic en Webhooks y luego en Administrar
Aparecerá un cuadro de diálogo con todos los campos a los que puede suscribirse. Haga clic en Suscribirse para account_update Recibirá una notificación como esta cuando su WABA haya violado una política:

{
  "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: Realizar un seguimiento de las restricciones de WABA

Mantenga un ojo en sus webhooks para comprobar si su WABA ha sido restringido debido a violaciones de políticas. Si se ha impuesto una restricción, recibirá un webhook con el campo restriction_info, que enumera todas las restricciones impuestas a su cuenta y cuándo expiran esas restricciones. Aquí hay algunos ejemplos de webhooks que informan sobre restricciones:

Restricción para 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
      }
    ]
  }
}

Restricción para enviar mensajes iniciados por el negocio:

{
  "field": "account_update",
  "value": {
    "phone_number": "PHONE_NUMBER",
    "event": "ACCOUNT_RESTRICTION",
    "restriction_info": [
      {
        "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
        "expiration": TIMESTAMP
      }
    ]
  }
}

Restricción para responder a 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
      }
    ]
  }
}

Siguiendo estos pasos, podrá configurar webhooks para su WABA y recibir notificaciones en tiempo real sobre cambios en su cuenta, lo que lo ayudará a cumplir con las políticas de WhatsApp y evitar cualquier problema potencial.

Preguntas frecuentes (FAQ)

Introducción

1. ¿Qué necesito antes de configurar webhooks para mi WABA?

Necesita registrarse como Desarrollador de Meta, configurar una cuenta de Administrador de negocios, crear una aplicación de Meta para desarrolladores con el tipo Negocio, vincularla a su Administrador de negocios y agregar WhatsApp como producto. Su aplicación también debe completar la Revisión de la aplicación y solicitar el permiso whatsapp_business_management.

2. ¿Cómo agrego WhatsApp como producto a mi aplicación?

Puede agregar WhatsApp yendo al Portal de desarrolladores de Facebook, abriendo su aplicación, seleccionando Agregar producto, encontrando WhatsApp y haciendo clic en Configurar.

Configuración de webhooks

3. ¿Cómo configuro un punto de conexión y configuro webhooks?

Puede seguir la Guía de inicio de webhooks para crear su punto de conexión y configurar la configuración de webhooks.

4. ¿Cómo suscribo mi aplicación para recibir notificaciones de webhooks de WABA?

Puede suscribir su aplicación utilizando llamadas de API o a través del Explorador de Graph API.

5. ¿Qué tipos de actualizaciones puedo suscribirme?

Para realizar un seguimiento del estado de WABA, debe suscribirse al campo account_update, que lo notificará de violaciones de políticas y eventos relacionados con la cuenta.

Notificaciones de violaciones de políticas

6. ¿Cómo sabré si mi WABA ha violado una política?

Recibirá una notificación de webhook con el campo event establecido en ACCOUNT_VIOLATION, junto con detalles sobre el tipo de violación.

7. ¿Qué información se incluye en una notificación de violación de políticas?

Una notificación de violación incluye el número de teléfono, el tipo de evento y un campo violation_info que muestra la violación de políticas específica.

Seguimiento de restricciones

8. ¿Cómo puedo realizar un seguimiento de las restricciones impuestas a mi WABA?

Recibirá notificaciones de webhooks que contienen el campo restriction_info, que enumera las restricciones y sus tiempos de expiración.

9. ¿Qué tipos de restricciones puedo recibir notificaciones sobre?

Puede recibir notificaciones sobre restricciones para agregar nuevos números de teléfono, enviar mensajes iniciados por el negocio o responder a mensajes iniciados por el usuario.

10. ¿Qué debo hacer después de recibir una notificación de restricción?

Monitoree sus webhooks para obtener actualizaciones y ajuste su comportamiento de mensajería para cumplir con las políticas de WhatsApp y evitar acciones de aplicación adicionales.

Cómo configurar webhooks para notificaciones de la cuenta de negocios de WhatsApp (WABA)