GeneralBots/botbook
2
2
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update WhatsApp rate limits documentation with Meta official specs
All checks were successful
GBCI / build (push) Successful in 11s
Details

Browse source 
- Document 1 message per 6 seconds per recipient
- Add burst mode explanation (45 messages in 6s)
- Document error 131056 and retry strategy
- Add automatic queue management info
This commit is contained in:
Rodrigo Rodriguez (Pragmatismo) 2026-03-09 19:17:50 -03:00
parent 275148fbfb
commit 60fe68a693
1 changed files with 26 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
src/08-config/whatsapp-channel.md
View file

@ -310,7 +310,28 @@ CARD #{
## Rate Limits and Best Practices ## Rate Limits and Best Practices
### Messaging Limits ### Official Meta Rate Limits (Per Recipient)
**Base Rate**: 1 message per 6 seconds per recipient (0.17 messages/second)
- Equals ~10 messages per minute or 600 per hour per recipient
- Exceeding this triggers error code **131056**
**Burst Allowance**: Up to 45 messages in a 6-second burst
- "Borrows" from future quota
- After burst, must wait equivalent time at normal rate
- Example: 20-message burst requires ~2-minute cooldown
**Retry Strategy**: When rate limit hit (error 131056):
- Wait 4^X seconds before retry (X starts at 0)
- X increments by 1 after each failure
- Retry sequence: 1s, 4s, 16s, 64s, 256s
**Implementation**: BotServer automatically manages rate limiting via Redis queue
- Messages are queued and sent at compliant rate
- Per-recipient tracking prevents violations
- Automatic exponential backoff on 131056 errors
### Daily Messaging Limits (Tier-Based)
| Tier | Messages/24h | How to Upgrade | | Tier | Messages/24h | How to Upgrade |
|------|--------------|----------------| |------|--------------|----------------|
@ -354,9 +375,9 @@ TALK "Processing your request..."
IF ERROR THEN IF ERROR THEN
error_msg = ERROR MESSAGE error_msg = ERROR MESSAGE
IF INSTR(error_msg, "rate limit") > 0 THEN IF INSTR(error_msg, "131056") > 0 THEN
PRINT "Rate limited, queuing message for retry" PRINT "Rate limit exceeded - message queued for automatic retry"
' Queue for later ' BotServer handles retry automatically
ELSE IF INSTR(error_msg, "invalid phone") > 0 THEN ELSE IF INSTR(error_msg, "invalid phone") > 0 THEN
PRINT "Invalid phone number format" PRINT "Invalid phone number format"
ELSE IF INSTR(error_msg, "not registered") > 0 THEN ELSE IF INSTR(error_msg, "not registered") > 0 THEN
@ -378,6 +399,7 @@ END IF
| 131048 | Spam rate limit | Reduce message frequency | | 131048 | Spam rate limit | Reduce message frequency |
| 131049 | Message not delivered to maintain healthy ecosystem engagement | You are sending too many messages too quickly, or WhatsApp detected spam-like behavior. This is a temporary rate limit - reduce your sending frequency and implement proper throttling. | | 131049 | Message not delivered to maintain healthy ecosystem engagement | You are sending too many messages too quickly, or WhatsApp detected spam-like behavior. This is a temporary rate limit - reduce your sending frequency and implement proper throttling. |
| 131051 | Unsupported message type | Check message format | | 131051 | Unsupported message type | Check message format |
| 131056 | Rate limit exceeded | Sending too fast to same recipient (>1 msg/6s). BotServer automatically retries with exponential backoff. |
| 131052 | Media download failed | Verify media URL | | 131052 | Media download failed | Verify media URL |
| 132000 | Template not found | Check template name | | 132000 | Template not found | Check template name |
| 132001 | Template paused | Resume in WhatsApp Manager | | 132001 | Template paused | Resume in WhatsApp Manager |