Skip to main content

Notifications

This documentation describes how to receive Webhook Callback Events in your system.

Introduction:#

When a customer sends you a message, the WhatsApp Business API client will send an HTTP POST request notification to the webhook URL with the details that are described in the following documents:

Make sure to check out the Best Practices docs for more information.

Error scenarios#

  • 302-redirect: Redirects are not followed by the webhook gateway. Please ensure that there is always HTTPS 200 as a response code.

  • SSL-errors: Please ensure that the callback-URLs are using SSL/TLS, and that the certificates are valid and that the certificate chain is complete.

  • You start processing in the callback thread. Please do only acknowledge messages and notifications and start processing in a separate thread.

  • Callbacks will be terminated after a defined timeout and there will be a retry.

  • Duplicates messages can be sent to a WhatsApp webhook as the only guarantee provided is that messages will be received at least once (as opposed to exactly once). If this is affecting how messages are processed on your end, then we suggest deduping webhook messages based on the message_id.