Webhooks provide real-time notifications for WhatsApp events. Receive instant updates when messages are delivered, read, or when template status changes occur.
When specific events occur in your WhatsApp account, TheQuickAssist sends a POST request to your configured webhook URL with event details. This enables real-time integration with your backend systems.
Message sent, delivered, or read
Webhook payload sent to your URL
Your server handles the notification
Triggered when a message is successfully delivered to the recipient's device.
Triggered when the recipient reads your message (blue ticks).
Triggered when a template's approval status changes (pending → approved/rejected).
Triggered when message delivery fails (invalid number, user blocked, etc.).
Example webhook payload for a message delivery event:
{
"event": "message.delivered",
"timestamp": "2024-01-15T10:30:00Z",
"data": {
"messageId": "msg_123456789",
"recipient": "+1234567890",
"template": "welcome_message",
"deliveredAt": "2024-01-15T10:30:00Z",
"deviceType": "android"
},
"webhookId": "whk_abc123"
}Set up a public HTTPS endpoint on your server that can receive POST requests. The endpoint must return a 200 status code to acknowledge receipt.
In your dashboard, go to Settings → API & Webhooks → Webhooks. Enter your endpoint URL and select the events you want to receive.
https://yourdomain.com/webhooks/thequickassistVerify webhook signatures to ensure requests are from TheQuickAssist:
const signature = req.headers['x-webhook-signature'];
const payload = JSON.stringify(req.body);
const expected = crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(payload)
.digest('hex');
if (signature !== expected) {
return res.status(401).send('Invalid signature');
}Explore all available API endpoints for managing webhooks programmatically.
View Endpoints