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".

Error scenarios

  • 302-redirect: Redirects are not followed by the Webhook gateway Please ensure that there is always HTTP 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 dedup-ing Webhook messages based on the message_id. Please reach out via Customer Success Management (support@messagepipe.io) if you need to understand the current settings.