Ringkasan Error Code Whatsapp Business API

---

Ringkasan Kode Error WhatsApp Business API

1. Error Autentikasi (Authorization Errors)

Penyebab:

• Token akses kedaluwarsa / tidak valid
• Izin atau kapabilitas API tidak sesuai
• Nomor telepon atau akun tidak diizinkan

Solusi:

• Perbarui token akses
• Gunakan Access Token Debugger untuk verifikasi izin
• Pastikan nomor telepon sudah terdaftar

Kode & Status HTTP:

• 0 (AuthException) → 401 Unauthorized
• 3 (API Method) → 500 Internal Server Error
• 10 (Permission Denied) → 403 Forbidden
• 190 (Access Token Expired) → 401 Unauthorized
• 200-299 (API Permission Issues) → 403 Forbidden

---

2. Error Integritas Akun (Integrity Errors)

Penyebab:

• Akun dibatasi karena melanggar kebijakan
• Akun diblokir untuk negara tertentu
• Data akun tidak sesuai

Solusi:

• Cek WhatsApp Business Policy
• Pastikan nomor, PIN, & data sudah sesuai

Kode & Status HTTP:

• 368 (Temporarily Blocked) → 403 Forbidden
• 130497 (Restricted Country Messaging) → 403 Forbidden
• 131031 (Account Locked) → 403 Forbidden

---

3. Error Umum API (General Errors)

Penyebab:

• Masalah server / request API tidak valid
• Nomor bisnis dihapus
• Parameter salah / tidak valid
• Masalah pembayaran

Solusi:

• Periksa format request sesuai dokumentasi
• Cek API Status Page
• Verifikasi pengaturan pembayaran

Kode & Status HTTP:

• 1 (API Unknown) → 400 Bad Request
• 2 (API Service Unavailable) → 503 Service Unavailable
• 100 (Invalid Parameter) → 400 Bad Request
• 131037 (Display Name Not Approved) → 400 Bad Request
• 131042 (Payment Issue) → 400 Bad Request

---

4. Error Pengiriman Pesan (Messaging Errors)

Penyebab:

• Penerima tidak punya WhatsApp / belum setujui kebijakan
• Nomor pengirim belum disetujui
• Pesan dikirim >24 jam setelah interaksi terakhir
• Pesan dianggap spam

Solusi:

• Minta penerima update WhatsApp / setujui kebijakan
• Gunakan message template jika lewat 24 jam
• Cek status kualitas pesan di WhatsApp Manager

Kode & Status HTTP:

• 131026 (Message Undeliverable) → 400 Bad Request
• 131047 (Re-engagement Message Required) → 400 Bad Request
• 131049 (Meta Chose Not to Deliver) → 400 Bad Request
• 131051 (Unsupported Message Type) → 400 Bad Request

---

5. Error Template & Format Pesan

Penyebab:

• Jumlah parameter tidak sesuai
• Template ditolak / tidak disetujui
• Format template melanggar kebijakan
• Template dinonaktifkan karena kualitas rendah

Solusi:

• Pastikan jumlah & format parameter sesuai template disetujui
• Buat atau edit template baru jika ditolak

Kode & Status HTTP:

• 132000 (Template Param Count Mismatch) → 400 Bad Request
• 132001 (Template Does Not Exist) → 404 Not Found
• 132007 (Template Format Violation) → 400 Bad Request
• 132016 (Template Disabled Due to Quality Issues) → 400 Bad Request

---

6. Error Sinkronisasi Data (Synchronization Errors)

Penyebab:

• Terlalu banyak request sinkronisasi dalam waktu singkat
• Sinkronisasi di luar waktu yang diizinkan (24 jam setelah onboarding)

Solusi:

• Tunggu sebelum mencoba ulang
• Jika perlu, lakukan offboard & re-onboard

Kode & Status HTTP:

• 2593107 (Sync Request Limit Exceeded) → 400 Bad Request
• 2593108 (Sync Outside Allowed Time Window) → 400 Bad Request

---

7. Error Batas Penggunaan API (Throttling Errors)

Penyebab:

• Terlalu banyak request API dalam waktu singkat
• Terlalu banyak pesan ke 1 penerima dalam waktu singkat
• Batas throughput akun tercapai

Solusi:

• Kurangi frekuensi request API
• Gunakan Quality-Based Rate Limits

Kode & Status HTTP:

• 4 (Too Many API Calls) → 400 Bad Request
• 80007 (Rate Limit Issues) → 400 Bad Request
• 131048 (Spam Rate Limit Hit) → 400 Bad Request

---

Kesimpulan & Best Practices

• Token akses valid & terbaru
• Izin & kapabilitas API sesuai kebutuhan
• Format & parameter pesan sesuai standar
• Akun mematuhi WhatsApp Business Policy
• Tidak mengirim pesan berlebihan (hindari pemblokiran)

Jika kendala berlanjut:

• Gunakan Access Token Debugger
• Periksa API Status Page
• Hubungi WhatsApp Business Support