Configuración de webhooks

Suscríbete a Webhooks para obtener notificaciones sobre los mensajes que recibe tu empresa y actualizaciones de los perfiles de tus clientes.

Crear 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, deberás conseguir permisos y un identificador de la app de Meta. Para eso, ve al panel de apps de Meta. Allí, deberás hacer lo siguiente:

1. Crear una app de negocios en el panel de apps de Meta.
2. 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.

Si eres socio de soluciones, es posible que debas realizar lo siguiente:

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

Información sobre webhooks

Todos los webhooks tienen el siguiente formato genérico:

{
  "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 carga

Las cargas de webhooks pueden ser de hasta 3 MB.

Ejemplos de puntos de conexión de apps

Crea un punto de conexión de app de ejemplo para probar tus webhooks.

• Ejemplo de puntos de conexión de la app cuando se usa Glitch
• Ejemplo de puntos de conexión cuando se usa Heroku

Error en la entrega de webhooks

Si enviamos una solicitud de webhook a tu punto de conexión y tu servidor responde con un código de estado HTTP que no es 200, o si no podemos entregar el webhook por otro motivo, seguiremos intentando cada vez con menos frecuencia hasta que la solicitud tenga éxito, por hasta 7 días.

Ten en cuenta que los reintentos se enviarán a todas las apps que se hayan suscrito a los webhooks (y a sus campos correspondientes) en relación con la cuenta de WhatsApp Business. Esto puede dar como resultado que se dupliquen las notificaciones de webhook.

Direcciones IP

Puedes obtener las direcciones IP de nuestros servidores de webhook mediante la ejecución del siguiente comando en tu terminal:

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

Cambiamos estas direcciones IP con frecuencia, por lo que, si agregas nuestros servidores a una lista de autorizados, te recomendamos que vuelvas a generar la lista en ocasiones y la actualices.

Próximos pasos

Descubre la información que puedes recibir en una notificación de webhooks.