R
Oleh Ryan
Dipublikasikan pada 11 Feb 2026
Kode Error WhatsApp API: Daftar Lengkap beserta Penyebab & Solusi (2026)
WhatsApp API menampilkan error? Lihat kode error untuk 40+ kode yang mencakup autentikasi, pembatasan laju, templat, media & alur, beserta langkah pemecahan masalah.
Kode error WhatsApp API adalah kode numerik yang mengidentifikasi dan membantu mengatasi masalah yang dihadapi pengguna saat berinteraksi dengan solusi WhatsApp API. Karena WhatsApp API dibangun di atas Graph API, penyedia solusi atau integrator API disarankan untuk menangani logika error menggunakan kode dan detailnya agar penyebab masalah dapat diketahui dengan jelas. Dengan menggunakan kode ini, bisnis dapat memahami masalah saat mengirim pesan atau menghubungkan ke WhatsApp API, serta melakukan pemecahan masalah.
Berikut ini adalah daftar lengkap kode error WhatsApp API yang dikelompokkan ke dalam kategori terkait, beserta langkah pemecahan masalah yang disarankan. WhatsApp juga mencantumkan serangkaian kode error teknis untuk layanan cloud API mereka di sini.
a) Error Otorisasi: Error autentikasi terjadi saat sistem WhatsApp API tidak dapat memverifikasi kredensial atau izin pengguna maupun aplikasi yang mengajukan permintaan.
| Kode | Deskripsi | Solusi yang Mungkin |
|
0 | AuthException Meta tidak dapat mengautentikasi pengguna aplikasi: Token kedaluwarsa dan perubahan akses ke data dapat menjadi penyebabnya . | Verifikasi ulang izin aplikasi atau buat token akses di sini atau tanyakan langkah-langkahnya kepada Penyedia Solusi Anda. |
|
3 | Metode API Izin yang diperlukan untuk melakukan panggilan API tidak tersedia, atau konfigurasi panggilan API keliru | Tinjau konfigurasi API atau buat ulang token akses. Hubungi penyedia solusi Anda jika Anda menggunakannya. |
|
10 | Izin Ditolak Aplikasi Anda tidak memiliki izin yang memadai, atau aksesnya telah dicabut. Nomor Telepon Belum Disetujui: Nomor telepon belum disetujui atau tidak tercantum sebagai nomor yang diizinkan untuk akun WhatsApp API |
Verifikasi ulang token API untuk memastikan izin aplikasi yang diperlukan di sini. Jika Anda menggunakan penyedia solusi, tanyakan langkah-langkah yang diperlukan kepada mereka. Pastikan nomor telepon telah didaftarkan dan disetujui dengan benar di Akun WhatsApp Business Anda. Selesaikan pendaftaran dan persetujuan jika penyedia solusi Anda belum melakukannya. |
|
190 | Izin Ditolak Token akses telah kedaluwarsa dan akses ke API diblokir | Dapatkan token akses baru untuk aplikasi terkait agar semua izin yang diperlukan tercakup. Penyedia solusi Anda dapat memandu Anda melalui langkah-langkahnya. |
|
200-299 | Error Izin API Izin tidak tersedia atau telah dicabut: Akses ke fitur API tertentu dibatasi | Verifikasi token API untuk mendapatkan izin aplikasi yang diperlukan di sini. Jika Anda menggunakan solusi dari Penyedia Solusi, tanyakan langkah-langkah yang diperlukan kepada mereka. |
b) Error Pembatasan Laju: Terjadi saat aplikasi Anda melampaui batas laju panggilan API yang ditetapkan untuk akun Anda.
| Kode | Deskripsi | Solusi yang Mungkin |
| 4 | Terlalu Banyak Panggilan API Aplikasi telah melampaui batas laju panggilan API | Pantau dan optimalkan laju panggilan API secara proaktif. Buat rencana untuk menangani batas laju API |
| 80007 | Masalah batas laju Akun WhatsApp API telah mencapai batas lajunya | Coba lagi nanti atau kurangi jumlah panggilan API. |
| 130429 | Batas laju tercapai Batas throughput pesan telah terlampaui. | Kurangi frekuensi pengiriman pesan atau coba lagi nanti |
| 131048 | Batas laju spam tercapai Hal ini mungkin disebabkan oleh pembatasan volume pesan pada nomor telepon di akun API. Penyebabnya bisa jadi riwayat penandaan sebagai spam dan pesan yang diblokir oleh penerima. | Periksa status kualitas di WhatsApp Manager dan kurangi frekuensi pengiriman pesan. |
| 131056 | Batas laju pasangan tercapai Pengiriman pesan dalam jumlah besar dalam waktu singkat dari nomor telepon pengirim ke penerima dengan nomor telepon tertentu. | Tunggu, lalu coba kirim pesan lagi ke nomor telepon penerima yang sama. Pengiriman pesan ke nomor telepon lain tidak dibatasi. |
| 133016 | Batas pendaftaran/pembatalan pendaftaran nomor telepon terlampaui WhatsApp membatasi jumlah percobaan pendaftaran atau pembatalan pendaftaran hingga 10 kali dalam periode 72 jam | Tunggu sebentar dan coba lagi setelah periode pemblokiran 72 jam berakhir. |
c) Error Integritas: Error ini terkait dengan pelanggaran kebijakan Platform WhatsApp yang untuk sementara membatasi tindakan tertentu pada akun bisnis.
| Kode | Deskripsi | Solusi yang Mungkin |
| 368 | Pemblokiran Sementara akibat Pelanggaran Kebijakan Akun WhatsApp Business terkait dibatasi atau diblokir karena melanggar kebijakan platform. | Tinjau kebijakan WhatsApp untuk memahami dan mengatasi pelanggaran, atau hubungi penyedia solusi WhatsApp Anda untuk mendapatkan bantuan. |
| 130497 | Pembatasan pengiriman pesan di negara tertentu: Akun WhatsApp Business dilarang mengirim pesan kepada pengguna di negara tertentu karena pembatasan kategori atau kebijakan setempat | Periksa kebijakan WhatsApp tentang wilayah geografis dan pembatasan pengiriman pesan di tiap negara di sini. Hubungi dukungan WhatsApp atau penyedia solusi untuk informasi lebih lanjut. |
| 131031 | Akun Dikunci Akun WhatsApp Business dibatasi atau dinonaktifkan sepenuhnya karena melanggar kebijakan platform atau perdagangan. Hal ini dapat disebabkan oleh verifikasi konten atau data pesan yang tidak memadai. | Periksa panduan kesehatan pengiriman pesan atau kebijakan platform terkait penindakan spam. |
d) Error Templat Pesan: Masalah pada templat pesan terstruktur yang telah ditentukan sebelumnya, akibat faktor seperti pelanggaran kebijakan, konten terlarang, batas laju, atau masalah pemformatan.
| Kode | Deskripsi | Solusi yang Mungkin |
| 132000 | Jumlah Parameter Templat Tidak Cocok Jumlah parameter variabel dalam pesan tidak cocok dengan variabel yang ditetapkan dalam templat yang disetujui | Tinjau pesan dan lihat panduan templat, serta pastikan semua parameter variabel telah ditentukan |
| 132001 | Templat tidak ditemukan Templat belum disetujui atau tidak tersedia dalam bahasa tertentu. | Pastikan templat pesan telah disetujui serta nama pesan dan lokal bahasa sudah benar. Untuk detail selengkapnya, lihat kebijakan templat pesan pesan |
| 132005 | Templat Terjemahan Melebihi Batas Karakter Templat interaktif dengan semua tombol, balasan cepat, dan karakter teks lainnya melampaui batas setelah diterjemahkan. | Tinjau konten template, sederhanakan, dan kurangi batas karakter. Sebaiknya gunakan konten yang ringkas. Tinjau status template untuk tindakan selanjutnya. |
| 132007 | Pelanggaran Kebijakan Format Template Error ini terjadi jika konten berisi karakter yang tidak didukung, format yang salah, atau elemen lain yang tidak sesuai dengan pedoman WhatsApp. | Tinjau alasan penolakan dan edit kembali konten template. |
| 132012 | Format parameter template tidak cocok Mengirim parameter yang salah (seperti gambar, bukan video) dalam pesan template yang tidak sesuai dengan format template yang disetujui. | Pastikan parameter template sesuai dengan format template yang disetujui. Jika perlu, mintalah bantuan penyedia solusi WhatsApp Anda. |
| 132015 | Template Dijeda Template telah jeda karena penilaian kualitas yang buruk, dan akun API tidak dapat mengirim pesan template tersebut kepada penggunanya. | Edit template, tingkatkan kualitasnya, lalu coba kirim lagi. |
| 132016 | Template Dinonaktifkan Jika template telah beberapa kali dijeda karena kualitas rendah, WhatsApp telah menonaktifkannya. | Sebaiknya buat template baru, ubah kontennya, dan pastikan kualitas kontennya baik. |
e) Error Pengiriman Pesan: Ini terkait dengan kegagalan pengiriman pesan kepada penerima akibat masalah pada konten, konfigurasi, atau sisi penerima.
| Kode | Deskripsi | Solusi yang Mungkin |
| 131026 | Pesan Tidak Dapat Dikirim Kemungkinan penyebabnya: -Nomor WhatsApp penerima tidak valid -Penerima menggunakan versi aplikasi WhatsApp yang lebih lama -Penerima belum menyetujui ketentuan layanan dan kebijakan privasi WhatsApp yang baru | Penerima harus menyetujui S&K WhatsApp untuk layanan, mendaftarkan akun WhatsApp, atau memperbarui versi aplikasi. |
| 131047 | Pesan untuk Memulai Kembali Interaksi Lebih dari 24 jam telah berlalu sejak balasan terakhir penerima. | Gunakan template pesan yang dimulai oleh bisnis untuk memulai percakapan baru dengan pengguna. |
| 131049 | Meta tidak mengirimkan pesan Meta memilih untuk tidak mengirimkan pesan demi menjaga interaksi ekosistem tetap sehat. | Hal ini mungkin disebabkan oleh batas pesan pemasaran per pengguna (baca detail selengkapnya di sini). Coba lagi setelah beberapa waktu. |
| 131051 | Jenis pesan tidak didukung Mencoba mengirim pesan dengan format template (media atau payload lainnya) yang tidak didukung WhatsApp. | Periksa jenis pesan yang didukung dalam dokumentasi WhatsApp. |
f) Error Media: Error dalam menangani file media
| Kode | Deskripsi | Solusi yang Mungkin |
| 131052 | Error unduhan media WhatsApp tidak dapat mengunduh media yang disertakan dalam pesan pengguna WhatsApp. | Sebaiknya minta pengguna mengirimkan file media melalui saluran selain WhatsApp. |
| 131053 | Error Unggah Media WhatsApp tidak dapat mengunggah media karena alasan seperti berikut:
| Periksa daftar format file media yang didukung WhatsApp |
g) Error WhatsApp Flows: Masalah terkait fitur WhatsApp Flows
| Kode | Deskripsi | Solusi yang Mungkin |
| 100 | Salah satu dari berbagai masalah yang ditemui saat mengelola flow mungkin menjadi penyebabnya
| Berikan nama yang valid dan unik, lalu pastikan ID spesifik serta URL yang diterapkan valid. Baca selengkapnya tentang penanganan error spesifik Flows |
| 139000 | Diblokir karena masalah integritas WhatsApp mungkin mendeteksi masalah integritas pada Akun Bisnis yang menghalangi pembuatan atau penerbitan flow Anda | Hubungi dukungan Whatsapp atau penyedia solusi Anda untuk mengatasi masalah ini. |
| 139001 | Flows tidak dapat diperbarui Flow tidak dapat diperbarui setelah diterbitkan. Upaya untuk melakukannya akan menampilkan error ini. |
Kloning Flow, perbarui flow, lalu terbitkan ulang. Gunakan flow baru sebagai pengganti flow lama. |
| 139002 | Menerbitkan Flows dengan detail yang belum lengkap Menerbitkan flow dengan detail yang belum lengkap atau tidak tepat akan menampilkan error ini. Ada beberapa kemungkinan penyebabnya:
|
Identifikasi detail yang belum ada di flow. Tambahkan detail yang relevan dengan solusi yang sesuai, lalu coba terbitkan lagi. |
| 139003 | Menghentikan penggunaan Flow Error saat mencoba menghentikan penggunaan flow mungkin disebabkan oleh beberapa hal berikut:
| Lihat panduan ini tentang cara menghentikan penggunaan flow |
| 139004 | Tidak Dapat Menghapus Flow yang Telah Dipublikasikan Terjadi kesalahan saat menghapus flow yang telah dipublikasikan karena tindakan ini tidak diizinkan | Setelah flow dipublikasikan, flow tidak dapat dihapus. Coba menonaktifkannya sebagai gantinya |
| 139006 | Ambang Batas Metrik Flow Data yang tersedia belum cukup untuk menampilkan metrik flow | Tunggu hingga data flow mencukupi untuk membuat metrik |
| 132068 | Flow Diblokir Eksekusi flow WhatsApp diblokir karena pelanggaran kebijakan atau laporan dari pengguna. | Tinjau flow dan periksa apakah ada pelanggaran kebijakan atau laporan pengguna yang berlebihan. |
| 132069 | Flow dibatasi Kemampuan flow WhatsApp tertentu untuk memproses pesan dibatasi sementara karena 10 pesan telah dikirim dalam 1 jam | Pantau performa flow dan perbaiki flow tersebut. Minta bantuan dari dukungan WhatsApp atau penyedia solusi Anda. |
h) Kesalahan Lainnya:
| Kode | Deskripsi | Solusi yang Mungkin |
| 131000 | Terjadi kesalahan Pengiriman pesan gagal karena kesalahan yang tidak diketahui | Coba lagi permintaannya atau hubungi dukungan. Hubungi Penyedia Solusi WhatsApp Anda jika diperlukan |
| 131005 | Akses Ditolak WhatsApp belum memberikan izin atau telah mencabutnya | Coba lakukan pemecahan masalah dengan mengikuti panduan. |
| 131008 | Parameter yang diperlukan tidak tersedia: | Lihat referensi endpoint untuk mengetahui parameter yang diperlukan. |
| 131009 | Nilai Parameter tidak valid | Gunakan hanya parameter yang didukung. Lihat panduan ini untuk mengetahui jenis parameter yang didukung. |
| 131016 | Layanan Tidak Tersedia Layanan WhatsApp sedang tidak tersedia untuk sementara | Hubungi Penyedia Solusi WhatsApp Anda untuk mengetahui detail lebih lanjut atau coba periksa status Platform WhatsApp Business di sini |
| 131021 | Penerima tidak boleh sama dengan pengirim Nomor pengirim dan penerima sama | Gunakan nomor yang berbeda untuk mengirim pesan |
| 131037 | Nama Tampilan Belum Ada Nama tampilan yang disetujui di WhatsApp API diperlukan untuk mengirim pesan. Pesan tidak dapat dikirim jika nama tampilan belum disetujui | Coba ubah nama tampilan dan ajukan persetujuan dengan mengikuti panduan ini |
| 131042 | Masalah Pembayaran Kelayakan Bisnis Terjadi kesalahan pada metode pembayaran yang terhubung ke Akun WhatsApp Business Anda. Kemungkinan penyebabnya termasuk—batas kredit terlampaui, tidak ada akun pembayaran, pembayaran atau jalur kredit belum disiapkan, dan sebagainya. | Verifikasi detail penagihan dan metode pembayaran di WhatsApp Manager untuk memastikan penagihan telah disiapkan dengan benar. |
| 131045 | Sertifikat Tidak Valid Pengiriman pesan gagal karena kesalahan pendaftaran nomor telepon bisnis | Coba daftarkan kembali nomor telepon, lalu coba lagi |
| 131057 | Akun dalam mode pemeliharaan | Hubungi dukungan WhatsApp atau penyedia solusi Anda untuk mengetahui detail lebih lanjut. |