Quality monitoring
Monitor the quality of the phone numbers and templates in a WhatsApp Business Account (WABA), based on the rating Meta gives them, and list the account's phone numbers.
Available endpoints:
- List the WABA's phone numbers.
- Get the quality of the WABA's phone numbers.
- Get the quality of the WABA's templates.
All endpoints use the admin token. See Generate authentication token.
Quality rating
Meta rates the quality of each phone number (qualityRating) and each template (qualityScore) with a color:
- GREEN: high quality.
- YELLOW: medium quality.
- RED: low quality.
- UNKNOWN: Meta doesn't have enough information to rate it yet.
UNKNOWN is normal in these cases:
- New number or template: it hasn't been used enough for Meta to collect metrics such as delivery rate, blocks or spam reports.
- Low sending volume: with few messages there isn't enough data for a reliable rating. This is common in development or test environments.
- Meta's periodic evaluation: Meta recalculates quality from time to time, so there can be a delay between using a number or template and its rating.
How the information is refreshed
To avoid exhausting the request limit to Meta, the first query for a WABA gets the information from Meta and stores it for 12 hours. During that period, the service answers with the stored information without querying Meta again. Once the period ends, the next query gets fresh information from Meta.
The processedAt field in the response tells you when the information was obtained from Meta, that is, when its 12-hour period started.
Pages in this section:
- Phone numbers: list the WABA's numbers and their quality.
- Templates: check template quality.