Kode Kesalahan Cloud API

Cloud API dibuat di atas Graph API, jadi jika Anda tidak terbiasa menangani tanggapan kesalahan Graph API, lihat dokumentasi penanganan kesalahan Graph API.

Secara umum, kami merekomendasikan Anda untuk membangun logika penanganan kesalahan aplikasi Anda di seputar nilai code dan properti payload details. Properti ini dan nilai-nilainya lebih merupakan indikasi dari kesalahan yang mendasar.

Judul kode, yang tidak memiliki properti khusus dalam payload tanggapan kesalahan API, disertakan sebagai bagian dari nilai message. Namun, kami merekomendasikan agar Anda tidak mengandalkan judul untuk logika penanganan kesalahan Anda karena judul pada akhirnya tidak akan digunakan lagi.

Menerima Kesalahan: Sinkron dan Asinkron

Kesalahan Cloud API dikembalikan baik secara sinkron sebagai tanggapan Graph API, secara asinkron melalui Webhook, atau terkadang melalui kedua metode tersebut.

Ini adalah praktik yang baik ketika bekerja dengan Cloud API bahwa Anda memantau tanggapan Graph API dan webhook messages untuk penanganan kesalahan. Jika Anda berlangganan ke kolom webhook messages, Anda akan menerima notifikasi kesalahan karena terjadi untuk jenis kesalahan asinkron yang didukung.

Webhooks dan Sintaksis Tanggapan Kesalahan

Kesalahan Cloud API dapat muncul di objek webhooks berikut:

Cloud API

entry.changes.value.errors
entry.changes.value.messages.errors

On-Premises API

errors

Sintaksis Tanggapan Kesalahan

{
  "error": {
    "message": "<MESSAGE>",
    "type": "<TYPE>",
    "code": <CODE>,
    "error_data": {
        "messaging_product": "whatsapp",
        "details": "<DETAILS>"
    },
    "error_subcode": <ERROR_SUBCODE>
    "fbtrace_id": "<FBTRACE_ID>"
  }
}

Konten Tanggapan Kesalahan

Properti	Jenis Nilai	Deskripsi
`code`	Bilangan bulat	Kode kesalahan. Kami merekomendasikan Anda untuk membuat penanganan kesalahan aplikasi Anda seputar kode kesalahan alih-alih subkode atau kode status tanggapan.
`details`	String	Deskripsi kesalahan dan deskripsi alasan yang paling mungkin untuk kesalahan tersebut. Mungkin juga berisi informasi tentang cara mengatasi kesalahan, seperti parameter mana yang tidak valid atau nilai apa yang dapat diterima.
`error_subcode`	Bilangan bulat	Dihentikan. Tidak akan diberikan dalam tanggapan v16.0+. Subkode Graph API. Tidak semua tanggapan akan berisi subkode, jadi kami merekomendasikan Anda membangun logika penanganan kesalahan Anda seputar properti `code` dan `details` sebagai gantinya.
`fbtrace_id`	String	Lacak ID yang bisa Anda sertakan saat menghubungi Dukungan Langsung. ID dapat membantu kami melakukan debug kesalahan.
`message`	String	Kombinasi dari kode kesalahan dan judulnya. Contoh: `(#130429) Rate limit hit`.
`messaging_product`	String	Produk berkirim pesan. Ini akan selalu menjadi string `whatsapp` untuk tanggapan Cloud API.
`type`	String	Jenis kesalahan.

Contoh Tanggapan

{
  "error": {
    "message": "(#130429) Rate limit hit",
    "type": "OAuthException",
    "code": 130429,
    "error_data": {
        "messaging_product": "whatsapp", 
        "details": "Message failed to send because there were too many messages sent from this phone number in a short period of time"
    },
    "error_subcode": 2494055,
    "fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
  }
}

Kode Kesalahan

Kesalahan Otorisasi

Kode	Deskripsi	Kemungkinan Solusi	Kode Status HTTP
`0` AuthException	Kami tidak dapat mengautentikasi pengguna aplikasi.	Biasanya ini berarti token akses yang disertakan telah kedaluwarsa, tidak valid, atau pengguna aplikasi telah mengubah pengaturan untuk mencegah semua aplikasi mengakses data mereka. Kami merekomendasikan Anda untuk mendapatkan token akses baru.	`401` Unauthorized
`3` API Method	Masalah kemampuan atau izin.	Gunakan debugger token akses untuk memeriksa bahwa aplikasi Anda telah diberikan izin yang diperlukan oleh endpoint. Lihat Pemecahan Masalah.	`500` Kesalahan Server Internal
`10` Permission Denied	Izin tidak diberikan atau sudah dihapus.	Gunakan debugger token akses untuk memverifikasi apakah aplikasi Anda telah mendapatkan izin yang diperlukan dari endpoint. Lihat Pemecahan Masalah. Pastikan nomor telepon yang digunakan untuk <menetapkan kode publik bisnis sudah masuk daftar putih.	`403` Forbidden
`190` Access token has expired	Token akses Anda sudah kedaluwarsa.	Dapatkan token akses baru.	`401` Belum disahkan
`200-299` API Permission	Izin tidak diberikan atau sudah dihapus.	Gunakan debugger token akses untuk memverifikasi apakah aplikasi Anda telah mendapatkan izin yang diperlukan dari endpoint. Lihat Pemecahan Masalah.	`403` Forbidden

Kesalahan Pelambatan

Kode	Deskripsi	Kemungkinan Solusi	Kode Status HTTP
`4` API Too Many Calls	Aplikasi ini telah mencapai batas laju panggilan API-nya.	Muat aplikasi di bagian Dasbor Aplikasi dan lihat bagian Batas Laju Aplikasi untuk memastikan bahwa aplikasi telah mencapai batas laju. Jika sudah, coba lagi nanti atau kurangi frekuensi atau jumlah kueri API yang dibuat aplikasi.	`400` Permintaan Buruk
`80007` Rate limit issues	Akun WhatsApp Business telah mencapai batas laju.	Lihat Batas Laju akun WhatsApp Business. Coba lagi nanti atau kurangi frekuensi atau jumlah kueri API yang dibuat aplikasi.	`400` Permintaan Buruk
`130429` Rate limit hit	Throughput pesan Cloud API telah tercapai.	Aplikasi ini telah mencapai batas throughput API. Lihat Throughput. Coba lagi nanti atau kurangi frekuensi pengiriman pesan oleh aplikasi.	`400` Permintaan Buruk
`131048` Spam rate limit hit	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 dan kunjungi dokumentasi Batas Laju Berbasis Kualitas untuk informasi selengkapnya.	`400` Permintaan Buruk
`131056` (Business Account, Consumer Account) pair rate limit hit	Terlalu banyak pesan yang dikirim dari nomor telepon pengirim ke nomor telepon penerima yang sama dalam waktu singkat.	Tunggu dan coba lagi operasi, jika Anda berniat untuk mengirim pesan ke nomor telepon yang sama. Anda masih dapat mengirim pesan ke nomor telepon yang berbeda tanpa menunggu	`400` Permintaan Buruk
`133016` Account register deregister rate limit exceeded	Pendaftaran atau Penghapusan Pendaftaran gagal karena terlalu banyak upaya untuk nomor telepon ini dalam waktu singkat	Nomor telepon bisnis ini diblokir karena sudah mencapai batas upaya pendaftaran/penghapusan pendaftarannya. Coba lagi setelah nomor tidak diblokir. Lihat "Batas" di dokumen Pendaftaran.	`400` Permintaan Buruk

Kesalahan Integritas

Kode Deskripsi Kemungkinan Solusi Kode Status HTTP

Kode	Deskripsi	Kemungkinan Solusi	Kode Status HTTP
`368` Temporarily blocked for policies violations	Akun WhatsApp Business yang terkait dengan aplikasi telah dilarang atau dinonaktifkan karena melanggar kebijakan platform.	Lihat dokumen Penegakan Kebijakan untuk mempelajari pelanggaran kebijakan dan cara menyelesaikannya.	`403` Forbidden
`131031` Account has been locked	Akun WhatsApp Business yang terkait dengan aplikasi telah dilarang atau dinonaktifkan karena melanggar kebijakan platform, atau kami tidak dapat memverifikasi data yang disertakan dalam permintaan terhadap set data di Akun WhatsApp Business (misalnya: PIN dua langkah yang disertakan dalam permintaan itu salah).	Lihat dokumen Penegakan Kebijakan untuk mempelajari tentang pelanggaran kebijakan dan cara menyelesaikannya. Anda juga dapat menggunakan Status Kesehatan API, yang mungkin memberikan insight tambahan tentang alasan tersebut atau berbagai alasan untuk penguncian akun.	`403` Dilarang

368

Temporarily blocked for policies violations

Akun WhatsApp Business yang terkait dengan aplikasi telah dilarang atau dinonaktifkan karena melanggar kebijakan platform.

Lihat dokumen Penegakan Kebijakan untuk mempelajari pelanggaran kebijakan dan cara menyelesaikannya.

403

Forbidden

131031

Account has been locked

Akun WhatsApp Business yang terkait dengan aplikasi telah dilarang atau dinonaktifkan karena melanggar kebijakan platform, atau kami tidak dapat memverifikasi data yang disertakan dalam permintaan terhadap set data di Akun WhatsApp Business (misalnya: PIN dua langkah yang disertakan dalam permintaan itu salah).

Lihat dokumen Penegakan Kebijakan untuk mempelajari tentang pelanggaran kebijakan dan cara menyelesaikannya.

Anda juga dapat menggunakan Status Kesehatan API, yang mungkin memberikan insight tambahan tentang alasan tersebut atau berbagai alasan untuk penguncian akun.

403

Dilarang

Kesalahan Lain

Kode Deskripsi Kemungkinan Solusi Kode Status HTTP

Kode	Deskripsi	Kemungkinan Solusi	Kode Status HTTP
`1` API Unknown	Permintaan yang tidak valid atau kemungkinan kesalahan server.	Periksa halaman Status Platform WhatsApp Business untuk melihat informasi status API. Jika tidak ada pemadaman server, periksa referensi endpoint dan pastikan bahwa permintaan Anda diformat dengan benar serta memenuhi semua persyaratan endpoint.	`400` Permintaan Buruk
`2` API Service	Sementara tidak berfungsi akibat waktu henti atau karena kelebihan beban.	Periksa halaman Status Platform WhatsApp Business untuk melihat informasi status API sebelum mencoba lagi.	`503` Layanan Tidak Tersedia
`33` Parameter value is not valid	Nomor telepon bisnis telah dihapus.	Verifikasikan bahwa nomor telepon bisnis sudah benar.	`400` Permintaan Buruk
`100` Invalid parameter	Permintaan termasuk satu atau beberapa parameter yang tidak didukung atau salah eja.	Lihat referensi endpoint untuk menentukan parameter mana yang didukung dan bagaimana ejaannya. Pastikan saat mengatur kode publik bisnis, kodenya adalah kode publik RSA 2048-bit yang valid dalam format PEM. Pastikan ID nomor telepon yang Anda daftarkan dan ID nomor telepon yang disimpan sebelumnya semuanya cocok. Pastikan parameter Anda tidak melebihi batasan panjang untuk jenis tersebut.	`400` Permintaan Buruk
`130472` User's number is part of an experiment	Pesan tidak dikirim sebagai bagian dari eksperimen.	Lihat Eksperimen Pesan Marketing.	`400` Permintaan Buruk
`131000` Terjadi kesalahan	Pesan gagal dikirim karena kesalahan yang tidak diketahui. Ketika menetapkan kode publik bisnis, pesan gagal untuk menghitung tanda tangan, gagal memanggil endpoint GraphQL, atau endpoint GraphQL menampilkan kesalahan.	Coba lagi. Jika kesalahan tetap terjadi, bukalah tiket Dukungan Langsung.	`500` Kesalahan Server Internal
`131005` Access denied	Izin tidak diberikan atau sudah dihapus.	Gunakan debugger token akses untuk memverifikasi apakah aplikasi Anda telah mendapatkan izin yang diperlukan dari endpoint. Lihat Pemecahan Masalah.	`403` Dilarang
`131008` Required parameter is missing	Permintaan kehilangan parameter wajib.	Lihat referensi endpoint untuk menentukan parameter mana yang diperlukan.	`400` Permintaan Buruk
`131009` Nilai parameter tidak valid	Satu atau beberapa nilai parameter tidak valid.	Lihat referensi endpoint untuk menentukan nilai mana yang didukung untuk setiap parameter, dan lihat Nomor Telepon untuk mempelajari cara menambahkan nomor telepon ke Akun WhatsApp Business.	`400` Permintaan Buruk
`131016` Service unavailable	Layanan untuk sementara tidak tersedia.	Periksa halaman Status Platform WhatsApp Business untuk melihat informasi status API sebelum mencoba lagi.	`500` Internal Server Error
`131021` Recipient cannot be sender	Nomor telepon pengirim dan penerima sama.	Kirim pesan ke nomor telepon yang berbeda dari pengirim.	`400` Permintaan Buruk
`131026` Message Undeliverable	Tidak dapat menyampaikan pesan. Alasan dapat meliputi: Nomor telepon penerima bukan nomor telepon WhatsApp. Mengirim template autentikasi ke pengguna WhatsApp yang memiliki kode panggilan negara +91 (India). Template autentikasi saat ini tidak dapat dikirim ke pengguna WhatsApp di India. Penerima belum menerima Ketentuan Layanan dan Kebijakan Privasi kami yang baru. Penerima menggunakan versi WhatsApp lama; harus menggunakan versi WhatsApp berikut atau yang lebih besar: Android: 2.21.15.15 SMBA: 2.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6 Pesan tidak tersampaikan untuk menciptakan pengalaman pengguna yang berkualitas tinggi. Lihat Batas Pesan Template Marketing Per Pengguna.	Dengan menggunakan metode komunikasi non-WhatsApp, mintalah pengguna WhatsApp untuk: Mengonfirmasi bahwa mereka benar-benar dapat mengirim pesan ke nomor telepon WhatsApp Business Anda. Mengonfirmasi bahwa mereka telah menerima Ketentuan Layanan terbaru (Pengaturan > Bantuan, atau Pengaturan > Informasi Aplikasi akan meminta mereka menerima ketentuan/kebijakan terbaru jika mereka belum melakukannya) Memperbarui ke versi terbaru klien WhatsApp.	`400` Permintaan Buruk
`131042` Masalah pembayaran kelayakan bisnis	Terjadi kesalahan terkait metode pembayaran Anda.	Lihat Tentang Penagihan untuk Akun WhatsApp Business Anda dan verifikasikan bahwa Anda telah menyiapkan penagihan dengan benar. Masalah umum: Akun pembayaran tidak dilampirkan pada Akun WhatsApp Business Lini kredit melebihi batas Lini kredit (Akun Pembayaran) tidak diatur atau aktif Akun WhatsApp Business dihapus Akun WhatsApp Business ditangguhkan 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	`400` Permintaan Buruk
`131045` Incorrect certificate	Pesan gagal terkirim karena kesalahan pendaftaran nomor telepon.	Daftarkan nomor telepon sebelum mencoba lagi.	`500` Internal Server Error
`131047` Re-engagement message	Lebih dari 24 jam telah berlalu sejak terakhir penerima membalas nomor pengirim.	Kirimkan pesan yang diinisiasi oleh pelaku bisnis kepada penerima menggunakan template pesan sebagai gantinya.	`400` Permintaan Buruk
`131051` Unsupported message type	Jenis pesan tidak didukung.	Lihat Pesan untuk jenis pesan yang didukung sebelum mencoba lagi dengan jenis pesan yang didukung.	`400` Permintaan Buruk
`131052` Media download error	Tidak dapat mengunduh media yang dikirim oleh pengguna.	Kami tidak dapat mengunduh media karena satu atau beberapa alasan, seperti jenis media yang tidak didukung. Lihat nilai `error.error_data.details` untuk informasi selengkapnya tentang mengapa kami tidak dapat mengunduh media. Minta pengguna WhatsApp mengirimi Anda file media menggunakan metode non-WhatsApp.	`400` Permintaan Buruk
`131053` Media upload error	Tidak dapat mengunggah media yang digunakan dalam pesan.	Kami tidak dapat mengunggah media untuk satu alasan atau lebih, seperti jenis media yang tidak didukung. Lihat nilai `error.error_data.details` untuk informasi selengkapnya tentang mengapa kami tidak dapat mengunggah media. Sebaiknya periksa file media yang menyebabkan kesalahan dan konfirmasikan bahwa file tersebut memang didukung. Contohnya, di UNIX Anda dapat menggunakan inspeksi file melalui baris perintah untuk menentukan jenis MIME-nya: `file -I rejected-file.mov` Anda kemudian dapat mengonfirmasi apakah jenis MIME-nya ada dalam daftar jenis media yang didukung. Untuk kinerja yang lebih andal saat mengirim media, lihat Caching HTTP Media dan mengunggah media.	`400` Permintaan Buruk
`131057` Akun dalam mode pemeliharaan	Akun Bisnis dalam mode pemeliharaan	Akun WhatsApp Business dalam mode pemeliharaan. Salah satu alasannya mungkin karena akun sedang melakukan peningkatan throughput.	`500` Permintaan Buruk
`132000` Template Param Count Mismatch	Jumlah nilai parameter variabel yang disertakan dalam permintaan tidak sesuai dengan jumlah parameter variabel yang ditentukan dalam template.	Lihat Pedoman Template Pesan dan pastikan permintaan mencakup semua nilai parameter variabel yang telah ditentukan dalam template.	`400` Permintaan Buruk
`132001` Template does not exist	Template tidak ada dalam bahasa yang ditentukan atau template belum disetujui.	Pastikan template Anda telah disetujui dan nama template dan bahasa locale sudah benar. Pastikan Anda mengikuti pedoman template pesan.	`404` Tidak Ditemukan
`132005` Template Hydrated Text Too Long	Teks yang diterjemahkan terlalu panjang.	Periksa Pengelola WhatsApp untuk memastikan bahwa template Anda telah diterjemahkan. Lihat Peringkat Kualitas dan Status Template.	`400` Permintaan Buruk
`132007` Template Format Character Policy Violated	Konten template melanggar kebijakan WhatsApp.	Lihat Alasan Penolakan untuk menentukan kemungkinan alasan pelanggaran.	`400` Permintaan Buruk
`132012` Template Parameter Format Mismatch	Nilai parameter variabel salah format.	Nilai parameter variabel yang disertakan dalam permintaan tidak menggunakan format yang ditentukan dalam template. Lihat Pedoman Template Pesan.	`400` Permintaan Buruk
`132015` Template is Paused	Template dijeda karena berkualitas rendah sehingga tidak dapat dikirim dalam pesan template.	Edit template untuk meningkatkan kualitasnya dan coba lagi setelah disetujui.	`400` Permintaan Buruk
`132016` Template is Disabled	Template telah dijeda terlalu sering karena berkualitas rendah dan sekarang dinonaktifkan secara permanen.	Buat template baru dengan konten yang berbeda.	`400` Permintaan Buruk
`132068` Flow is blocked	Alur dalam keadaan diblokir.	Perbaiki Alurnya	`400` Permintaan Buruk
`132069` Flow is throttled	Alur dalam keadaan terhambat dan 10 pesan yang menggunakan alur ini sudah dikirim dalam satu jam terakhir.	Perbaiki Alurnya	`400` Permintaan Buruk
`133000` Incomplete Deregistration	Upaya penghapusan pendaftaran sebelumnya gagal.	Hapus pendaftaran nomor lagi sebelum mendaftarkan.	`500` Internal Server Error
`133004` Server Temporarily Unavailable	Server sementara tidak tersedia.	Periksa halaman Status Platform WhatsApp Business untuk melihat informasi status API dan periksa nilai tanggapan `details` sebelum mencoba lagi.	`503` Service Unavailable
`133005` Two step verification PIN Mismatch	PIN verifikasi dua langkah salah.	Periksa bahwa PIN verifikasi dua langkah yang disertakan dalam permintaan sudah benar. Untuk mereset PIN verifikasi dua langkah: Menonaktifkan verifikasi dua langkah. Kirim permintaan POST yang menyertakan PIN baru ke endpoint Nomor Telepon.	`400` Permintaan Buruk
`133006` Phone number re-verification needed	Nomor telepon harus diverifikasi sebelum mendaftar.	Verifikasikan nomor telepon sebelum mendaftarkannya.	`400` Permintaan Buruk
`133008` Too Many two step verification PIN Guesses	Terlalu banyak menebak PIN verifikasi dua langkah untuk nomor telepon ini.	Coba lagi setelah jumlah waktu yang ditentukan dalam nilai tanggapan `details`.	`400` Permintaan Buruk
`133009` Two step verification PIN Guessed Too Fast	PIN verifikasi dua langkah dimasukkan terlalu cepat.	Periksa nilai tanggapan `details` sebelum mencoba lagi.	`400` Permintaan Buruk
`133010` Phone number Not Registered	Nomor telepon tidak terdaftar di Platform WhatsApp Business.	Daftarkan nomor telepon sebelum mencoba lagi.	`400` Permintaan Buruk
`133015` Please wait a few minutes before attempting to register this phone number	Nomor telepon yang Anda coba daftarkan baru-baru ini dihapus, dan penghapusan belum selesai.	Tunggu 5 menit sebelum mencoba kembali permintaan.	`400` Permintaan Buruk
`135000` Generic user error	Pesan gagal dikirim karena kesalahan yang tidak diketahui dengan parameter permintaan Anda.	Lihat referensi endpoint untuk menentukan apakah Anda melakukan kueri endpoint menggunakan sintaksis yang benar. Hubungi dukungan pelanggan jika Anda terus mendapatkan kode kesalahan ini sebagai tanggapan.	`400` Permintaan Buruk

1

API Unknown

Permintaan yang tidak valid atau kemungkinan kesalahan server.

Periksa halaman Status Platform WhatsApp Business untuk melihat informasi status API. Jika tidak ada pemadaman server, periksa referensi endpoint dan pastikan bahwa permintaan Anda diformat dengan benar serta memenuhi semua persyaratan endpoint.

400

Permintaan Buruk

2

API Service

Sementara tidak berfungsi akibat waktu henti atau karena kelebihan beban.

Periksa halaman Status Platform WhatsApp Business untuk melihat informasi status API sebelum mencoba lagi.

503

Layanan Tidak Tersedia

33

Parameter value is not valid

Nomor telepon bisnis telah dihapus.

Verifikasikan bahwa nomor telepon bisnis sudah benar.

400

Permintaan Buruk

100

Invalid parameter

Permintaan termasuk satu atau beberapa parameter yang tidak didukung atau salah eja.

Lihat referensi endpoint untuk menentukan parameter mana yang didukung dan bagaimana ejaannya.

Pastikan saat mengatur kode publik bisnis, kodenya adalah kode publik RSA 2048-bit yang valid dalam format PEM.

Pastikan ID nomor telepon yang Anda daftarkan dan ID nomor telepon yang disimpan sebelumnya semuanya cocok.

Pastikan parameter Anda tidak melebihi batasan panjang untuk jenis tersebut.

400

Permintaan Buruk

130472

User's number is part of an experiment

Pesan tidak dikirim sebagai bagian dari eksperimen.

Lihat Eksperimen Pesan Marketing.

400

Permintaan Buruk

131000

Terjadi kesalahan

Pesan gagal dikirim karena kesalahan yang tidak diketahui.

Ketika menetapkan kode publik bisnis, pesan gagal untuk menghitung tanda tangan, gagal memanggil endpoint GraphQL, atau endpoint GraphQL menampilkan kesalahan.

Coba lagi. Jika kesalahan tetap terjadi, bukalah tiket Dukungan Langsung.

500

Kesalahan Server Internal

131005

Access denied

Izin tidak diberikan atau sudah dihapus.

Gunakan debugger token akses untuk memverifikasi apakah aplikasi Anda telah mendapatkan izin yang diperlukan dari endpoint. Lihat Pemecahan Masalah.

403

Dilarang

131008

Required parameter is missing

Permintaan kehilangan parameter wajib.

Lihat referensi endpoint untuk menentukan parameter mana yang diperlukan.

400

Permintaan Buruk

131009

Nilai parameter tidak valid

Satu atau beberapa nilai parameter tidak valid.

Lihat referensi endpoint untuk menentukan nilai mana yang didukung untuk setiap parameter, dan lihat Nomor Telepon untuk mempelajari cara menambahkan nomor telepon ke Akun WhatsApp Business.

400

Permintaan Buruk

131016

Service unavailable

Layanan untuk sementara tidak tersedia.

Periksa halaman Status Platform WhatsApp Business untuk melihat informasi status API sebelum mencoba lagi.

500

Internal Server Error

131021

Recipient cannot be sender

Nomor telepon pengirim dan penerima sama.

Kirim pesan ke nomor telepon yang berbeda dari pengirim.

400

Permintaan Buruk

131026

Message Undeliverable

Tidak dapat menyampaikan pesan. Alasan dapat meliputi:

Nomor telepon penerima bukan nomor telepon WhatsApp.
Mengirim template autentikasi ke pengguna WhatsApp yang memiliki kode panggilan negara +91 (India). Template autentikasi saat ini tidak dapat dikirim ke pengguna WhatsApp di India.
Penerima belum menerima Ketentuan Layanan dan Kebijakan Privasi kami yang baru.
Penerima menggunakan versi WhatsApp lama; harus menggunakan versi WhatsApp berikut atau yang lebih besar:
- Android: 2.21.15.15
- SMBA: 2.21.15.15
- iOS: 2.21.170.4
- SMBI: 2.21.170.4
- KaiOS: 2.2130.10
- Web: 2.2132.6
Pesan tidak tersampaikan untuk menciptakan pengalaman pengguna yang berkualitas tinggi. Lihat Batas Pesan Template Marketing Per Pengguna.

Dengan menggunakan metode komunikasi non-WhatsApp, mintalah pengguna WhatsApp untuk:

Mengonfirmasi bahwa mereka benar-benar dapat mengirim pesan ke nomor telepon WhatsApp Business Anda.
Mengonfirmasi bahwa mereka telah menerima Ketentuan Layanan terbaru (Pengaturan > Bantuan, atau Pengaturan > Informasi Aplikasi akan meminta mereka menerima ketentuan/kebijakan terbaru jika mereka belum melakukannya)
Memperbarui ke versi terbaru klien WhatsApp.

400

Permintaan Buruk

131042

Masalah pembayaran kelayakan bisnis

Terjadi kesalahan terkait metode pembayaran Anda.

Lihat Tentang Penagihan untuk Akun WhatsApp Business Anda dan verifikasikan bahwa Anda telah menyiapkan penagihan dengan benar.

Masalah umum:

Akun pembayaran tidak dilampirkan pada Akun WhatsApp Business
Lini kredit melebihi batas
Lini kredit (Akun Pembayaran) tidak diatur atau aktif
Akun WhatsApp Business dihapus
Akun WhatsApp Business ditangguhkan
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

400

Permintaan Buruk

131045

Incorrect certificate

Pesan gagal terkirim karena kesalahan pendaftaran nomor telepon.

Daftarkan nomor telepon sebelum mencoba lagi.

500

Internal Server Error

131047

Re-engagement message

Lebih dari 24 jam telah berlalu sejak terakhir penerima membalas nomor pengirim.

Kirimkan pesan yang diinisiasi oleh pelaku bisnis kepada penerima menggunakan template pesan sebagai gantinya.

400

Permintaan Buruk

131051

Unsupported message type

Jenis pesan tidak didukung.

Lihat Pesan untuk jenis pesan yang didukung sebelum mencoba lagi dengan jenis pesan yang didukung.

400

Permintaan Buruk

131052

Media download error

Tidak dapat mengunduh media yang dikirim oleh pengguna.

Kami tidak dapat mengunduh media karena satu atau beberapa alasan, seperti jenis media yang tidak didukung. Lihat nilai error.error_data.details untuk informasi selengkapnya tentang mengapa kami tidak dapat mengunduh media.

Minta pengguna WhatsApp mengirimi Anda file media menggunakan metode non-WhatsApp.

400

Permintaan Buruk

131053

Media upload error

Tidak dapat mengunggah media yang digunakan dalam pesan.

Kami tidak dapat mengunggah media untuk satu alasan atau lebih, seperti jenis media yang tidak didukung. Lihat nilai error.error_data.details untuk informasi selengkapnya tentang mengapa kami tidak dapat mengunggah media.

Sebaiknya periksa file media yang menyebabkan kesalahan dan konfirmasikan bahwa file tersebut memang didukung.

Contohnya, di UNIX Anda dapat menggunakan inspeksi file melalui baris perintah untuk menentukan jenis MIME-nya:

file -I rejected-file.mov

Anda kemudian dapat mengonfirmasi apakah jenis MIME-nya ada dalam daftar jenis media yang didukung.

Untuk kinerja yang lebih andal saat mengirim media, lihat Caching HTTP Media dan mengunggah media.

400

Permintaan Buruk

131057

Akun dalam mode pemeliharaan

Akun Bisnis dalam mode pemeliharaan

Akun WhatsApp Business dalam mode pemeliharaan. Salah satu alasannya mungkin karena akun sedang melakukan peningkatan throughput.

500

Permintaan Buruk

132000

Template Param Count Mismatch

Jumlah nilai parameter variabel yang disertakan dalam permintaan tidak sesuai dengan jumlah parameter variabel yang ditentukan dalam template.

Lihat Pedoman Template Pesan dan pastikan permintaan mencakup semua nilai parameter variabel yang telah ditentukan dalam template.

400

Permintaan Buruk

132001

Template does not exist

Template tidak ada dalam bahasa yang ditentukan atau template belum disetujui.

Pastikan template Anda telah disetujui dan nama template dan bahasa locale sudah benar. Pastikan Anda mengikuti pedoman template pesan.

404

Tidak Ditemukan

132005

Template Hydrated Text Too Long

Teks yang diterjemahkan terlalu panjang.

Periksa Pengelola WhatsApp untuk memastikan bahwa template Anda telah diterjemahkan. Lihat Peringkat Kualitas dan Status Template.

400

Permintaan Buruk

132007

Template Format Character Policy Violated

Konten template melanggar kebijakan WhatsApp.

Lihat Alasan Penolakan untuk menentukan kemungkinan alasan pelanggaran.

400

Permintaan Buruk

132012

Template Parameter Format Mismatch

Nilai parameter variabel salah format.

Nilai parameter variabel yang disertakan dalam permintaan tidak menggunakan format yang ditentukan dalam template. Lihat Pedoman Template Pesan.

400

Permintaan Buruk

132015

Template is Paused

Template dijeda karena berkualitas rendah sehingga tidak dapat dikirim dalam pesan template.

Edit template untuk meningkatkan kualitasnya dan coba lagi setelah disetujui.

400

Permintaan Buruk

132016

Template is Disabled

Template telah dijeda terlalu sering karena berkualitas rendah dan sekarang dinonaktifkan secara permanen.

Buat template baru dengan konten yang berbeda.

400

Permintaan Buruk

132068

Flow is blocked

Alur dalam keadaan diblokir.

Perbaiki Alurnya

400

Permintaan Buruk

132069

Flow is throttled

Alur dalam keadaan terhambat dan 10 pesan yang menggunakan alur ini sudah dikirim dalam satu jam terakhir.

Perbaiki Alurnya

400

Permintaan Buruk

133000

Incomplete Deregistration

Upaya penghapusan pendaftaran sebelumnya gagal.

Hapus pendaftaran nomor lagi sebelum mendaftarkan.

500

Internal Server Error

133004

Server Temporarily Unavailable

Server sementara tidak tersedia.

Periksa halaman Status Platform WhatsApp Business untuk melihat informasi status API dan periksa nilai tanggapan details sebelum mencoba lagi.

503

Service Unavailable

133005

Two step verification PIN Mismatch

PIN verifikasi dua langkah salah.

Periksa bahwa PIN verifikasi dua langkah yang disertakan dalam permintaan sudah benar.

Untuk mereset PIN verifikasi dua langkah:

Menonaktifkan verifikasi dua langkah.
Kirim permintaan POST yang menyertakan PIN baru ke endpoint Nomor Telepon.

400

Permintaan Buruk

133006

Phone number re-verification needed

Nomor telepon harus diverifikasi sebelum mendaftar.

Verifikasikan nomor telepon sebelum mendaftarkannya.

400

Permintaan Buruk

133008

Too Many two step verification PIN Guesses

Terlalu banyak menebak PIN verifikasi dua langkah untuk nomor telepon ini.

Coba lagi setelah jumlah waktu yang ditentukan dalam nilai tanggapan details.

400

Permintaan Buruk

133009

Two step verification PIN Guessed Too Fast

PIN verifikasi dua langkah dimasukkan terlalu cepat.

Periksa nilai tanggapan details sebelum mencoba lagi.

400

Permintaan Buruk

133010

Phone number Not Registered

Nomor telepon tidak terdaftar di Platform WhatsApp Business.

Daftarkan nomor telepon sebelum mencoba lagi.

400

Permintaan Buruk

133015

Please wait a few minutes before attempting to register this phone number

Nomor telepon yang Anda coba daftarkan baru-baru ini dihapus, dan penghapusan belum selesai.

Tunggu 5 menit sebelum mencoba kembali permintaan.

400

Permintaan Buruk

135000

Generic user error

Pesan gagal dikirim karena kesalahan yang tidak diketahui dengan parameter permintaan Anda.

Lihat referensi endpoint untuk menentukan apakah Anda melakukan kueri endpoint menggunakan sintaksis yang benar. Hubungi dukungan pelanggan jika Anda terus mendapatkan kode kesalahan ini sebagai tanggapan.

400

Permintaan Buruk