Pusat Referensi Error
🛡️ Database Diagnostik Terverifikasi: Kode error yang terdaftar di sini dipantau dan divalidasi terhadap 10 juta+ pesan produksi yang diproses oleh sistem compliance Meta Business MCP.
Selamat datang di Pusat Referensi Error WhatsApp Business API. Saat membangun agent berbasis AI atau sistem notifikasi otomatis di atas platform WhatsApp, kegagalan pengiriman akibat error dari Meta Graph API sering kali tidak terhindarkan. Pusat referensi ini menyediakan panduan resolusi mendalam, contoh kode pemicu, serta strategi penanganan antrean retry yang dirancang khusus untuk operasional skala produksi.
1. Compliance & Account Limits (Tingkat Kepatuhan & Akun)
Error yang berkaitan dengan pembekuan WABA, pelanggaran Commerce Policy, dan masalah tagihan kartu kredit.
| Kode | Nama Error | Panduan Resolusi |
|---|---|---|
| 131049 | WABA Activity Limit / Suspension | Baca Panduan |
| 133004 | Business Verification Required | Baca Panduan |
2. Session & Care Windows (Durasi Sesi & Jendela Pesan)
Error yang disebabkan oleh pengiriman pesan biasa di luar jendela sesi interaksi pengguna.
| Kode | Nama Error | Panduan Resolusi |
|---|---|---|
| 131047 | 24-Hour Care Window Expired | Baca Panduan |
3. Rate Limits & Flow Control (Batas Kecepatan & Throughput)
Batas volume pengiriman pesan yang diterapkan oleh Meta pada nomor telepon maupun aplikasi developer.
| Kode | Nama Error | Panduan Resolusi |
|---|---|---|
| 131048 | Spam Rate Limit / Send Throttled | Baca Panduan |
| 130429 | App-Level Graph API Rate Limit | Baca Panduan |
4. Verification & Validation (Validasi Penerima & Parameter)
Kesalahan format penulisan nomor penerima, nomor tujuan tidak terdaftar di WA, atau masalah scope token.
| Kode | Nama Error | Panduan Resolusi |
|---|---|---|
| 131026 | Invalid WhatsApp User / Number | Baca Panduan |
| 100 | Invalid Parameter / Permission Denied | Baca Panduan |
5. Templates & Variables (Siklus Hidup & Format Template)
Ketidakcocokan jumlah variabel, format tombol dinamis, dan template yang belum disetujui.
| Kode | Nama Error | Panduan Resolusi |
|---|---|---|
| 131051 | Template Not Approved / Invalid Name | Baca Panduan |
| 131052 | Template Parameter Mismatch (Count) | Baca Panduan |
| 132001 | Template Parameter Format Mismatch | Baca Panduan |
6. Authentication (Otentikasi Kredensial)
Masa aktif token berakhir atau token dicabut karena penggantian kata sandi.
| Kode | Nama Error | Panduan Resolusi |
|---|---|---|
| 190 | Invalid Access Token / Expired OAuth | Baca Panduan |
Butuh Pencegahan Error Otomatis?
Alih-alih menulis alur retry manual dan melakukan validasi parameter secara berulang untuk puluhan kode error di atas, Anda dapat menggunakan Meta Business MCP.
- Pencegahan 131047: Secara otomatis mendeteksi batas sesi 24 jam dan mengalihkan kiriman ke Message Template yang disetujui.
- Perlindungan Rate Limit: Redis token-bucket rate limiter menahan laju blast agar nomor terhindar dari spam block.
- Antrean Tanpa Kehilangan Pesan: Integrasi NATS JetStream mengelola retry dan backoff secara mulus tanpa membebani memori server utama.