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

WhatsApp phone number quality ratings
RatingMeta's labelWhat it means for your notifications
GREENHigh qualityNothing to do. Messaging limits can rise with volume and templates are not at risk from this number.
YELLOWMedium qualityCustomers 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.
REDLow qualityMeta 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.
UnknownNo rating returnedUsually 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