message_template_quality_update webhook reference | Developer Documentation

Respond to a change in WhatsApp template quality

A template's quality can change after it has been approved. When you notice a lower rating or receive a quality notice, identify the affected template and review the campaigns that use it before increasing their volume. This guide covers that change; the quality guide explains the ratings and general campaign practices.

Confirm which template changed

1. Open your account at wtargeted.com, the preferred place to check template quality. Match the template name and language to the connection used by your campaign.
2. Record the current rating and the time you checked it, including the time zone. If you have an earlier notice or screenshot, compare the same template and language. An unavailable earlier rating does not establish when a change happened.
3. You can also check the connected WhatsApp Business Account in WhatsApp Manager or ask ChatArchitect support. If the tools show different information, provide both observations and their times.
4. Check the current template status separately. A quality rating does not establish that the template is active or that a particular message was delivered.

Review the workflows using it

List the campaigns and automated messages that select this template and language. Check each connected CRM, help desk or custom sending service; a notice about one template does not identify every workflow that uses it.

• For a drop to medium or low quality, review recipient expectations, consent, recent audience changes and sending frequency. Decide whether to reduce or pause the affected sends using the controls available in your tool.
• If the template has been paused or disabled, stop new sends using it and follow the template pause guide. If your tool has no applicable control, ask its administrator or ChatArchitect support to check the workflow.
• Keep the outcomes of messages already submitted separate from the template rating. Check the delivery-status guide before deciding which recipients need another attempt.
• Before resuming, review the current template status, the adjusted audience and any queued or scheduled sends. A better quality rating is not proof that earlier attempts reached their recipients.

Example: an order follow-up drops from high to medium quality

You have a screenshot showing high quality before a campaign and now see medium quality for the same template and language. Compare the recipient selection and frequency of the recent campaign with earlier sends. Record the change and review automated follow-ups that use this template. Assess delivery from individual message outcomes; the rating alone does not show which contact received a message.

When to contact support

Provide the connected tool and business number, template name and language, current rating and status, the earlier observation if available, check times with time zone, and affected workflows. Describe any recent audience or frequency change. Use redacted screenshots and keep App key and Secret out of them.

For an application that needs automatic notices

Meta names its direct developer event message_template_quality_update; its official reference describes a template quality change. The current ChatArchitect API quick start does not document forwarding this event to a customer callback. Confirm availability and the event contract with support before automating a campaign action. Until then, use the account checks above. See the ChatArchitect webhook overview for documented message events.