Capacity rate limiting is imposed on each available API endpoint and will return the appropriate HTTPS error codes (e.g.,
503, etc.) depending on the state of the system.
Two forms of capacity rate limiting are currently supported:
429error code. The current request rate limits for the endpoints are 20 requests per second with bursts allowed up to 60 requests per second.
When you hit either of these capacity rate limiting scenarios, you should halt any further requests and slow the pace of your API requests. If you start seeing many capacity rate limit errors, it would be advisable to build a queue on your end to throttle the requests.
If your expected average send-rates are significantly higher and queuing is not an effective strategy, please look into our High Availability and Scaling options.
The quality rating, messaging limits, and phone number status for your WhatsApp business account are listed in the Phone Numbers tab in WhatsApp Manager.
The quality rating shows how messages have been received by your customers in a rolling window of the past 24 hours. We show it in three different states - Green, Yellow and Red - with Green/Yellow/Red representing high/medium/low messaging quality respectively.
Messaging limits determine how many users your business can send messages to on a daily basis. This includes new conversations as well as existing conversations with users. The messaging limit does NOT limit the number of messages your business can send, just the number of users you are trying to message. It also does NOT apply to messages sent in response to a user-initiated message within a 24-hour period.
Note: A business starts in Tier 1 when it registers its phone number.
A business’ phone number will be upgraded to the next tier if:
See the charts below for examples of how a business might move to the next tier:
Example 1: A business is upgraded from Tier 1 to Tier 2 when it messages a total of 2,000 users within a 7-day period.
Example 2: The chart explains the concept of messaging limit in a rolling 24-hour window.
There are different statuses for phone numbers that usually refer to its connection status (e.g., Connected, Offline, etc.). Occasionally, a phone number may show one of two particular statuses that are related to quality and messaging limits: Flagged and Restricted.
You will receive a notification in the Business Manager if a phone number status from your WhatsApp business account(s) changes to Flagged or Restricted. If your messaging limit changes, you will also receive a notification about this change.
Other phone number statuses include:
To maintain high quality: