Please Wait...
Receive delivery events and automate workflows.
WhatsApp API Webhooks allow your application to receive real-time updates whenever important WhatsApp events occur. Instead of continuously checking the API for changes, your application automatically receives event notifications at a secure webhook URL.
SPRL allows you to configure your webhook endpoint, generate a webhook secret, choose which events you want to receive, and enable or disable webhook notifications from the Webhook settings page.
| Setting | Description |
|---|---|
| Webhook Name | A descriptive name for your webhook configuration. |
| Webhook URL | The HTTPS endpoint that will receive webhook events. |
| Secret Key | Used to verify webhook requests using HMAC SHA256 signatures. |
| Generate | Create a secure webhook secret automatically. |
| Status | Enable or disable webhook notifications. |
Choose the events that your application should receive.
| Event | Description |
|---|---|
| Message Received | Triggered when a customer sends a message. |
| Message Sent | Triggered after a message has been sent. |
| Message Delivered | Triggered when message delivery is confirmed. |
| Message Read | Triggered when a recipient reads a message. |
| Message Failed | Triggered if message delivery fails. |
| Message Replied | Triggered when a customer replies. |
| Conversation Started | Triggered when a new conversation begins. |
| Template Approved | Triggered when a template is approved. |
| Template Rejected | Triggered when a template is rejected. |
| Template Paused | Triggered when a template is paused. |
| Template Disabled | Triggered when a template is disabled. |
Every webhook request includes security information that your application can use to verify the request.
| Header | Purpose |
|---|---|
| Content-Type | Identifies the request format. |
| User-Agent | Identifies the webhook sender. |
| X-Webhook-Event | Specifies the event type being delivered. |
| X-Webhook-Signature | Contains the HMAC SHA256 signature used to verify the request. |
The Webhook Status panel provides information about your current webhook configuration.
| Status Item | Description |
|---|---|
| Last Tested | Most recent webhook test. |
| Last Success | Most recent successful webhook delivery. |
| Last Failure | Most recent failed webhook request. |
| Failure Count | Total number of failed webhook deliveries. |
Verify that webhook notifications are enabled, your Webhook URL is correct, and your endpoint is publicly accessible.
Check your application logs, verify the endpoint returns an HTTP 200 response after processing requests, and review the Failure Count in the Webhook Status panel.
Ensure your application uses the same Secret Key configured in the Webhook settings to validate the HMAC SHA256 signature.
Confirm that the required event checkboxes are selected before saving your webhook configuration.
Webhooks notify your application automatically whenever selected WhatsApp events occur.
Yes. You can select individual message, conversation, and template events from the Webhook Configuration page.
The Secret Key allows your application to verify that incoming webhook requests are authentic using HMAC SHA256 signatures.
The Webhook Status panel displays the latest successful and failed webhook activity, along with the total failure count.
Our support team is always happy to assist you.
We use cookies to improve your experience, analyse traffic, and personalise content. By clicking “Accept”, you consent to the use of cookies as described in our Cookie Policy .
Accept cookies Read our Cookie Policy
