Configuración de webhooks

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

La configuración de los webhooks no afectará al número de teléfono de la aplicación WhatsApp Business. Una vez que migres un número de teléfono a la Plataforma de WhatsApp Business, ya no podrás usarlo en la aplicación WhatsApp Business.

Creación de 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.

Suscripción 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:

Crea una aplicación de Meta en el panel de aplicaciones de Meta.
Añade el producto Webhooks a la aplicación de Meta en el panel de aplicaciones.
Cada aplicación de Meta solo puede tener un extremo configurado. Si quieres enviar actualizaciones de webhooks a varios extremos, necesitarás varias aplicaciones de Meta.

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

Añadir el permiso whatsapp_business_management en el panel de aplicaciones.
Completar correctamente la revisión de la aplicación de Meta: este paso tardará en completarse, pero puedes continuar con las pruebas durante todo el proceso de revisión.

Campos de suscripción disponibles

Nombre del campo	Descripción
`account_review_update`	Recibirás una notificación cuando se haya revisado una cuenta de WhatsApp Business.
`account_update`	Recibirás una notificación cuando se produzca un cambio en tu cuenta de WhatsApp Business. Este cambio puede hacer referencia a la actualización del número de teléfono, una infracción de la política o el bloqueo de una cuenta de WhatsApp Business, entre otros.
`business_capability_update`	Recibirás una notificación cuando se actualice una función. Puede ser un cambio en el máximo de números de teléfono que una cuenta WABA puede tener o de conversaciones por número de teléfono.
`message_template_status_update`	Recibirás una notificación cuando la plantilla de mensaje se haya aprobado o rechazado, o se haya desactivado.
`messages`	Recibirás una notificación cuando tu empresa reciba 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`	Recibirás una notificación cuando el nombre asociado a un número de teléfono se haya aprobado o rechazado.
`phone_number_quality_update`	Recibirás una notificación cuando el estado relacionado con la calidad de un número de teléfono se actualice.
`security`	Recibirás una notificación cuando: solicites desactivar el código de verificación en dos pasos; se desactive el código de verificación en dos pasos; se actualice el código de verificación en dos pasos.

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

Carga útil de las notificaciones

Todas las notificaciones tienen el formato genérico siguiente:

[{
    "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`	Objeto de la suscripción.
`entry`	Este objeto contiene los detalles del cambio que activó la llamada de Webhooks.

Para obtener información sobre todos los objetos de Webhooks disponibles, consulta Componentes.

Extremos de aplicación de muestra

Plataforma de WhatsApp Business | API de nube | API local | API de administración de WhatsApp Business