Messaging Limits

This document describes messaging limits for the WhatsApp Business Platform.

Messaging limits are the maximum number of messages that can be delivered from a business phone number to unique WhatsApp user phone numbers, outside of a customer service window, within a moving 24-hour period.

By default, new business phone numbers are limited to 250 delivered messages, but this limit can be increased to:

• 1,000 (by completing a scaling path)
• 10,000 (via automatic scaling
• 100,000 (via automatic scaling)
• Unlimited (via automatic scaling)

Increasing your limit

You can increase your messaging limit to 1,000 by completing one of the scaling paths below. After that, we will automatically increase your limit to the next higher limit if you meet our automatic scaling criteria.

Scaling paths

• Verify your business
• Have your solution provider verify your business (if you were onboarded by one)
• Send 1,000 delivered messages outside of customer service windows to unique WhatsApp user phone numbers in a 30-day moving period, using templates with a high quality rating.

Once you complete one of these paths, we will analyze your message quality. Based on this analysis, your number's eligibility for automatic scaling will either be approved or denied

Approvals

If you are approved, we will immediately increase your business phone number's messaging limit to 1,000 and notify you by email and developer alert. In addition, a business_capability_update webhook will be triggered with the max_daily_conversation_per_phone property indicating the new limit.

Additional messaging limit increases for your number can now happen automatically, via automatic scaling.

Denials

If you are denied, we will keep your business phone number's messaging limit at its current level and notify you by email and developer alert. In addition, an account_alerts webhook will be triggered, with the alert_type and alert_description properties indicating alternate methods you can pursue to increase your limit.

Automatic scaling

Once your business phone number's messaging limit has been increased to 1,000, we will determine if it should be increased further according to the following criteria:

• Your business phone number is connected
• Your business phone number quality rating is Medium or High
• In the last 7 days, your business has utilized at least half of your current messaging limit

If this criteria is met, we will increase your phone number's limit by one level, 24 hours later. If its quality rating has been set to Flagged for the last 7 days, however, we will decrease its limit by one level, immediately.

Checking your limit

Via Meta Business Suite

Your business phone number's current messaging limit is displayed in the WhatsApp Manager > Account tools > Phone numbers panel in the Messaging Limit column.

Via API

Use the GET /<BUSINESS_PHONE_NUMBER_ID> endpoint and request the messaging_limit_tier field to get a business phone number's current messaging limit.

Example request

curl 'https://graph.facebook.com/v23.0/106540352242922?fields=messaging_limit_tier' \
-H 'Authorization: Bearer EAAJB...'

Example response

{
  "messaging_limit_tier": "TIER_250",
  "id": "106540352242922"
}