WhatsApp Business API Quality Rating Explained: Green, Yellow & Red
Meta scores every WhatsApp API number based on how recipients react to your messages. Get it wrong and your daily messaging limit shrinks. Here's exactly how the quality rating system works — and how to stay Green.
The WhatsApp Business API quality rating is Meta's rolling score (Green / Yellow / Red) of how your recipients react to messages you send via the API over the past 7 days. It is driven primarily by how many users block or report your number. A lower rating caps or reduces your daily messaging tier — how many unique users you can start a conversation with per day. Keep your rating Green and your tier can grow automatically; let it stay Red and Meta may pause your messaging.
The three quality rating levels
You can see your number's quality rating in Meta Business Manager → WhatsApp Manager → Phone Numbers. Each number shows one of three states:
Recipients are engaging positively. Low block rate. Your number is in good standing with Meta.
Eligible for tier upgrades. Can send up to your current tier limit per day.
More users than usual are blocking or ignoring your messages. This is a warning signal from Meta.
No immediate change to tier, but if Yellow persists for 7 days, Meta may downgrade your tier.
High block/report rate. Your number may be flagged and messaging limits reduced. Messaging may be paused.
Tier likely downgraded. Status may show 'Flagged' or 'Restricted'. Fix the issue immediately.
How quality rating controls your messaging tier
Meta assigns each WhatsApp API number to a messaging tier — the maximum number of unique users you can send a business-initiated (template) message to per day. Quality rating and actual sending volume both determine whether you stay in a tier, get upgraded, or get downgraded.
| Tier | Daily unique users | Typical path |
|---|---|---|
| Tier 1 | 1,000 unique users / day | Default for new numbers |
| Tier 2 | 10,000 unique users / day | Auto-upgrade after consistent Green + volume |
| Tier 3 | 100,000 unique users / day | High-volume businesses with sustained quality |
| Tier 4 (Unlimited) | Unlimited unique users / day | Enterprise accounts approved by Meta |
What tanks your quality rating — the real causes
Quality is almost entirely driven by recipient behaviour. If users block or report your number, your rating drops. Here are the five most common causes in the Indian market:
Cold-list marketing messages
Sending template messages to contacts who never gave you their number or opted in. They block you immediately — this is the fastest way to tank quality.
Too-frequent messages
Sending multiple marketing messages in a week to the same contact. Even opted-in customers get annoyed if you spam them. High frequency → more blocks.
Vague or misleading template language
Templates that say 'Exclusive offer — open now!' with no context. Recipients who don't recognise the sender just block. Clear, specific templates perform better.
Purchased or scraped contact lists
Bought database → almost no one opted in → very high block rate. Meta's algorithm is sensitive to sudden spikes in blocks from large campaigns.
No easy unsubscribe path
If contacts can't easily say 'stop messaging me', they block instead. A simple 'Reply STOP to unsubscribe' button reduces blocks and protects your rating.
Note: service conversations (within the 24-hour window when a customer messages you first) do not significantly affect quality rating — the customer chose to contact you. Quality drops come from business-initiated template messages sent to people who didn't ask for them.
How to improve — and maintain — a Green rating
Recovering from Yellow or Red is possible within days if you fix the underlying sending behaviour. Here's what works:
Send only to opted-in contacts
If someone gave you their number voluntarily — via IndiaMart, a web form, or a store visit — they're far less likely to block you.
Limit marketing message frequency
No more than 1–2 marketing messages per week per contact. For transactional or utility messages (order updates, reminders), frequency matters less.
Segment your lists tightly
Send a real-estate follow-up only to leads who asked about a property, not your whole database. Relevance is the best spam filter.
Add an unsubscribe quick-reply button
Meta recommends including an opt-out option. Contacts who opt out are removed from your campaigns — better than having them block you.
Prefer utility and service conversations
Appointment reminders, order updates, and payment confirmations land well because they're expected. They don't hurt quality rating the way cold marketing does.
How to check your quality rating — step by step
- 1Open Meta Business Manager (business.facebook.com)
- 2Go to WhatsApp Manager in the left sidebar
- 3Click Phone Numbers to see all WABA numbers
- 4Each number shows: Quality Rating (Green/Yellow/Red), Messaging Limit (Tier 1–4), and Status (Active / Flagged / Restricted)
- 5Click on a number to see a quality breakdown over the last 30 days, including which template messages may be contributing to a poor rating
Your BSP (Business Solution Provider) dashboard may also surface quality rating. If you're using 3Sigma as your WhatsApp CRM, check your WABA phone number health in Meta Business Manager directly.
A real scenario: Deepak's real estate team in Hyderabad
Deepak runs a 10-agent real estate team in Hyderabad. In May, he bought a database of 5,000 property-seekers from a local data vendor and sent a WhatsApp template blast promoting a new project launch.
Within 48 hours, his quality rating dropped from Green to Yellow. By day 4, it hit Red. Meta placed his number in 'Flagged' status and cut his messaging tier from Tier 2 (10,000/day) back to Tier 1 (1,000/day).
The fix: he stopped all marketing campaigns, removed the purchased list, and for 2 weeks sent only utility messages (site-visit reminders, document requests) to leads who had already spoken to his team. By day 10, his rating was back to Green and Tier 2 was restored.
The lesson: quality is about who you send to, not just what you send. Opted-in leads who know your business don't block you. Cold databases do.
How 3Sigma helps keep your WhatsApp quality Green
3Sigma's WhatsApp campaigns are built on the official WhatsApp Business API — so you're never using unofficial tools that violate Meta's terms. A few things that help protect quality:
Official WABA only
All messages go through Meta's approved API. No third-party hacks or unofficial automation that risk your number.
Opt-in list segmentation
Segment your campaigns by lead source and status — so you send real-estate follow-ups only to leads who came from 99acres, not your whole database.
WABA-approved templates
3Sigma's template manager helps you submit and track WhatsApp template approvals — only approved templates go out.
Full lead history
Every lead in the CRM has a full history of WhatsApp chats, calls and follow-ups. You can see who's engaged and who's not — and stop messaging unresponsive contacts.
See 3Sigma's WhatsApp CRM → or read: Why WhatsApp accounts get banned and how to avoid it
WhatsApp quality rating — FAQs
What is the WhatsApp Business API quality rating?
The quality rating is Meta's measure of how your recipients perceive messages sent from your WhatsApp Business API number. It is calculated based on user actions over the past 7 days — primarily how many people are blocking or reporting your number as spam. Green means high quality, Yellow means medium, Red means low.
How does quality rating affect my messaging limit?
WhatsApp Business API numbers are assigned to a messaging tier that caps how many unique users you can start a conversation with per day. Tier 1 = 1,000 unique users/day; Tier 2 = 10,000/day; Tier 3 = 100,000/day. If your quality stays Yellow or Red for 7 consecutive days, Meta may downgrade your tier. Conversely, consistently Green quality and high volume can unlock a tier upgrade.
Where can I check my WhatsApp API quality rating?
Open Meta Business Manager, go to WhatsApp Manager → Phone Numbers. Each number shows its current quality rating (Green/Yellow/Red), its messaging tier, and whether its status is Active, Flagged, or Restricted. Your BSP (Business Solution Provider) dashboard may also surface this.
What causes a WhatsApp API quality rating to drop?
The main causes are: sending marketing template messages to cold contacts who never opted in, sending too frequently so users get annoyed and block you, using vague or clickbait template language that confuses recipients, and sending bulk campaigns to purchased or scraped lists. A high block rate is the single biggest trigger.
How long does it take to recover from a Yellow or Red rating?
Quality ratings are calculated on a rolling 7-day window. If you stop sending bad messages and your block rate falls, the rating can recover within days. However, if your number was placed in 'Flagged' status (which happens when quality drops to Red for 7 days), you'll need to stay at an improved quality level for 7 days before Meta lifts restrictions.
Do service conversations (customer replies) affect quality rating?
User-initiated service conversations (within the 24-hour window) do not negatively affect quality rating — the customer chose to message you. Quality rating is primarily affected by template-initiated (business-initiated) conversations where users receive messages they didn't ask for. Focus on sending only relevant, opted-in template messages.
Can I upgrade from Tier 1 to Tier 2 without applying?
Yes — tier upgrades happen automatically. If your quality is Green and you consistently send high volumes close to your current tier limit, Meta will automatically upgrade your tier within 24 hours. You cannot manually request a tier upgrade; it is based on quality + volume performance.
Send WhatsApp campaigns that stay in the Green
3Sigma's WhatsApp CRM runs on the official API with proper opt-in capture, list segmentation, and template management — the foundations of a healthy quality rating.
Also read: WhatsApp API pricing in India · Broadcast on WhatsApp without getting banned