for Developers
QuickstartsAPI ReferenceSDKsTutorialsDashboard
QuickstartsApi ReferenceTutorials

Quickstarts

SMS
Test credits & API keysSend an SMSReceive an SMSTroubleshooting
WhatsApp
WA Deep DiveGetting started WASandboxInstall ChannelMessage TemplatesCreate media templateSend a messageSend message with buttonsSend interactive messagesSend media template messageCreate and send authentication templatesSticker messagesProduct messagesCarousel templateCoupon templateReferralNumber RatingsСustomer's opt-insNumber MigrationWhatsApp BusinessTroubleshooting
Facebook
Quick RepliesMedia TemplatesGeneric TemplatesMessaging Referrals
Voice Calling
Get your API keysMake a voice callReceive callsSIP TrunkingTroubleshootingStructure of a CallCall and Leg statuses
Voice Messaging
Get your API keysText To Speech MessageTroubleshooting
Conversations
Test Credits & API KeysInstall SMSInstall EmailInstall LINEInstall TelegramInstall WeChatInstall WhatsAppReceiving MessagesSending MessagesReplying to MessagesMessenger optionsMessage TagsEmail Attachments and Inline ImagesIP Warm-upTroubleshooting
Numbers
Buy a numberNumber restrictions
Omnichannel Widget
Install Toggling / HidingAdding AttributesIdentifying Users
Notifications Center
Receiving Notifications via Webhooks
Verify
Test Credits & API KeysSend Your First Verify TokenVerify a Token
Pricing API (SMS & MMS)Lookup
Request a LookupRequest an HLRView an HLRTroubleshooting
MMS
Test Credits & API KeysSend MMSTroubleshooting

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 Disconnected, Pending, 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