Webhooks
Receive real-time notifications for messages, deliveries, orders, and more. Build reactive integrations that respond instantly to customer activity.
Real-time Events
Instant notifications within milliseconds of activity
Secure Delivery
HMAC signatures to verify webhook authenticity
Auto Retry
Failed deliveries are retried with exponential backoff
Setting up Webhooks
- 1
Create a webhook endpoint
Set up an HTTPS endpoint on your server to receive POST requests.
- 2
Register your webhook
Use the API or dashboard to register your endpoint URL and select events.
- 3
Verify signatures
Validate the X-WAB2C-Signature header to ensure requests are from WAB2C.
- 4
Return 200 OK
Respond with a 200 status within 5 seconds to acknowledge receipt.
Webhook Events
Available Events
message.receivedTriggered when a new message is received from a customer
{
"event": "message.received",
"timestamp": "2025-01-15T10:30:00Z",
"data": {
"messageId": "wamid.xxx",
"from": "923300003097",
"type": "text",
"text": { "body": "Hi, I want to place an order" },
"contact": {
"name": "Ahmed Khan",
"wa_id": "923300003097"
}
}
}Ready to build?
Start receiving real-time events from your WhatsApp Business account.