WhatsApp quality rating: the field on the Connected number card
What the Quality rating on Beacon Messenger's WhatsApp page means, where the value comes from, when it refreshes, and what to do when it reads YELLOW or RED.
Open the WhatsApp page in Beacon Messenger and the first card after the connection banner is called Connected number. It has four lines: Phone number, Display name, Quality rating and Templates. Three of them are self explanatory. The fourth, Quality rating, is a word in capitals that most merchants read once at setup, see GREEN, and never think about again. That is the right outcome, but the field is on the card because the day it stops saying GREEN is the day your order notifications start to be throttled or refused, and it helps to know what you are looking at before that happens.
Where the value comes from
It is Meta's number, not ours. When you connect a WhatsApp Business account, Beacon Messenger asks Meta's Graph API for the phone number you chose and receives its display number, the verified business name and a quality_rating field. We store all three with the connection and show them on the card. The app does not calculate anything, apply its own thresholds or combine signals; the word on the card is the word Meta returned the last time we asked.
Meta grades every WhatsApp Business phone number on how customers have reacted to its messages over the recent past, mainly whether people block the number or report it and what reason they give when they do. The grade has three levels, GREEN for high, YELLOW for medium and RED for low, and Meta's messaging limits documentation describes how the rating and the limits interact. A brand new number that has not sent much yet sometimes comes back with no rating at all; in that case the card shows Unknown rather than inventing a colour.
When it refreshes
The value is captured at three moments. It is stored when you first connect, so the card is filled in from the start. It is fetched again, together with the display name, when you press Refresh templates on the same page; that button reloads the template list and the phone number details in one go. And it is fetched again when you update the credentials of an existing connection. Disconnecting clears it along with everything else about the number.
Between those moments the card does not change. If Meta downgrades the number on a Tuesday, the card still reads GREEN until somebody presses Refresh templates. Meta emails the account administrators when the rating drops, so the email is the alert and the card is where you confirm it, not the other way round. The Last refreshed line on the templates card tells you how old the value is. If you have been inside the Meta Business Suite making changes, or a run of messages has just failed, press refresh first and then read.
What each value means for a Shopify store
| Rating | Meta's label | What it means for your notifications |
|---|---|---|
| GREEN | High quality | Nothing to do. Messaging limits can rise with volume and templates are not at risk from this number. |
| YELLOW | Medium quality | Customers have blocked or reported recent messages. Limits stop growing and Meta is watching; if it continues the number goes to RED. Find the template or the audience that caused it. |
| RED | Low quality | Meta may lower the messaging limit and restrict the number. Templates sent from it are at higher risk of being paused. Stop sending anything optional until it recovers. |
| Unknown | No rating returned | Usually a new number with too little history, or a connection made before the field was available. Press Refresh templates; if it stays Unknown there is nothing to act on yet. |
The relationship to the message log is indirect but real. A number at RED does not make the app skip anything, because the app does not read the rating when it decides to send; it hands each message to Meta and records what Meta says. What you see in the log is Meta refusing or throttling, with Meta's error text. So a sudden cluster of failed messages, a RED on the card and an email from Meta are three views of one event.
Why an order notification number goes YELLOW
Order confirmations and shipping updates are about the safest messages a business can send, so a drop usually points to one of a short list. Someone has sent a marketing style template through the same number to people who did not ask for it. A utility template has acquired a promotional tail, a discount code or a Shop now button, which makes a confirmation read like an advert. Messages are going to numbers that are not the buyer, for example a gift recipient entered at checkout who does not know your shop. Or the volume jumped, a batch fulfilment sent hundreds of shipping updates in a minute, and a fraction of the recipients reached for block because they could not place the sender.
That last one deserves a sentence because it is the one that catches stores doing everything right. Blocks are counted as a share of messages, so a hundred shipping updates with two blocks is a worse ratio than a thousand with two. If a one-off bulk send is coming, the display name and the first line of the template are the two things the recipient uses to decide whether to block, and both should name your store exactly as it appears on the order.
- Open the templates card on the same page and look for amber paused badges. A paused template and a YELLOW number usually share a cause; the template status post explains what a pause is and how long it lasts.
- Open the message log, filter to the last week and sort by template. The template with the most messages right before the drop is the first suspect.
- Read that template as a customer would. Remove anything that is not about their order. Shorter is safer.
- Check which automations send to a phone number other than the buyer's, and whether those recipients would recognise the shop.
- Press Refresh templates a week later and read the card again. Meta's window is recent, so a clean week moves the rating back on its own.
What the app does not do, and why
Beacon Messenger does not stop sending when the rating drops, does not notify you of a change and does not poll Meta for the rating on a schedule. The first is deliberate: a shop would rather have its order confirmations throttled by Meta than silently withheld by an app that decided to be cautious, and Meta already enforces its own limits. The second and third are about not duplicating Meta. Meta emails administrators on a downgrade and shows the live value in the WhatsApp Manager, so a second alert from us would arrive at the same time with less detail. The card exists so that, when you are already in the app looking at a failed message, the explanation is one scroll away.
If you want the value checked regularly, the habit is cheap: press Refresh templates on the WhatsApp page once a week, which also keeps the template badges honest, and read the Connected number card while you are there. Four lines, ten seconds, and the one that matters is still GREEN.
Questions about the WhatsApp quality rating
What does the Quality rating on the Beacon Messenger WhatsApp page mean?
It is the quality_rating Meta assigns to your WhatsApp Business phone number, shown exactly as Meta returned it: GREEN for high, YELLOW for medium, RED for low. Meta bases it on how customers reacted to recent messages, mainly blocks and reports. Beacon Messenger stores the value when you connect and does not alter or interpret it.
Why does the quality rating say Unknown?
Meta returned no rating for the number. That is normal for a new number with little sending history, and it can also happen on a connection made before the field was stored. Press Refresh templates on the WhatsApp page to fetch it again. Unknown is not a warning; a number with a real problem shows YELLOW or RED.
How often does Beacon Messenger update the quality rating?
Only when asked: at connection, when you press Refresh templates, and when you update credentials. It is not polled on a schedule, so the card can be behind Meta's current value. Meta emails account administrators when a rating drops, so treat the email as the alert and refresh the page to confirm.
Will Beacon Messenger stop sending order notifications if the rating is RED?
No. The app hands every message to Meta and records Meta's answer in the message log, so a RED number shows up as throttled or failed messages with Meta's error text rather than as messages the app skipped. Fix the template or audience that caused the drop, and the rating recovers over Meta's recent-activity window.
More guides
- WhatsApp Business app drops order tools: move orders to Shopify
- A customer replied STOP to a WhatsApp order message. Now what?
- WhatsApp marketing templates leave the Cloud API in October 2027
- WABA to Messaging Account: what changes for Shopify WhatsApp
- Order paid later, refunded or edited: which WhatsApp messages send
- Edited your WhatsApp automation? What queued messages send
- How to add a WhatsApp chat button to your Shopify store (2026)
- How to send Shopify order confirmations and shipping updates over WhatsApp with the official Cloud API
- Cash on delivery on Shopify: confirm orders over WhatsApp before you ship
- Recovering abandoned checkouts on Shopify with WhatsApp, the compliant way
- Why WhatsApp apps get your number banned: linked device vs API
- How a "free" WhatsApp app for Shopify ends up charging you
- Por qué una app de WhatsApp "gratis" para Shopify te cobra
- Pushdaddy or SuperLemon alternative: WhatsApp apps compared
- How to verify Shopify WhatsApp notifications were delivered
- Chat button still on your store after uninstalling the app?
- WhatsApp API pricing changes on Oct 1, 2026: Shopify impact
- Setting up the WhatsApp Cloud API with Meta's MCP and an AI agent
- WhatsApp chat outside business hours: what shoppers should see
- WhatsApp product sharing on Shopify: tracking dark social
- WhatsApp template rejected? Fixing Shopify order templates
- One WhatsApp number or two? Shopify notifications & support
- Shopify Canvas and Beacon Messenger: what works today
- Shopify now collects WhatsApp marketing consent at checkout. Here is what it changes
- Split shipments on Shopify: how many WhatsApp updates to send
- WhatsApp's 250-a-day messaging limit and your Shopify store
- WhatsApp, SMS or email for Shopify order notifications?
- WhatsApp is down: what happens to your Shopify order notifications
- Shopify orders with no phone number: why WhatsApp messages get skipped
- Shopify rollout discounts and WhatsApp order messages
- Add a Track order button to WhatsApp order messages
- Which Shopify orders trigger a WhatsApp message?
- The abandoned checkout timer restarts every time the shopper comes back
- Blank names, twelve-item orders: what WhatsApp merge fields fall back to
- Who looked at your customers' phone numbers? The access log behind a WhatsApp app
- Send a WhatsApp test message before your first order: what the Connect and Test buttons check
- Disconnect, update credentials, app secret: what each does
- COD reply not tagged: how Beacon Messenger matches replies
- WhatsApp template language: why name alone is not enough
- Finding one WhatsApp message in the Beacon Messenger log
- WhatsApp automation is On but nothing sends: a checklist
- Mapping WhatsApp template variables to Shopify order fields
- Every WhatsApp chat button setting in the Shopify theme editor
- WhatsApp template examples for Shopify: order, shipping, COD, cart
- The Share on WhatsApp block, setting by setting
- WhatsApp order messages when customers speak several languages
- Reading the Beacon Messenger dashboard: sent, delivered, failed, skipped
- Shopify batch fulfilment: what happens to 250 WhatsApp shipping messages
- WhatsApp template status: approved, pending, paused, disabled, and what sends
- COD returns (RTO) on Shopify: confirm orders on WhatsApp first
- WhatsApp error codes on failed messages: a reference
- WhatsApp display name: what customers see on your order messages
- Shopify Messaging WhatsApp automations vs Beacon Messenger
- OXXO, bank transfer and pay-later orders: when the WhatsApp confirmation goes out
- How many WhatsApp messages will Black Friday send? Sizing your plan
- WhatsApp usernames and BSUIDs: what changes for Shopify order messages
- Reconciling your WhatsApp bill with the Beacon Messenger log
- Track with Shop vs WhatsApp shipping updates on Shopify
- Meta changed my WhatsApp template from utility to marketing
- Shopify's new app security review: what Beacon Messenger can access
- A shopper cancels their own Shopify order: what WhatsApp sends
- Customer erasure in 5 days: what the WhatsApp log keeps
- WhatsApp INR billing deadline: Indian Shopify stores
- WhatsApp template headers: text, image or document?
- Gift orders on WhatsApp: buyer's phone or the recipient's?
- WhatsApp order messages at night: when each one sends
- Downgrading a WhatsApp app plan after peak season: what changes
- Shopify subscription renewals and WhatsApp order messages