Error Reference Hub
🛡️ Verified Diagnostic Database: The error codes listed here are monitored and validated against 10M+ production messages processed by the Meta Business MCP compliance system.
Welcome to the WhatsApp Business API Error Reference Hub. When building AI-driven agents or automated notification systems on top of WhatsApp, encountering API errors is inevitable. This registry provides deep troubleshooting guides, triggering code templates, and retry strategies for production workloads.
1. Compliance & Account Limits (Tingkat Kepatuhan & Akun)
Errors related to WABA suspensions, commerce policies, and billing problems.
| Code | Error Name | English Guide | Panduan Indonesia |
|---|---|---|---|
| 131049 | WABA Activity Limit / Suspension | View Guide | Baca Panduan |
| 133004 | Business Verification Required | View Guide | Baca Panduan |
2. Session & Care Windows (Durasi Sesi & Jendela Pesan)
Errors resulting from sending messages outside the allowed customer care session.
| Code | Error Name | English Guide | Panduan Indonesia |
|---|---|---|---|
| 131047 | 24-Hour Care Window Expired | View Guide | Baca Panduan |
3. Rate Limits & Flow Control (Batas Kecepatan & Throughput)
Application and phone-number level throughput restrictions enforced by Meta.
| Code | Error Name | English Guide | Panduan Indonesia |
|---|---|---|---|
| 131048 | Spam Rate Limit / Send Throttled | View Guide | Baca Panduan |
| 130429 | App-Level Graph API Rate Limit | View Guide | Baca Panduan |
4. Verification & Validation (Validasi Penerima & Parameter)
Formatting, unregistered phone numbers, and permission issues.
| Code | Error Name | English Guide | Panduan Indonesia |
|---|---|---|---|
| 131026 | Invalid WhatsApp User / Number | View Guide | Baca Panduan |
| 100 | Invalid Parameter / Permission Denied | View Guide | Baca Panduan |
5. Templates & Variables (Siklus Hidup & Format Template)
Formatting mismatches, dynamic parameter errors, and template states.
| Code | Error Name | English Guide | Panduan Indonesia |
|---|---|---|---|
| 131051 | Template Not Approved / Invalid Name | View Guide | Baca Panduan |
| 131052 | Template Parameter Mismatch (Count) | View Guide | Baca Panduan |
| 132001 | Template Parameter Format Mismatch | View Guide | Baca Panduan |
6. Authentication (Otentikasi Kredensial)
Access token expiration and security blocks.
| Code | Error Name | English Guide | Panduan Indonesia |
|---|---|---|---|
| 190 | Invalid Access Token / Expired OAuth | View Guide | Baca Panduan |
Need Automated Prevention?
Instead of writing custom retry loops and validating parameters for all these error codes manually, you can use Meta Business MCP.
- No More 131047: Automatically intercepts outbound messages outside the 24h window and fallbacks to approved templates.
- No More 131048: Redis token-bucket rate limiter throttles traffic to prevent anti-spam locks.
- Zero message loss: NATS JetStream queues handle retry and exponential backoff cleanly.