وصلة
WhatsApp API Rate Limits & Messaging Tiers Explained
Understanding WhatsApp API rate limits is crucial for successful campaigns. This guide explains messaging tiers, limits, and how to scale your WhatsApp operations.
What Are Rate Limits?
Definition
Rate limits are restrictions on how many messages you can send within a specific time period. WhatsApp uses a tiered system based on your phone number quality and history.
Why They Exist
Rate limits protect:
• Users from spam
• Platform quality
• Business reputation
• Message deliverability
Messaging Tiers
Tier Structure
| Tier | Unique Users/24h | How to Reach |
|---|---|---|
| Unverified | 250 | Default start |
| Tier 1 | 1,000 | After verification |
| Tier 2 | 10,000 | Quality + volume |
| Tier 3 | 100,000 | Quality + volume |
| Unlimited | Unlimited | Quality + volume |
Understanding "Unique Users"
Important distinction:
Unique users ≠ Total messages
Example:
• Message 1 user 10 times = 1 unique user
• Message 10 users 1 time each = 10 unique users
The limit is on NEW conversations started
in a 24-hour rolling window.
How Tiers Work
Starting Point
New phone number:
Register with BSP
Get verified by Meta
Start at Tier 1 (1,000/day)
Build quality score
Advance to higher tiers Tier Advancement
To move up tiers:
Requirements:
✅ High quality score
✅ Consistent message volume
✅ Low block/report rate
✅ Good delivery rates
Timeline:
• Tier 1 → Tier 2: ~7 days
• Tier 2 → Tier 3: ~7 days
• Tier 3 → Unlimited: ~7 days
Note: Each tier requires messaging
at 50%+ of current capacity
with good quality.
Tier Demotion
You can drop tiers if:
❌ Quality score drops
❌ High spam reports
❌ Many blocks
❌ Policy violations
Impact:
• Immediate limit reduction
• Need to rebuild quality
• May take weeks to recover
Quality Score
What Affects Quality
| Factor | Impact |
|---|---|
| Read rate | Positive |
| Response rate | Positive |
| Block rate | Negative |
| Report rate | Very negative |
| Conversation quality | Mixed |
Quality Ratings
Quality indicators:
🟢 High Quality
• Excellent engagement
• Low complaints
• Can advance tiers
🟡 Medium Quality
• Average engagement
• Some complaints
• Tier stable
🔴 Low Quality
• Poor engagement
• Many complaints
• Risk of demotion
Checking Your Quality
In Meta Business Suite:
Go to WhatsApp Manager
Select phone number
View "Quality Rating"
Check messaging limits
Review any warnings Template Limits
Template-Specific Limits
Template restrictions:
• Templates per account: 250-500
• Templates pending: 100 max
• Template categories affect volume
• Marketing has stricter limits
Category-Based Limits
| Category | Limit Impact |
|---|---|
| Authentication | Least restrictive |
| Utility | Moderate |
| Marketing | Most restrictive |
Conversation Windows
24-Hour Window
Session messages:
When customer messages you:
• 24-hour window opens
• Unlimited messages allowed
• No template required
• Window resets each message
After 24 hours:
• Must use template
• Counts against tier limit
• Conversation fees apply
Business-Initiated
Starting conversations:
Must use approved template:
• Counts against tier
• Specific pricing
• Quality tracked
Best practice:
• Use utility over marketing
• Only message interested users
• Provide value
Managing Limits
Monitoring Usage
Track daily:
📊 Dashboard metrics:
• Messages sent today
• Unique users contacted
• Remaining capacity
• Quality indicators
Set alerts:
• 50% capacity used
• 80% capacity used
• Quality score change
Optimization Strategies
Maximize your tier:
Segment audiences
Send to engaged users first
Time distribution
Spread across 24 hours
Priority queue
Important messages first
Quality over quantity
Better engagement = more capacity
Use session windows
Reply to customers (free + no limit)Scaling Best Practices
To increase limits:
Week 1: Use 70%+ capacity
Week 2: Maintain quality
Week 3: Auto-advance (if quality good)
Continue pattern to reach Unlimited.
Warning:
Don't rush to fill quota with
low-quality messages - this
hurts your quality score.
Rate Limit Errors
Common Errors
Error types:
429 Too Many Requests
• Hit rate limit
• Wait and retry
Rate limit reached
• Daily limit exhausted
• Wait for 24h window reset
Template limit reached
• Too many pending templates
• Reduce or wait for approval
Handling Errors
// Retry logic example
async function sendWithRetry(message, maxRetries = 3) {
for (let i = 0; i < maxRetries; i++) {
try {
return await sendMessage(message);
} catch (error) {
if (error.code === 429) {
// Rate limited - wait and retry
const waitTime = Math.pow(2, i) * 1000;
await sleep(waitTime);
continue;
}
throw error;
}
}
throw new Error('Max retries exceeded');
}Multi-Number Strategy
When to Add Numbers
Consider additional numbers when:
• Consistently hitting limits
• Different use cases
• Geographic separation
• Brand separation
• Backup/redundancy needed
Load Balancing
Distribute across numbers:
Number 1: Sales team
Number 2: Support team
Number 3: Marketing campaigns
Number 4: Transactional
Each number has own limit:
4 numbers × 100,000 = 400,000/day potential
Enterprise Solutions
High-Volume Needs
For large scale:
Options:
• Multiple verified numbers
• Direct Meta partnership
• Enterprise BSP plans
• Priority support
Requirements:
• Proven quality track record
• Business case documentation
• Compliance agreements
Get Started
Ready to scale your WhatsApp operations?
---
Related Articles: