GlossaryTopic

WhatsApp Quality Rating

Term 172 of 175 · Topic

In one sentence

The WhatsApp quality rating is the score (Green, Yellow or Red) that Meta assigns to each API phone number based on how users react to your messages. It determines your sending limits and can lead to the number being blocked.

Reviewed by Juan Manuel Garrido

Co-founder of VantegrateLinkedIn

WhatsApp Quality Rating definition

The WhatsApp quality rating is the health indicator Meta assigns to every phone number registered on the WhatsApp Business API. It is based on how recipients react to your messages over a rolling window of recent days: if they block you, report you as spam or, on the other hand, engage with you, the rating goes down or up. Meta expresses it as a simple three-state traffic light: Green (high), Yellow (medium) and Red (low).

It matters because it is not a cosmetic metric: the rating is directly tied to the messaging limit you can send and to whether your number stays operational. A number that stays in Red enters a restricted status and can be disabled, cutting off a critical communication channel for sales, collections or support. Keeping the rating Green is one of the hygiene factors any serious WhatsApp integration has to protect.

The rating is calculated per phone number, not per account: a company with several numbers can have one in Green and another in Red depending on how each one is used.

How the rating is calculated

Meta does not publish the exact formula, but the main input is negative user feedback measured over a rolling window of roughly seven days: blocks and spam reports. On top of that come quality signals such as content relevance, whether messages match what the user expects, and the overall pattern of complaints. When the share of negative feedback crosses certain thresholds, the light drops from Green to Yellow and from Yellow to Red. You can see the rating in Meta's WhatsApp Manager, under phone numbers, alongside the number's status and the business portfolio's messaging limit.

The key point is that the rating is reactive and dynamic: it reflects your latest interactions, not your full history. A number that was Green can fall to Red in a few days if a mass campaign triggers a wave of blocks. The good news is that it also recovers: once the negative feedback stops, the rating climbs back on its own as the days go by.

The three states and what they mean

StatusColorWhat it meansConsequence
HighGreenUsers welcome your messagesNormal operation, you can move up a tier
MediumYellowNegative feedback has started to build upWarning sign, review content and targeting
LowRedHigh volume of blocks or reportsRisk of restricted status; stops the limit from moving up

When a number enters a restricted status (associated with low quality), Meta limits sending of marketing and utility templates until the end of the period or until quality improves. A number that keeps a low quality rating can, in the worst case, be disabled. What each restriction notice means and how to get out of it is covered in how to avoid getting your WhatsApp number blocked.

What damages it (common mistakes)

  • Sending HSM templates to cold or purchased lists without a genuine opt-in.
  • Overusing low-relevance marketing templates instead of the utility or service messages the user expects.
  • Ignoring opt-outs: continuing to message someone who asked not to be contacted guarantees reports.
  • Generic, poorly targeted messages or excessive frequency.
  • Not respecting the 24-hour window and forcing templates when an open conversation would have been enough.

How to protect it (best practices)

The core defense is relevance and consent. Getting a genuine opt-in, segmenting your audience, personalizing content and giving users a clear reason to want the message are the levers that keep the rating Green. It also helps to keep a healthy balance between utility and marketing templates, send at reasonable hours and remove contacts who never engage. For companies just getting started, ramping up volume gradually avoids a concentrated hit of negative feedback.

A concrete example (Argentina / Latin America)

A retail chain in Buenos Aires moved its promotions from email to WhatsApp and, in its excitement, fired a marketing template at its entire list of 80,000 contacts without filtering by recent engagement. Within 48 hours the number went from Green to Red: thousands of people who were not expecting the message blocked or reported it. The number was restricted right before a clearance-sale weekend, which also cut off the order status notifications customers actually wanted. The typical lesson in Latin America: keep the service number (transactional notifications, high relevance) separate from the marketing number, and grow volume step by step so you don't burn the rating.

How it differs from related concepts

The quality rating is often confused with the messaging limit (tiers), but they are not the same: the rating measures quality (how users perceive you), while the tier measures capacity (how many unique users you can start a conversation with per day). They are related, because a good rating is a condition for moving up a tier, but a number can be in the highest tier and still drop to Red if quality collapses. Protecting the rating ultimately means protecting the operational continuity of everything that runs through WhatsApp.

In practice

An electronics chain that burned its number

An electronics retail chain in Bogotá bought a contact list and sent the same promotion to everyone. Within a week, blocks and reports turned the number Red and its scaling was frozen right before peak season. The team spent the following month sending only utility messages to customers with a genuine opt-in until it got back to Green. The lesson went into the internal playbook: on WhatsApp, a purchased list costs more than one you built yourself.

Share
Frequently asked questions

FAQs about WhatsApp Quality Rating

What is the WhatsApp quality rating?

It is the quality score Meta assigns to each phone number registered on the WhatsApp Business API, based on how users react to your messages (blocks, spam reports and engagement). It is shown as a three-state traffic light: Green (high), Yellow (medium) and Red (low). It determines your sending limits and can lead to the number being restricted or disabled.

How is the WhatsApp quality rating calculated?

Meta does not publish the exact formula, but the main factor is negative user feedback over a rolling window of about seven days: the number of blocks and spam reports, weighted by content relevance. When the share of complaints exceeds certain thresholds, the light drops from Green to Yellow and then to Red. It is dynamic: it reflects recent interactions, not your entire history.

What happens if my WhatsApp number's quality rating turns Red?

A number with low quality enters a restricted status: Meta limits sending of marketing and utility templates until the period ends or quality improves. If low quality persists over time, the number can, in the worst case, be disabled, cutting off the channel. The good news is that the rating recovers on its own if negative feedback stops over the following days.

How do I improve or recover my WhatsApp quality rating?

The rating improves once negative feedback stops. In practice: get genuine opt-in, segment your audience and send only to people who expect the message, prioritize relevant, useful content over mass marketing, honor opt-outs immediately and remove contacts who never engage. Because it is a rolling metric covering a few days, sustaining good practices is enough for the light to climb back up.

Is the WhatsApp quality rating the same as the messaging limit?

No. The quality rating measures quality (how users perceive your messages), while the messaging limit, or tier, measures capacity (how many unique users you can contact per day). They are linked, because a good rating is required to move up a tier, but they are different metrics: a number can have a high tier and still drop to Red if quality deteriorates.

WhatsApp connected to your CRM

We connect the WhatsApp Business API to your CRM so several people can work the same number, every conversation is logged and campaigns become measurable. Tell us how you handle it today.

Keep exploring

Related terms

We solve it with

WhatsApp integration

How to connect the WhatsApp Business API to your CRM so every conversation is logged and measurable.

How the WhatsApp integration solves it
The full suite
Now that you know what it is, see how it gets solved

Five AI products that work on top of the CRM you already use. They don't replace your system: they add the layer you do by hand today.