WhatsApp number quality ratings

We'll notify you of the quality rating and status for your WhatsApp account via email.

Quality ratings

The quality rating shows how messages your customers have received in a rolling window of the past 24 hours. There are three different states of messaging quality:

  • Green: High
  • Yellow: Medium
  • Red: Poor

Rate limit tiers

The quality-based rate limit tiers affect how many daily messages to customers your business can send. Keep in mind that this includes both new and existing conversations. There are three tiers:

  • Tier 1: Allows your company to send messages to 1K customers per day.
  • Tier 2: Allows your company to send messages to 10K customers per day.
  • Tier 3: Allows your company to send messages to 100K customers per day.

How does it work? We're glad you asked. When a company registers its phone number, it starts with Tier 1. The company will be upgraded to the next tier only if the quality rating is not in the Red state and it sends 2x the number of messages of its current limit in a maximum window of 7 days.

Keep in mind that since there is a limit of the messages per day depending of your tier, the earliest the upgrade can occur is after 2 days.

Status

Phone numbers may have many statuses listed, such as DisconnectedPending, etc., but two statuses related to quality are Warned and Rate Limited. Typically, the Connected status is shown when the phone number used to send messages is in a good state.

  • Warned: When quality rating reaches a Red state, that number is moved to Warned status for the next 7 days. If this number continues to maintain a good quality rating for the next 7 days, it returns to Connected status; otherwise, it changes to the Rate Limited state.
  • Rate Limited: If the phone number is not maintaining good quality even after moving to the Warned state, it's moved to Rate Limited. During this phase, the rate limit for this number is set by the quality-based rate limit tier your business belongs to.

If you have been given a Rate Limited status and do not improve your message quality, you will be downgraded to a lower rate limit tier and its lower sending threshold.

Keeping a high-quality rating

Questions?

We’re always happy to help with code or other doubts you might have! Check out our Quickstarts, API Reference, Tutorials, SDKs, or contact our Support team.

Cookie Settings