It is important to build and maintain a high quality customer experience on WhatsApp, so that customers can keep using this channel to communicate with your business. To protect our users, WhatsApp has a reporting and blocking mechanism. If a user doesn't like the experience they get, they might block or report your business number.
A block or report action against your business keeps you from contacting those users and impacts your phone number reach and the template availability. Learn more on Phone Number Quality docs and Message Template Guidelines docs.
To help you keep a high quality experience for your customers, we recommend that you monitor the quality signals (via WhatsApp Business Management API and WhatsApp Manager UI) to assess how your messages are being received by users and act on relevant updates as quickly as possible.
We recommend using webhooks to monitor phone number and message template quality. Then, you can act whenever there is a need, like when quality is Low or status is Flagged.
If the information you need is still not available via webhooks, you can alternatively call the WhatsApp Business Management API.
The following webhooks and APIs provide real-time information and updates. For now, they don't provide historical data —check the next section of this document to learn how to use the WhatsApp Manager UI to get the last 30 days’ quality ratings.
To get notified when a phone number quality status changes, subscribe to the
phone_number_quality_update webhook. You must subscribe to each WhatsApp Business Account you'd like to get the updates.
What to watch for: the Flagged status. Flagged status occurs when the quality rating reaches a low state. If the message quality improves to a high or medium state and maintains this for 7 days, your status will return to Connected. If the quality rating doesn't improve, your status will still return to Connected, but you'll be placed in a lower messaging limit tier. Learn more on Phone Number Quality docs.
Make this call once in a while to follow your phone number’s quality rating:
curl -X GET \ 'https://graph.facebook.com/
Be mindful these calls will count against the API limits, while the webhooks will not.
What to watch for: Any quality ratings different than High. They indicate negative feedback from users and may impact the phone number reach. Learn more on Phone Number Quality docs.
Subscribe to the
message_template_status_update webhook to get notified when the message template status changes, by being approved or rejected, or if it has been flagged disabled. You must subscribe to each WhatsApp Business Account you'd like to get the updates.
What to watch for: The Flagged status. This status indicates negative feedback from users. After a template enters Flagged status, if the quality rating does not improve within 7 days, the template across all languages will be Disabled. Learn more on Message Template Guidelines docs.
On Business Manager, go to the WhatsApp Manager and look for the following tabs:
We also recommend you to implement your own internal trackers on the conversation tree. This way, once you receive a signal on webhooks that indicates negative feedback from users (quality rating = medium or low, status = Flagged), you can investigate your own trackers to try to understand where you can improve the conversation experience.
As an example, these are a two places you can add internal trackers to:
Monitor how much time it takes for you to answer client messages. Ideally this should be instant, so watch out for increases and peaks. Important metrics: first message response time and average response time.
Check if users are getting through the entire messaging journey you planned.
A few questions to help you analyze metrics:
With this measurement in place you can run A/B testing and see if changes in the experience improves user feedback. Some things you could try to test if it improves the experience:
After the test, analyze the new metrics and compare them to the old ones.