API di Tempat Platform WhatsApp Business

WhatsApp Business Platform > On-Premises API

Kami akan menghentikan On-Premises API. Lihat Proses Penghentian On-Premises API dokumen untuk detailnya, dan untuk mempelajari cara bermigrasi ke Cloud API generasi berikutnya.

Pesan Kesalahan dan Status

Dokumen ini memberikan informasi selengkapnya tentang jenis-jenis pesan kesalahan dan status:

Kode Kesalahan Klien API WhatsApp Business
Kode Status HTTP

Untuk pemecahan masalah Pendaftaran Tersemat, lihat Kesalahan Alur Pendaftaran Tersemat.

Kode Kesalahan Klien API WhatsApp Business

Kode Kesalahan	Deskripsi
`400` - Kesalahan unduh media	Gagal mengunduh media dari pengirim.
`402` - Kelayakan bisnis — Masalah pembayaran	Pesan gagal dikirim karena ada satu atau beberapa kesalahan terkait metode pembayaran Anda. Akun pembayaran tidak dilampirkan pada Akun WhatsApp Lini kredit melebihi batas Lini kredit (akun Pembayaran) tidak diatur atau aktif Akun WhatsApp Business dihapus Akun telah kami tangguhkan Zona waktu belum diatur Mata uang belum diatur Permintaan MessagingFor (On Behalf Of (OBO)) menunggu persetujuan atau ditolak Melebihi ambang batas tingkat percakapan gratis tanpa metode pembayaran yang valid. (Jenis kesalahan ini aktif mulai 1 Februari 2022). Periksa penyiapan pembayaran Anda di Pengelola WhatsApp dan coba lagi.
`408` - Pesan tidak valid	Pesan gagal dikirim karena tertunda terlalu lama (yakni > 1 hari). Ini diharapkan jika klien API WhatsApp Business down selama lebih dari satu hari, lalu dimulai ulang. Kirim ulang pesan.
`410` - Pesan kedaluwarsa	Pesan gagal dikirim selama durasi Time To Live (TTL)-nya.
`429` - Terkena pembatasan laju	Untuk pesan keluar: Pesan gagal dikirim karena ada terlalu banyak pesan terkirim dari nomor telepon ini dalam waktu yang singkat. Kirim ulang pesan yang gagal. Untuk pesan masuk: Gagal mengunduh media dengan sukses karena pembatasan laju. Minta pengirim untuk mengirim ulang pesan.
`430` - Sertifikat tidak bertanda tangan	Pesan gagal dikirim karena ada kesalahan terkait sertifikat Anda. Unduh sertifikat baru dari Pengelola WhatsApp dan daftar ulang.
`432` - ID Sertifikat tidak cocok	Pesan gagal dikirim karena ada kesalahan terkait sertifikat Anda. Unduh sertifikat baru dari Pengelola WhatsApp dan daftar ulang.
`433` - Tanda tangan sertifikat tidak valid	Terjadi ketika pesan dikirim tetapi sertifikat klien bisnis tidak ditandatangani dengan benar menggunakan kunci identitas klien. Ini mungkin mengindikasikan bahwa klien mendaftar ulang dengan kunci identitas baru tetapi tidak menyelesaikan alur pembuatan sertifikasi secara lengkap.
`470` - Pesan interaksi ulang	Pesan gagal dikirim karena 24 jam lebih telah berlalu sejak terakhir kalinya pelanggan membalas ke nomor ini. Gunakan template pesan untuk menanggapi.
`471` - Terkena pembatasan laju spam	Pesan gagal dikirim karena ada pembatasan jumlah pesan yang dapat dikirim dari nomor telepon ini. Ini mungkin karena terlalu banyak pesan sebelumnya yang diblokir atau ditandai sebagai spam. Periksa status kualitas Anda di Pengelola WhatsApp. Lihat dokumentasi Batas Laju Berbasis Kualitas untuk informasi selengkapnya.
`472` - Nomor pengguna adalah bagian dari eksperimen	Gagal mengirim pesan karena nomor telepon pengguna ini adalah bagian dari eksperimen. Lewati mengirim pesan ke pengguna ini.
`480` - Pengguna mungkin berubah	Pesan gagal dikirim karena pengguna dengan nomor telepon ini mungkin sudah berubah.
`500` - Kesalahan umum	Pesan gagal dikirim karena kesalahan yang tidak diketahui. Coba lagi nanti.
`501` - Jenis pesan saat ini tidak didukung.	Pesan dokumen dengan keterangan saat ini tidak didukung.
`1000` - Kesalahan umum
`1001` - Pesan terlalu panjang	Panjang pesan melebihi 4.096 karakter.
`1002` - Jenis penerima tidak valid	Jenis penerima valid: `individual`
`1004` - Sumber daya sudah ada	Kemungkinan konflik UUID untuk permintaan unggah media atau media dengan UUID itu sudah ada.
`1005` - Akses ditolak	Anda mencoba mendaftarkan nomor telepon bisnis untuk digunakan dengan On-Premises API, yang kini tidak lagi diizinkan. Lihat Penghentian On-Premises API. Direktori media tidak dapat ditulis (permintaan unggah), atau Kredensial tidak valid, atau Kesalahan Sertifikat, atau Aplikasi Kedaluwarsa: perlu peningkatan versi, atau `button` pesan dinonaktifkan untuk akun ini, atau Nomor sudah terdaftar di WhatsApp (lihat Memigrasi Nomor Telepon untuk informasi memindahkan nomor telepon dari WhatsApp ke API WhatsApp Business), atau Jika bisnis Anda mengirim pesan dagang di India, pastikan Anda telah melengkapi semua profil bisnis wajib dan kolom item produk yang diwajibkan. Untuk informasi selengkapnya, lihat selengkapnya https://www.facebook.com/business/help/1104628230079278.
`1006` - Sumber daya tidak ditemukan	File atau sumber daya tidak ditemukan
`1007` - Penerima diblokir dari menerima pesan (Tidak berlaku lagi)	Penerima tidak ada di daftar diizinkan
`1008` - Tidak ada parameter wajib	Parameter wajib tidak ditemukan. Jika Anda mencoba mengirim Pesan berisi Daftar, mungkin Anda ketinggalan bagian `title` dari objek `section` atau `ID` untuk `rows` Anda. Jika Anda mencoba mengirim Pesan Satu Produk atau Pesan Multiproduk, ada kemungkinan Anda melewatkan `catalog_id` atau `product_retailer_id`. Kedua kolom tersebut diperlukan untuk jenis pesan ini.
`1009` - Nilai parameter tidak valid	Jenis nilai yang dimasukkan untuk parameter salah atau ada masalah lain. Jika mencoba mengirim Pesan berisi Daftar, periksalah apakah ID setiap baris unik. Jika Anda mencoba mengirim Pesan Produk Tunggal, mungkin Anda salah mengirim `catalog_id`. Silakan kembali ke Commerce Manager dan periksa lagi. Jika Anda mencoba mengirim Pesan Multiproduk, pastikan `product_retailer_id` unik per bagian. Juga pastikan objek `header` dan `body` ada dan memiliki nilai yang ditetapkan.
`1010` - Parameter tidak diperlukan	Berisi parameter yang tidak diperlukan.
`1011` - Layanan tidak siap
`1013` - Pengguna tidak valid
`1014` - Kesalahan internal	Gagal mengunggah karena gambar bermasalah (gambar tidak terunggah dengan benar) atau endpoint tidak ditemukan Hash yang Anda sediakan tidak cocok dengan hash terakhir pengguna
`1015` - Terlalu banyak permintaan	Batas laju sisi klien telah tercapai
`1016` - Sistem kelebihan muatan	Jika sistem menerima muatan besar, kesalahan ini akan ditampilkan agar sistem pulih dari muatan itu.
`1017` - Bukan Master Utama	Kesalahan ini terjadi saat permintaan khusus master, seperti atur pengaturan, dapatkan pengaturan, impor, ekspor, permintaan kode, daftar, dsb. dikirim ke node yang bukan master primer. Ini dapat terjadi saat Klien API WhatsApp Business tidak disiapkan dengan benar atau karena kesalahan internal. Mencoba ulang permintaan biasanya dapat memecahkan masalah ini. Jika ini tidak menyelesaikan kesalahan, hubungi dukungan.
`1018` - Bukan CoreApp Utama	Kesalahan ini terjadi saat permintaan dikirim ke node Coreapp yang bukan pemilik serpihan atau sedang dalam proses menjadi pemilik serpihan. Anda mungkin menemui kesalahan ini saat kami melakukan failover serpihan dalam penyiapan multikoneksi. Mencoba ulang permintaan biasanya dapat memecahkan masalah ini. Jika tidak, hubungi Dukungan.
`1021` - Pengguna Buruk	Kesalahan ini terjadi saat Anda mengirim pesan ke diri sendiri Untuk memecahkannya, kirim pesan ke nomor yang bukan milik Anda.
`1022` - URL Webhooks tidak dikonfigurasi	Kesalahan ini terjadi jika Anda belum mengonfigurasi format Webhooks API REST.
`1023` - Terjadi kesalahan database
`1024` - Perubahan Kata Sandi Diperlukan	Anda diharuskan mengganti kata sandi.
`1025` - Permintaan Tidak Valid	Permintaan tidak valid.
`1026` - Penerima Tidak Mampu	Pesan Tidak Tersampaikan. Lihat "Mengapa tingkat pengiriman saya tidak 100%?" Pertanyaan Umum.
`1028` - Notifikasi sistem `user_identity_changed` memerlukan tanda terima	Anda mengirim pesan ke pengguna WhatsApp yang mungkin sudah berubah, dan notifikasi sistem `user_identity_changed` telah dikirimkan kepada Anda dan menunggu tanda terima.
`1031` - Akun pengirim telah dikunci	Akun Anda telah terkunci dari mengirim pesan apa pun karena pelanggaran kebijakan integritas. Lihat Penegakan Kebijakan Platform WhatsApp Business untuk informasinya.
`2000` - Jumlah Parameter Template Tidak Cocok	Jumlah parameter yang diberikan tidak cocok dengan jumlah parameter yang diharapkan.
`2001` - Template Tidak Ada	Status template tidak aktif, atau template tidak ada untuk bahasa dan locale.
`2002` - Template Gagal Diambil	Penerima gagal mengunduh template.
`2003` - Paket Template Tidak Ada	Tidak ada template untuk bahasa dan locale tertentu.
`2004` - Parameter Template Terlalu Panjang	Panjang parameter terlalu panjang
`2005` - Teks Terhidrasi Template Terlalu Panjang	Teks terjemahan terlalu panjang
`2006` - Kebijakan Ruang Putih Template Dilanggar	Kebijakan ruang putih dilanggar
`2007` - Kebijakan Karakter Format Template Dilanggar	Kebijakan karakter format dilanggar
`2008` - Format Media Template Tidak Didukung	Format media yang digunakan tidak didukung
`2009` - Komponen yang Diperlukan Template Tidak Ada	Komponen wajib di Template hilang
`2010` - URL Terhidrasi Template Tidak Valid	URL di komponen tombol tidak valid
`2011` - Nomor Telepon Template Tidak Valid	Nomor Telepon di komponen tombol tidak valid
`2012` - Format Parameter Template Tidak Cocok	Format parameter tidak cocok dengan format di Template yang dibuat
`2013` - Tombol Template Tidak Didukung	Tombol tidak didukung oleh penerima
`2014` - Namespace yang Diharapkan Masih Kosong	Kesalahan ini terjadi ketika paket bahasa pesan template belum diunduh.
`2015` - Jumlah bagian tidak valid	Permintaan pesan berisi jumlah bagian di bawah minimum atau di atas jumlah maksimum. Lihat objek `section` untuk informasi selengkapnya. Anda perlu setidaknya 1 objek `section` dan maksimal 10.
`2016` - Jumlah baris tidak valid	Ada jumlah baris yang tidak valid. Untuk Pesan berisi Daftar, harus ada setidaknya satu objek `rows` per `section`.
`2017` - Kebijakan Karakter Dilanggar	Kebijakan karakter format telah dilanggar.
`2023` - Jumlah produk tidak valid	Objek bagian tidak memiliki produk atau jumlah total produk telah melebihi jumlah maksimum yang diizinkan.
`2024` - ID Katalog tidak ditemukan	ID katalog yang Anda berikan tidak ada atau bukan milik Akun WhatsApp Business (WABA) Anda.
`2025` - ID Katalog tidak tertaut ke nomor API	ID katalog yang Anda berikan tidak terhubung ke nomor telepon yang Anda gunakan untuk mengirim pesan.
`2026` - Produk yang hilang	Beberapa produk yang disediakan dalam permintaan Anda tidak ditemukan dalam katalog.
`2027` - Tidak ada produk yang ditemukan	Tidak ada produk yang ditemukan dalam katalog yang Anda berikan.
`2028` - Buat daftar semua produk yang gagal dipatuhi	Hanya tersedia untuk bisnis di India. Kesalahan ini ditampilkan saat bisnis mengirim Pesan Satu Produk tanpa informasi kepatuhan e-commerce atau informasi kepatuhannya tidak lengkap.
`2029` - Buat daftar beberapa produk yang gagal dipatuhi	Hanya tersedia untuk bisnis di India. Kesalahan ini ditampilkan saat bisnis mengirim pesan Multiproduk tanpa informasi kepatuhan e-commerce atau informasi kepatuhannya tidak lengkap.
`2030` - Daftar produk campuran tidak valid dan kepatuhan juga gagal	Hanya tersedia untuk bisnis di India. Kesalahan ini ditampilkan saat bisnis mengirim pesan Multiproduk dengan campuran produk tidak valid dan produk tanpa informasi kepatuhan.
`2036` - Struktur Header Tidak Valid	Ditampilkan ketika struktur objek `header` tidak valid.
`2050` - Info Kepatuhan Tidak Ada	Hanya tersedia untuk bisnis di India. Kesalahan ini ditampilkan saat bisnis belum memberikan informasi kepatuhan. Lihat endpoint Kepatuhan Bisnis.
`2060` - Template Ditolak	Status template adalah `REJECTED` sehingga tidak bisa dikirim.
`2061` - Template Dijeda	Status template adalah `PAUSED` sehingga tidak bisa dikirim.
`2062` - Template Dinonaktifkan	Status template adalah `DISABLED` sehingga tidak bisa dikirim.
`2064` - ID Alur tidak valid	Alur dengan ID yang ditentukan tidak ada atau bukan milik Akun WhatsApp Business (WABA) Anda, atau dalam keadaan tidak valid.
`2065` - Versi Pesan Alur Tidak Valid	Versi pesan alur tidak valid. Lihat versi pesan yang didukung saat ini di Catatan Perubahan Alur
`2066` - Mode Alur Tidak Valid	Dikembalikan saat Alur dalam status `DRAFT` dikirim dengan menentukan mode draf atau Alur `PUBLISHED` dikirim dengan mode draf.
`2067` - Mode DRAF Alur Tidak Diizinkan	Tidak dapat mengirim Alur `DRAFT`, silakan periksa halaman status untuk masalah yang sedang berlangsung dan jika masalah terus berlanjut, silakan hubungi dukungan.
`2068` - Alur diblokir	Alur dalam keadaan diblokir. Kesalahan ini juga dapat ditampilkan jika alur menggunakan endpoint dan pengaturan yang diperlukan tidak lengkap, misalnya kode publik tidak diunggah atau menjadi tidak valid. Lihat Menerapkan Endpoint untuk Alur.
`2069` - Alur terhambat	Alur dalam keadaan terhambat dan 10 pesan yang menggunakan alur ini sudah dikirim dalam satu jam terakhir.
`2070` - Versi Alur Tidak Valid	Versi alur tidak valid atau kedaluwarsa. Lihat versi yang didukung saat ini di Catatan Perubahan Alur

Untuk kode kesalahan Commerce Manager khusus untuk bisnis India lihat Pusat Bantuan Bisnis.

Kode Status HTTP

Ini adalah Kode Status HTTP yang dapat digunakan oleh Klien API WhatsApp Business.

Kode HTTP	Deskripsi
`2xx`	Berhasil
`200`	Berhasil (OK)
`201`	Berhasil dibuat (Untuk permintaan POST)
`302`	Ditemukan
`4xx`	Kesalahan Klien
`400`	Permintaan tidak valid
`401`	Belum disahkan
`403`	Dilarang
`404`	Tidak ditemukan
`405`	Metode tidak diizinkan.
`412`	Prakondisi gagal
`420`	Laju pesan terbatas
`429`	Terlalu banyak permintaan
`5xx`	Kesalahan Server
`500`	Kesalahan server internal
`504`	Waktu Habis

Platform WhatsApp Business | Cloud API | API di Tempat | API Pengelolaan Bisnis