Webhook events
Every WhatsApp webhook event with its payload: incoming messages, message statuses, template updates, number quality and account alerts.
These are the events DoveMesh sends to your webhook. Every request is a POST with a JSON body in the same envelope:
json
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "105954558954427",
"changes": [{ "field": "messages", "value": { } }]
}
]
}field says which event it is, and value holds the details. Each page below shows the fields and example payloads.
- Incoming messageWhatsApp webhook for incoming messages: text, media, button and list replies, reactions, orders, locations and ad referrals, with examples.
- Message statusWhatsApp webhook for message statuses: sent, delivered, read and failed, with pricing details and error codes.
- Template statusWhatsApp webhook sent when a message template is approved, rejected, flagged, paused or disabled.
- Template category changedWhatsApp webhook sent when WhatsApp moves one of your message templates to another category.
- Template quality changedWhatsApp webhook sent when a message template's quality rating changes.
- Display name reviewedWhatsApp webhook sent when your number's display name is approved or rejected.
- Number quality and limit changedWhatsApp webhook sent when your number's quality rating or daily messaging limit changes.
- Account updatedWhatsApp webhook for account changes: verification, policy violations, restrictions and bans.
- Account alertWhatsApp webhook for account alerts, such as a declined request to raise your messaging limit.
- Account reviewedWhatsApp webhook sent when WhatsApp finishes reviewing your WhatsApp Business Account.
- Business limits changedWhatsApp webhook sent when your business's messaging limit or number limit changes.