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` Bad Request
`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` Bad Request
`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` Bad Request
`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` Bad Request
`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` Bad Request
`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` Bad Request

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
`130497` Akun bisnis dibatasi untuk mengirim pesan kepada pengguna di negara ini.	Akun WhatsApp Business dibatasi untuk berkirim pesan kepada pengguna di negara tertentu.	Lihat Kebijakan Berkirim Pesan WhatsApp Business untuk mengetahui detail negara yang diizinkan untuk berkirim pesan dalam kategori bisnis Anda.	`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` Forbidden

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

130497

Akun bisnis dibatasi untuk mengirim pesan kepada pengguna di negara ini.

Akun WhatsApp Business dibatasi untuk berkirim pesan kepada pengguna di negara tertentu.

Lihat Kebijakan Berkirim Pesan WhatsApp Business untuk mengetahui detail negara yang diizinkan untuk berkirim pesan dalam kategori bisnis Anda.

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

Forbidden

Kesalahan Lain

Kode Deskripsi Kemungkinan Solusi Kode Status HTTP

Kode	Deskripsi	Kemungkinan Solusi	Kode Status HTTP
`1` API Unknown	Permintaan 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 verifikasikan bahwa permintaan Anda diformat dengan benar serta memenuhi semua persyaratan endpoint.	`400` Bad Request
`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` Bad Request
`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` Bad Request
`130472` User's number is part of an experiment	Pesan tidak dikirim sebagai bagian dari eksperimen.	Lihat Eksperimen Pesan Marketing.	`400` Bad Request
`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` Forbidden
`131008` Required parameter is missing	Permintaan kehilangan parameter wajib.	Lihat referensi endpoint untuk menentukan parameter mana yang diperlukan.	`400` Bad Request
`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` Bad Request
`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` Bad Request
`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	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` Bad Request
`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` Bad Request
`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` Bad Request
`131049` Meta memilih untuk tidak mengirimkan.	Pesan ini tidak tersampaikan untuk menjaga interaksi ekosistem yang sehat.	Jangan langsung mencoba lagi jika Anda menerima kode kesalahan ini dan menyangka hal itu dikarenakan oleh batasan. Sebaliknya, coba lagi dengan peningkatan waktu yang lebih besar hingga pesan tersampaikan, karena batas tersebut mungkin berlaku untuk periode waktu yang berbeda. Lihat Batas Pesan Template Marketing Per Pengguna untuk mendapatkan informasi tambahan.	`400` Bad Request
`131051` Unsupported message type	Jenis pesan tidak didukung.	Lihat Pesan untuk jenis pesan yang didukung sebelum mencoba lagi dengan jenis pesan yang didukung.	`400` Bad Request
`131052` Media download error	Tidak dapat mengunduh media yang dikirim oleh pengguna.	Kami tidak dapat mengunduh media yang disertakan dalam pesan pengguna WhatsApp. Untuk informasi selengkapnya, lihat nilai `error.error_data.details` dalam webhook pesan yang dipicu ketika pesan ini diterima. Minta pengguna WhatsApp mengirimi Anda file media menggunakan metode non-WhatsApp.	`400` Bad Request
`131053` Media upload error	Tidak dapat mengunggah media yang digunakan dalam pesan.	Kami tidak dapat mengunggah media untuk satu atau lebih alasan, seperti jenis media yang tidak didukung. Untuk informasi selengkapnya, lihat nilai `error.error_data.details` dalam webhook pesan yang dipicu ketika pesan ini gagal dikirim. Kami menyarankan Anda untuk memeriksa file media apa pun yang menyebabkan kesalahan dan mengonfirmasi 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 mengonfirmasikan apakah jenis MIME-nya didukung. Lihat Jenis Media yang Didukung.	`400` Bad Request
`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` Bad Request
`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` Bad Request
`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` Bad Request
`132007` Template Format Character Policy Violated	Konten template melanggar kebijakan WhatsApp.	Lihat Alasan Penolakan untuk menentukan kemungkinan alasan pelanggaran.	`400` Bad Request
`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` Bad Request
`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` Bad Request
`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` Bad Request
`132068` Flow is blocked	Alur dalam keadaan diblokir.	Perbaiki Alurnya	`400` Bad Request
`132069` Flow is throttled	Alur dalam keadaan terhambat dan 10 pesan yang menggunakan alur ini sudah dikirim dalam satu jam terakhir.	Perbaiki Alurnya	`400` Bad Request
`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 `details` tanggapan 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` Bad Request
`133006` Phone number re-verification needed	Nomor telepon harus diverifikasi sebelum mendaftar.	Verifikasikan nomor telepon sebelum mendaftarkannya.	`400` Bad Request
`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` Bad Request
`133009` Two step verification PIN Guessed Too Fast	PIN verifikasi dua langkah dimasukkan terlalu cepat.	Periksa nilai tanggapan `details` sebelum mencoba lagi.	`400` Bad Request
`133010` Phone number Not Registered	Nomor telepon tidak terdaftar di Platform WhatsApp Business.	Daftarkan nomor telepon sebelum mencoba lagi.	`400` Bad Request
`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` Bad Request
`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` Bad Request

1

API Unknown

Permintaan 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 verifikasikan bahwa permintaan Anda diformat dengan benar serta memenuhi semua persyaratan endpoint.

400

Bad Request

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

Bad Request

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

Bad Request

130472

User's number is part of an experiment

Pesan tidak dikirim sebagai bagian dari eksperimen.

Lihat Eksperimen Pesan Marketing.

400

Bad Request

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

Forbidden

131008

Required parameter is missing

Permintaan kehilangan parameter wajib.

Lihat referensi endpoint untuk menentukan parameter mana yang diperlukan.

400

Bad Request

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

Bad Request

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

Bad Request

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

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

Bad Request

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

Bad Request

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

Bad Request

131049

Meta memilih untuk tidak mengirimkan.

Pesan ini tidak tersampaikan untuk menjaga interaksi ekosistem yang sehat.

Jangan langsung mencoba lagi jika Anda menerima kode kesalahan ini dan menyangka hal itu dikarenakan oleh batasan. Sebaliknya, coba lagi dengan peningkatan waktu yang lebih besar hingga pesan tersampaikan, karena batas tersebut mungkin berlaku untuk periode waktu yang berbeda.

Lihat Batas Pesan Template Marketing Per Pengguna untuk mendapatkan informasi tambahan.

400

Bad Request

131051

Unsupported message type

Jenis pesan tidak didukung.

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

400

Bad Request

131052

Media download error

Tidak dapat mengunduh media yang dikirim oleh pengguna.

Kami tidak dapat mengunduh media yang disertakan dalam pesan pengguna WhatsApp. Untuk informasi selengkapnya, lihat nilai error.error_data.details dalam webhook pesan yang dipicu ketika pesan ini diterima.

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

400

Bad Request

131053

Media upload error

Tidak dapat mengunggah media yang digunakan dalam pesan.

Kami tidak dapat mengunggah media untuk satu atau lebih alasan, seperti jenis media yang tidak didukung.

Untuk informasi selengkapnya, lihat nilai error.error_data.details dalam webhook pesan yang dipicu ketika pesan ini gagal dikirim.

Kami menyarankan Anda untuk memeriksa file media apa pun yang menyebabkan kesalahan dan mengonfirmasi 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 mengonfirmasikan apakah jenis MIME-nya didukung. Lihat Jenis Media yang Didukung.

400

Bad Request

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

Bad Request

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

Bad Request

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

Bad Request

132007

Template Format Character Policy Violated

Konten template melanggar kebijakan WhatsApp.

Lihat Alasan Penolakan untuk menentukan kemungkinan alasan pelanggaran.

400

Bad Request

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

Bad Request

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

Bad Request

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

Bad Request

132068

Flow is blocked

Alur dalam keadaan diblokir.

Perbaiki Alurnya

400

Bad Request

132069

Flow is throttled

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

Perbaiki Alurnya

400

Bad Request

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 details tanggapan 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

Bad Request

133006

Phone number re-verification needed

Nomor telepon harus diverifikasi sebelum mendaftar.

Verifikasikan nomor telepon sebelum mendaftarkannya.

400

Bad Request

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

Bad Request

133009

Two step verification PIN Guessed Too Fast

PIN verifikasi dua langkah dimasukkan terlalu cepat.

Periksa nilai tanggapan details sebelum mencoba lagi.

400

Bad Request

133010

Phone number Not Registered

Nomor telepon tidak terdaftar di Platform WhatsApp Business.

Daftarkan nomor telepon sebelum mencoba lagi.

400

Bad Request

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

Bad Request

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

Bad Request