- Green: high quality. Sending is normal, and your limit can grow when the other criteria are met.
- Yellow: medium quality. Treat it as a warning and tighten audiences and frequency before the rating slips further.
- Red: low quality. Expect restrictions. A number that stays Red can be heavily limited.
Phone number quality rating
Meta gives each business phone number aquality_rating (for example GREEN, as returned by the Phone Numbers API). WhatsApp Manager shows each number’s status under Account tools → Phone numbers.
Meta doesn’t publish exact block-rate thresholds. In practice, ratings move when recipients:
- Block your business number
- Report your messages as spam
- Show weak engagement (few reads or replies) compared with your volume
Template quality rating
Separately, every template has a quality rating based on usage, customer feedback and engagement. Meta reports it through the Template API and shows it in WhatsApp Manager’s Manage templates panel:
New templates start as
UNKNOWN. Quality feeds into template pacing and template pausing. If a template’s status changes from approved to anything else, you can’t send it until Meta approves it again.
Official reference: Meta’s template quality rating page.
In Flowella, the templates list marks paused, disabled and low-quality templates with pills. See Delivery-health pills on the templates list.
Why number ratings move down
Most drops come from audience and frequency problems, not a single “bad” template:Sending to people who never opted in to WhatsApp
Sending to people who never opted in to WhatsApp
A phone number collected years ago for SMS or checkout is not WhatsApp consent. Unexpected marketing templates lead to blocks. Prefer contacts who recently opted in to WhatsApp.
Sending too often to the same people
Sending too often to the same people
WhatsApp feels more personal than email. High frequency per recipient raises block and report rates. Cap outbound templates in HubSpot workflows (for example, at most one marketing template per recipient per week unless they replied).
Content that doesn't match the consent you hold
Content that doesn't match the consent you hold
Marketing content sent to people who only agreed to service updates (or the reverse) causes complaints. Match the template’s category and copy to the consent you hold. See Template rejected.
A display name customers don't recognise
A display name customers don't recognise
If the display name doesn’t match the brand the customer remembers, they may treat the chat as spam. Use a name customers recognise. See Display name and profile.
What Flowella shows
Flowella doesn’t display the rating of each phone number. Check it in WhatsApp Manager → Account tools → Phone numbers. Flowella alerts you when quality causes problems.Red banner
When any connected number is rated Red, or Meta has restricted or banned the account, every page in Flowella shows “WhatsApp quality or account status needs attention. Open Meta Business Suite and resolve restrictions before sending is affected.”Notifications
Flowella notifies you when Meta changes something that affects sending. These notifications are always on in-app and by email. See Notification preferences.Template pills
The templates list shows Quality: Yellow, Quality: Red, Paused by WhatsApp, Quality pause 1/3 (the count rises with each pause) and Disabled by WhatsApp. Pacing pauses also get an Unpause button. See Delivery-health pills on the templates list.Failed messages and Results
When Meta blocks a send because of your number’s quality (error 131048), the Inbox prints the reason under the message. In Results, delivery and failure rates over time help you spot the campaign that caused blocks.How to recover from Yellow
Most Yellow ratings recover within several days if you change behaviour straight away:1
Pause aggressive outbound
Stop marketing sends to cold or disengaged lists for at least 24 hours.
2
Find the cause
Check Results in Flowella and WhatsApp Manager to see which campaign or template lines up with the drop.
3
Tighten the audience
Target recent opt-ins and contacts who have replied recently in your next sends.
4
Lower volume
Send to fewer unique recipients each day while quality recovers, and keep templates at high quality so messaging limit scaling isn’t blocked.
5
Watch daily
Confirm in WhatsApp Manager that the rating moves back towards Green before you raise volume again.
How to recover from Red
Red is more serious. Meta may restrict the number while it’s Red, and a long spell at Red can stop sending.- Stop the sends that caused blocks, including marketing templates that customers are reporting.
- Ramp back slowly with engaged audiences only.
- Fix display names or template content that customers don’t recognise or didn’t expect.
- If Meta has restricted the number, wait for Meta to lift the restriction or use a different eligible number. Flowella can’t override a Meta restriction.
Quality and delivery errors
Flowella shows different failure text for 131048 (your number’s quality) and 131049 (the recipient’s marketing limit). Treat them as different problems.
Preventing drops
- Make WhatsApp opt-in explicit when you collect the number.
- Set frequency caps in HubSpot workflows.
- Segment lists rather than sending one marketing template to every phone number in the CRM.
- Watch for early failure spikes in Results and pause before Meta moves you to Red.
Related guides
- Messaging limits: portfolio limits that quality helps unlock
- Error 131048: spam or quality restrictions on your number
- Error 131049: healthy ecosystem engagement
- Messages not delivered: delivery troubleshooting
- Templates: pills, pauses and held sends
- Managing opt-outs: keep consent clean
- Template rejected: category and approval issues

