Configuración de Webhooks

Suscríbete a Webhooks para recibir notificaciones sobre los cambios en la configuración de tu cuenta de WhatsApp Business y las señales de calidad.

La configuración de Webhooks no afectará el número de teléfono registrado en tu Aplicación WhatsApp Business. Una vez que migres tu número de teléfono a la Plataforma de WhatsApp Business, ya no podrás usarlo en la Aplicación WhatsApp Business.

Crea un punto de conexión

Para poder comenzar a recibir notificaciones, primero, deberás crear un punto de conexión en tu servidor.

El punto de conexión debe tener la capacidad de procesar dos tipos de solicitudes HTTPS: solicitudes de verificación y notificaciones de eventos. Como ambas solicitudes utilizan HTTPS, tu servidor debe tener un certificado TLS o SSL válido que se haya configurado e instalado correctamente. No se admiten los certificados autofirmados.

Obtén más información sobre las solicitudes de verificación y las notificaciones de eventos

Suscríbete a Webhooks

Para suscribirte a webhooks, necesitarás conseguir permisos y un identificador de la app Meta. Para eso, ve al panel de apps de Meta. Allí, deberás hacer lo siguiente:

Crear una app de Meta en el panel de apps de Meta.
Agregar el producto "Webhooks" a la app de Meta en el panel de apps.
En todo momento, las apps de Meta solo pueden tener un punto de conexión configurado. Si necesitas enviar notificaciones webhooks a varios puntos de conexión, es necesario que utilices múltiples apps de Meta.

Cuando tengas todo listo para ampliar la escala de los mensajes de tu empresa, es posible que necesites hacer lo siguiente:

Agregar el permiso whatsapp_business_management en el panel de apps.
Completar con éxito la revisión de apps de Meta : este paso llevará tiempo, pero puedes seguir realizando la prueba durante todo el proceso.

Campos de suscripción disponibles

Nombre del campo	Descripción
`account_review_update`	Se te enviará una notificación cuando se haya revisado una cuenta de WhatsApp Business.
`account_update`	Se te enviará una notificación cuando se produzca un cambio en tu cuenta de WhatsApp Business. Este cambio puede ser una actualización de un número de teléfono, una infracción de una política, la prohibición de una cuenta de WhatsApp Business, entre otras opciones.
`business_capability_update`	Se te enviará una notificación cuando se haya actualizado una función. Puede tratarse de un cambio en la cantidad máxima de números de teléfono que una WABA puede tener o de conversaciones por número de teléfono.
`message_template_status_update`	Se te enviará una notificación cuando se haya aprobado o rechazado la plantilla de mensaje, o si esta se desactivó.
`messages`	Se te enviará una notificación cuando tu empresa haya recibido un mensaje de un cliente, cuando envíes un mensaje a un cliente, cuando se entregue un mensaje a un cliente y cuando un cliente lea tu mensaje.
`phone_number_name_update`	Se te enviará una notificación cuando se haya aprobado o rechazado el nombre asociado con un número de teléfono.
`phone_number_quality_update`	Se te enviará una notificación cuando se actualice el estado relacionado con la calidad de un número de teléfono.
`security`	Se te enviará una notificación en los siguientes casos: Cuando solicites desactivar el código de verificación en dos pasos Cuando se desactive el código de verificación en dos pasos Cuando se actualice el código de verificación en dos pasos

Consulta la referencia de webhooks de la cuenta de WhatsApp Business para obtener más información sobre cada campo de carga y la referencia de webhooks de la API de la nube de WhatsApp para obtener más información sobre los diferentes tipos de notificaciones de messages que puedes recibir.

Carga de notificaciones

Todas las notificaciones tienen el siguiente formato genérico:

[{
    "object": "whatsapp_business_account",
    "entry": [{
       "id": "{whatsapp-business-account-id}",
        "time": {unix-timestamp},
        "changes": [{
            "field": "{subscribed-field}",
            "value": {
                # Information that was update
            }
          }]
      }]
  }]

La matriz de nivel superior contiene dos objetos principales:

Parámetro	Descripción
`object`	Este es el objeto al que te suscribiste.
`entry`	Este objeto contiene los detalles del cambio que activó la llamada a los webhooks.

Consulta Componentes para obtener información de todos los objetos de webhooks disponibles.

Ejemplos de puntos de conexión de apps

Plataforma de WhatsApp Business | API de la nube | API de instalaciones locales | API de administración de WhatsApp Business