> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp quality rating: what it means and how to recover

> Learn how Meta rates your WhatsApp number and templates as Green, Yellow or Red, what pulls the rating down, and how to recover before sending is limited.

Every WhatsApp business phone number carries a **quality rating**, and every message template has its own **template quality rating**. Meta uses both to decide whether you can keep sending freely, whether templates stay active, and whether your [messaging limit](https://knowledge.flowella.io/whatsapp/limits/messaging-limits.md) can grow.

Phone number ratings work like a traffic light:

* **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.

This page covers what Meta documents, what you see in Flowella and WhatsApp Manager, and how quality connects to delivery errors such as [131048](https://knowledge.flowella.io/whatsapp/errors/error-131048.md).

> [!NOTE]
>
> **In Flowella.** Partly supported. Flowella shows template quality as pills on the templates list, shows a red banner and notifies everyone when a number drops to Yellow or Red, and records each change Meta reports. It doesn't show each number's current rating: check that in WhatsApp Manager. See [What Flowella shows](#what-flowella-shows).

## What quality affects

| Area | Effect of a low rating |
| - | - |
| [Messaging limit](https://knowledge.flowella.io/whatsapp/limits/messaging-limits.md) | Low quality slows or stops the portfolio scaling up. Since 7 October 2025 it no longer **lowers** a limit you already have. |
| [Throughput](https://knowledge.flowella.io/whatsapp/limits/throughput.md) | A number needs a Medium (Yellow) rating or better to be upgraded to 1,000 messages per second. |
| Sending | A number with persistent quality problems can have sends blocked with [131048](https://knowledge.flowella.io/whatsapp/errors/error-131048.md). |
| Templates | A template rated Red is paused, and the third pause disables it. See [Template pacing and pausing](https://knowledge.flowella.io/whatsapp/limits/template-pacing-and-pausing.md). |

The **Flagged** state that numbers used to get after a quality drop no longer exists. Before 7 October 2025, a number Flagged for 7 days dropped one messaging limit level.

## Phone number quality rating

Meta gives each business phone number a `quality_rating`, returned by the Phone Numbers API. WhatsApp Manager shows the same rating under a different name, under **Account tools** → **Phone numbers**.

| API value | WhatsApp Manager | Flowella |
| - | - | - |
| `GREEN` | High | No alert |
| `YELLOW` | Medium | **WhatsApp quality rating** notification |
| `RED` | Low | Notification and a red banner on every page |

Meta reports each change with a `phone_number_quality_update` webhook.

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

Recent behaviour counts more than old history, and high send volumes are judged more strictly than a low-volume number that is warming up.

> [!TIP]
>
> For Meta's own wording on number quality in WhatsApp Manager, see Meta's Help Center article [*About your WhatsApp Business phone number's quality rating*](https://www.facebook.com/business/help/896873687365001), which Meta's phone numbers documentation links to.

## 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:

| API score | WhatsApp Manager label | Meaning |
| - | - | - |
| `GREEN` | Active - High quality | Little or no negative feedback. The template can be sent |
| `YELLOW` | Active - Medium quality | Negative feedback or low read rates. It can still be sent, but may soon be paused or disabled |
| `RED` | Active - Low quality | Negative feedback or low read rates. It can still be sent, but is in danger of being paused or disabled soon |
| `UNKNOWN` | Active - Quality pending | A new template without enough feedback yet. The template can be sent |

New templates start as `UNKNOWN`. Quality feeds into **template pacing** and **template pausing**: a template without a Green rating can be paced, and a Red template is paused. See [Template pacing and pausing](https://knowledge.flowella.io/whatsapp/limits/template-pacing-and-pausing.md). If a template's status changes from approved to anything else, you can't send it until Meta approves it again.

Meta reports template quality changes with a `message_template_quality_update` webhook, and pauses and disables with `message_template_status_update`. Flowella updates the pills from both.

Official reference: Meta's [template quality rating](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality) page.

In Flowella, the templates list marks paused, disabled and low-quality templates with pills. See [Delivery-health pills on the templates list](https://knowledge.flowella.io/app/templates.md#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:

> [accordion] 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.

> [accordion] 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).

> [accordion] 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](https://knowledge.flowella.io/troubleshooting/template-rejected.md).

> [accordion] 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](https://knowledge.flowella.io/whatsapp/accounts/profile-setup.md).

## 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](https://knowledge.flowella.io/settings/notification-preferences.md).

| Notification | When it's sent | Preference name |
| - | - | - |
| WhatsApp number quality changed | A number's rating drops to Yellow or Red | **WhatsApp quality rating** |
| WhatsApp Business account update | Meta restricts, suspends, bans or disables the account, or reports a policy violation | **WhatsApp account status** |
| Message template paused | WhatsApp pauses a template | **Template paused** |
| Message template disabled | WhatsApp disables a template | **Template disabled** |
| Message template quality dropped | A template's rating drops to Red | **Template quality drop** |

### 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](https://knowledge.flowella.io/app/templates.md#delivery-health-pills-on-the-templates-list).

### Failed messages and Results

When Meta blocks a send because of your number's quality ([error 131048](https://knowledge.flowella.io/whatsapp/errors/error-131048.md)), the Inbox prints the reason under the message. In [Results](https://knowledge.flowella.io/app/analytics.md#delivery-read-and-failure-rates), 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](https://knowledge.flowella.io/app/analytics.md) 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](https://knowledge.flowella.io/whatsapp/limits/messaging-limits.md) 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

| Signal | What it usually means | Guide |
| - | - | - |
| **131048** | Meta restricted sends from **your** number for spam or quality reasons | [Error 131048](https://knowledge.flowella.io/whatsapp/errors/error-131048.md) |
| **131049** | Per-user marketing limit on the recipient's side, not your portfolio limit | [Error 131049](https://knowledge.flowella.io/whatsapp/limits/per-user-marketing-limit.md) |
| Portfolio messaging limit | Unique recipients outside the 24-hour window for the **business portfolio** | [Messaging limits](https://knowledge.flowella.io/whatsapp/limits/messaging-limits.md) |
| Template paused or Red | Journeys and HubSpot actions can't rely on that template | [Template rejected](https://knowledge.flowella.io/troubleshooting/template-rejected.md), [Messages not delivered](https://knowledge.flowella.io/troubleshooting/messages-not-delivered.md) |

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](https://knowledge.flowella.io/app/analytics.md) and pause before Meta moves you to Red.

## Related guides

* [Template pacing and pausing](https://knowledge.flowella.io/whatsapp/limits/template-pacing-and-pausing.md): held, paused and disabled templates
* [Throughput](https://knowledge.flowella.io/whatsapp/limits/throughput.md): the 1,000 messages per second upgrade needs Medium quality
* [Messaging limits](https://knowledge.flowella.io/whatsapp/limits/messaging-limits.md): portfolio limits that quality helps unlock
* [Error 131048](https://knowledge.flowella.io/whatsapp/errors/error-131048.md): spam or quality restrictions on your number
* [Error 131049](https://knowledge.flowella.io/whatsapp/limits/per-user-marketing-limit.md): healthy ecosystem engagement
* [Messages not delivered](https://knowledge.flowella.io/troubleshooting/messages-not-delivered.md): delivery troubleshooting
* [Templates](https://knowledge.flowella.io/app/templates.md): pills, pauses and held sends
* [Managing opt-outs](https://knowledge.flowella.io/app/opt-outs.md): keep consent clean
* [Template rejected](https://knowledge.flowella.io/troubleshooting/template-rejected.md): category and approval issues

Checked against Meta's documentation on 18 November 2026: [Template quality](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality), [Changes to messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/upcoming-messaging-limits-changes) and [Throughput](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.