Summary
Wati provides webhook events that help you monitor updates related to WhatsApp message templates in real time. These webhook events allow you to track template review status changes, quality rating updates, and category updates directly from your systems.
You can use these webhooks to automate workflows, monitor template health, notify admins about important changes, and keep your internal systems synchronized with the latest template updates.
Note: For more information about Wati webhooks, refer to the Wati developer documentation.
Instructions
1. Template status update
Triggered when: The review status of a WhatsApp template changes
Event:
templateReviewedStatus: Template status updated
Sample webhook payload
{
"eventType": "templateReviewed",
"wabaId": "1111111",
"templateName": "qweqw",
"templateId": "1982737699205572",
"watiTemplateId": "68aeb8ca3463af036eff5dba",
"oldTemplateStatus": 1,
"newTemplateStatus": 2,
"channelId": null,
"channelPhoneNumber": "17735704742"
}Template status codes
Status code | Status |
| Draft |
| Pending |
| Approved |
| Rejected |
| Deleted |
| Pending Internal |
| Disabled |
| Paused |
Use cases
Track template approval and rejection updates automatically
Notify admins when templates are rejected or paused
Sync template status changes with external systems
Build dashboards for template monitoring and reporting
Trigger workflows when templates become approved or disabled
2. Template quality update
Triggered when: The quality rating of a WhatsApp template changes
Event:
templateQualityUpdatedStatus: Template quality updated
Sample webhook payload
{
"eventType": "templateQualityUpdated",
"templateId": "1405047553933887",
"wabaId": "1111111",
"templateName": "qweqw",
"watiTemplateId": "68aea8bf4b1585cba9ad8a6c",
"oldTemplateQuality": 0,
"newTemplateQuality": 1,
"channelId": null,
"channelPhoneNumber": "17735704742"
}Template quality rating codes
Quality code | Quality rating |
| Unknown - indicates quality pending |
| Green - indicates high quality |
| Red - indicates low quality |
| Yellow - indicates medium quality |
Use cases
Monitor template quality changes automatically
Alert admins when template quality drops to yellow or red
Track template health across multiple WhatsApp numbers
Build internal dashboards for template quality monitoring
Trigger reviews or updates for low-performing templates
3. Template category update
Triggered when: The category of a WhatsApp template changes
Event:
templateCategoryUpdatedStatus: Template category updated
Sample webhook payload
{
"eventType": "templateCategoryUpdated",
"templateId": "3355991204552950",
"wabaId": "1111111",
"templateName": "qweqw",
"watiTemplateId": "68aea8bf4b1585cba9ad8a6a",
"oldTemplateCategory": "UTILITY",
"newTemplateCategory": "MARKETING",
"channelId": null,
"channelPhoneNumber": "17735704742"
}Supported template categories
MARKETINGUTILITYAUTHENTICATION
Use cases
Monitor template category changes automatically
Sync template categories with external systems
Notify admins when a template category changes
Validate template usage against internal policies
Build reporting dashboards for template categorization
Best practices
Store identifiers such as
templateIdandwatiTemplateIdfor trackingMonitor template quality regularly to avoid template restrictions
Use webhook events to automate notifications and reporting
Keep internal systems synchronized with template updates from Wati and Meta
Frequently Asked Questions (FAQs)
General overview
1. What do template update webhooks in Wati help track?
Template update webhooks in Wati help track WhatsApp message template review status changes, quality rating updates, and category updates in real time.
2. Why should businesses use template update webhooks?
Businesses can use template update webhooks to automate workflows, monitor template health, notify admins about important changes, and keep internal systems synchronized with the latest template updates.
Template status update webhook
3. When is the templateReviewed webhook event triggered?
The templateReviewed webhook event is triggered when the review status of a WhatsApp template changes.
4. What template statuses are supported in the Template Status Update webhook?
The Template Status Update webhook supports the following statuses:
0— Draft1— Pending2— Approved3— Rejected4— Deleted5— Pending Internal6— Disabled7— Paused
5. What can the Template Status Update webhook be used for?
The Template Status Update webhook can be used to track approval and rejection updates, notify admins about paused or rejected templates, synchronize status changes with external systems, and trigger workflows based on template status updates.
Template quality update webhook
6. When is the templateQualityUpdated webhook event triggered?
The templateQualityUpdated webhook event is triggered when the quality rating of a WhatsApp template changes.
7. What quality ratings are supported in the Template Quality Update webhook?
The Template Quality Update webhook supports the following quality ratings:
0— Unknown1— Green2— Red3— Yellow
8. What can the Template Quality Update webhook be used for?
The Template Quality Update webhook can be used to monitor template quality changes, alert admins when template quality drops, track template health across WhatsApp numbers, and trigger reviews for low-performing templates.
Template category update webhook
9. When is the templateCategoryUpdated webhook event triggered?
The templateCategoryUpdated webhook event is triggered when the category of a WhatsApp template changes.
10. Which template categories are supported in the Template Category Update webhook?
The Template Category Update webhook supports the following template categories:
MARKETINGUTILITYAUTHENTICATION