Configuración de los webhooks

Suscríbete a los webhooks para recibir notificaciones sobre los mensajes que reciba tu empresa y las actualizaciones del perfil de cliente.

Crear un extremo

Para empezar a recibir notificaciones, debes crear un extremo en el servidor.

El extremo debe poder 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

Suscribirse 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:

1. Crea una aplicación de tipo empresarial en el panel de aplicaciones de Meta.
2. 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.

Si eres un socio de soluciones, es posible que tengas que hacer lo siguiente:

1. Añadir el permiso whatsapp_business_messaging en el panel de aplicaciones.
2. Completar correctamente la revisión de la aplicación de Meta : aunque este proceso tarda un poco, puedes continuar con las pruebas mientras tanto.

Comprender los webhooks

Todos los webhooks tienen el formato genérico siguiente:

{
  "object": "whatsapp_business_account",
  "entry": [{
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [{
          "value": {
              "messaging_product": "whatsapp",
              "metadata": {
                  "display_phone_number": "PHONE_NUMBER",
                  "phone_number_id": "PHONE_NUMBER_ID"
              },
              # specific Webhooks payload            
          },
          "field": "messages"
        }]
    }]
}

Consulta Componentes para obtener información sobre cada campo.

Tamaño de las cargas útiles

Las cargas útiles de los webhooks pueden ser de hasta 3 MB.

Extremos de aplicación de muestra

Crea un extremo de la aplicación de muestra para probar los webhooks.

• Extremos de aplicación de muestra mediante Glitch
• Extremos de aplicación de muestra mediante Heroku

Error en la entrega del webhook

Si enviamos una solicitud de webhook a tu extremo y tu servidor responde con un código de estado HTTP diferente de 200, o si no hemos podido entregar el webhook por otro motivo, seguiremos intentándolo durante un máximo de siete días con una frecuencia cada vez menor hasta que la solicitud se envíe correctamente.

Ten en cuenta que los reintentos se enviarán a todas las aplicaciones que se hayan suscrito a webhooks (y a sus campos correspondientes) de la cuenta de WhatsApp Business. Esto puede generar notificaciones de webhook duplicadas.

Direcciones IP

Para obtener las direcciones IP de nuestros servidores de webhooks, ejecuta el comando siguiente en tu terminal:

whois -h whois.radb.net — '-i origin AS32934' | grep ^route | awk '{print $2}' | sort

Cambiamos estas direcciones IP periódicamente. Por tanto, si has añadido nuestros servidores a la lista de permitidos, te recomendamos volver a generar esta lista de vez en cuando y actualizarla en consecuencia.

Siguientes pasos

Obtén más información sobre los datos que puedes recibir en una notificación de webhooks.