When building on the WhatsApp Business API, you'll encounter various error codes. Here is a reference for the most common ones.
Common Error Codes
131047 - Re-engagement Message
The 24-hour customer service window has expired. Use a template message to re-initiate the conversation.
131026 - Message Not Delivered
The message couldn't be delivered. Common causes: number not on WhatsApp, user blocked you, or number is inactive.
131051 - Rate Limit Hit
You've exceeded your messaging tier limit. Wait and retry, or request a tier upgrade.
131056 - Template Paused
Your template has been paused due to low quality. Review the template content and customer feedback.
130429 - Too Many API Requests
API rate limit exceeded. Implement exponential backoff retry logic.
131031 - Business Account Locked
Your business account has been restricted. Contact Meta support to resolve.
Error Handling Best Practices
Retry Strategy
Use exponential backoff: wait 1s, 2s, 4s, 8s between retries. Max 5 retries.
Queue Management
Implement a dead letter queue for messages that fail after all retries.
Monitoring
Set up alerts for error rate spikes. A sudden increase in errors often indicates a systemic issue.
User Communication
When a message fails, record the failure and retry later. Don't silently drop messages.
Error Logging
Log the full error response including error code, message, and any details for debugging.`,
