API Cloud WhatsApp

Platform WhatsApp Business

Kode kesalahan

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 webhook berikut:

  • entry.changes.value.errors
  • entry.changes.value.messages.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>" } }

Isi 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": "Cloud API message throughput has been reached."
    },
    "error_subcode": 2494055,
    "fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
  }
}

Kesalahan otorisasi

Kode Detail Kemungkinan alasan dan 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 memverifikasi bahwa aplikasi Anda telah diberikan izin yang diperlukan oleh endpoint. Lihat Kesalahan Autentikasi dan Otorisasi.

500

Kesalahan Server Internal

10

Permission Denied

Izin tidak diberikan atau sudah dihapus.

Gunakan debugger token akses untuk memverifikasi bahwa aplikasi Anda telah diberikan izin yang diperlukan oleh endpoint.

Lihat Kesalahan Autentikasi dan Otorisasi.

Untuk WhatsApp Flows dengan Endpoint - pastikan nomor telepon yang digunakan untuk mengatur kunci publik bisnis sudah dimasukkan ke daftar diizinkan.

Lihat persyaratan kelayakan untuk API yang Anda coba akses. Jika Anda tidak memenuhi syarat untuk mengakses endpoint, Anda akan menerima kode kesalahan ini.

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 bahwa aplikasi Anda telah diberikan izin yang diperlukan oleh endpoint. Lihat Kesalahan Autentikasi dan Otorisasi.

403

Forbidden

Kesalahan integritas

Kode Detail Kemungkinan alasan dan 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 mengirim pesan kepada pengguna di negara tertentu.

Lihat Kebijakan Pengiriman Pesan WhatsApp untuk Bisnis untuk mengetahui detail negara yang diizinkan untuk pengiriman pesan di 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 pembuatan template

KesalahanDeskripsiKemungkinan Solusi

2388040 - Melebihi batas karakter

Kolom dalam template Anda telah melebihi batas karakter maksimal yang diizinkan.

Lihat pesan kesalahan untuk detail spesifik tentang kolom yang terpengaruh dan batas karakter yang terkait.

2388047 - Format header pesan salah

Judul pesan Anda berisi format yang tidak valid.

Lihat pesan kesalahan untuk mengetahui detail spesifik tentang pemformatan yang valid.

2388072 - Format isi pesan salah

Isi pesan Anda berisi format yang tidak valid.

Lihat pesan kesalahan untuk mengetahui detail spesifik tentang pemformatan yang valid.

2388073 - Format footer pesan salah

Footer pesan Anda berisi format yang tidak valid.

Lihat pesan kesalahan untuk mengetahui detail spesifik tentang pemformatan yang valid.

2388293 - Rasio kata parameter melebihi batas

Template ini memiliki terlalu banyak variabel untuk panjangnya. Kurangi jumlah variabel atau panjangkan pesan.

Lihat pesan kesalahan untuk mengetahui detail spesifik tentang pemformatan yang valid.

2388299 - Parameter di depan atau di belakang tidak diizinkan

Variabel tidak boleh berada di awal atau akhir template.

Lihat pesan kesalahan untuk mengetahui detail spesifik tentang pemformatan yang valid.

Kesalahan kirim template

KesalahanDeskripsiKemungkinan Solusi

2388019 - Melebihi Batas Template Pesan

Anda telah melampaui jumlah maksimum template pesan yang bisa Anda miliki untuk akun WhatsApp Business ini.

Akun WhatsApp Business bisa memiliki maksimal 250 template pesan. Lihat Batas template.

Kesalahan migrasi telepon

ErrorDescriptionPossible Solution

2388001 - Please confirm ownership of this phone number.

Certificate can be downloaded only after confirming ownership of a phone number that is being migrated.

In order to download the certificate and proceed with registration, register and and verify the number.

2388001 - Please ensure two-step authentication is disabled.

Two-step authentication must be disabled for this phone number.

In your WhatsApp Business Manager Settings, turn off two-step verification.

2388012 - This phone number already exists in your list of phone numbers.

The phone number you are trying to migrate is already present in your WhatsApp account.

Try again with a phone number that is not already present in your WhatsApp account.

2388091, 2388093 - This phone number isn’t eligible to receive/verify a registration code since it is not being migrated.

Phone ownership verification APIs are not available for this use case.

Register and verify the number.

2388103 - Cannot migrate phone number.

Webhooks have not been set up for the destination WhatsApp Business account.

Subscribe your app to webhooks on the destination WhatsApp Business account.

2388103 - Please add this phone number in your WhatsApp account

This phone number is eligible to be added directly, and does not need to use phone migration APIs.

Register and verify the number.

2388103 - Registered name should be present and approved.

The business phone number must have an approved display name (name_status is APPROVED) and cannot have any associated pending display name change requests.

Get your business phone number's display name approved.

2388103 - The WhatsApp account that this phone number is registered with is not set up correctly.

The source WhatsApp Business Account must be approved, and its "messaging on behalf of" must be approved.

The WhatsApp Business Account may be using the now deprecated On-Behalf-Of ownership model.

Contact support.

2388103 - Your WhatsApp account does not have a payment account.

Your WhatsApp account must have an active credit line in order to send messages after migration.

Set up a credit line and share it with the business customer.

2388103 - There was an error migrating this phone number.

Something went wrong when trying to migrate your phone number.

Try again after some time. If that doesn’t work, contact support.

2388103 - This phone number belongs to a different Business Manager account.

The source and destination WABAs must represent the same business.

Migrate the phone number into a WhatsApp Business Account that is messaging for the same business as the source WhatsApp Business Account.

2388103 - Your WhatsApp account must be approved

The destination WhatsApp Business Account must be approved before you can migrate phone numbers.

Ensure business verification is completed, and the WhatsApp Business Account review status is approved.

2388103 - Your WhatsApp account’s "Messaging For" request must be approved

The destination WhatsApp Business Account "Messaging For" request must be approved by the client.

Ask your client to accept your "Messaging For" request in the Meta Business Suite.

2494100 - Account is in maintenance mode.

The business phone number is in maintenance mode.

Try again in a few minutes.

Kesalahan insight template

KesalahanDeskripsiKemungkinan Solusi

200005 - Insight template tidak tersedia

Insight template belum tersedia untuk akun WhatsApp Business ini.

Anda tidak bisa mengaktifkan insight template untuk akun WhatsApp Business ini saat ini.

200006 - Tidak bisa menonaktifkan insight template

Operasi tidak valid. Insight Template tidak bisa dinonaktifkan setelah diaktifkan.

Insight template tidak bisa dinonaktifkan setelah diaktifkan untuk akun WhatsApp Business.

200007 - Insight Template tidak diaktifkan

Insight Template belum diaktifkan untuk Akun WhatsApp Business ini

Untuk mengaktifkan insight template, lihat Mengonfirmasi analitik template.

Kesalahan Akun WhatsApp Business

KesalahanDeskripsiKemungkinan Solusi

2593079

Insight template tidak tersedia

WABA ini sudah ditandai untuk migrasi ke ID solusi lain

Model kepemilikan akun OBO sekarang tidak berlaku lagi. Hubungi dukungan.

2593085

Akun WhatsApp Business untuk Mobilitas OBO Tidak Valid

WABA tidak memenuhi syarat untuk transfer kepemilikan OBO. Kemungkinan penyebabnya adalah:

  • WABA sudah dimiliki oleh pelanggan bisnis (yaitu sudah menggunakan model Berbagi WABA).
  • Pelanggan bisnis belum menerima permintaan OBO di Meta Business Suite.

Perhatikan bahwa model kepemilikan akun OBO sekarang tidak berlaku lagi. Hubungi dukungan.

Kesalahan sinkronisasi

Kode Detail Kemungkinan alasan dan solusi Kode Status HTTP

2593107

Batas Permintaan Sinkronisasi terlampaui

Anda telah melampaui jumlah maksimum pemanggilan api sinkronisasi untuk nomor telepon ini.

Anda hanya dapat memanggil endpoint ini sekali untuk menyinkronkan kontak nomor telepon bisnis dan sekali untuk menyinkronkan riwayat berkirim pesan. Lihat Onboarding pengguna aplikasi bisnis.

Mengeluarkan pelanggan bisnis dan mendaftarkan mereka kembali.

400

Permintaan Buruk

2593108

Permintaan Sinkronisasi dibuat di luar periode waktu yang diizinkan

Permintaan sinkronisasi hanya dapat dilakukan dalam waktu 24 jam setelah pendaftaran

Anda hanya bisa memulai sinkronisasi kontak dan riwayat berkirim pesan pengguna aplikasi WhatsApp Business yang sudah onboarding dalam waktu 24 jam setelah onboarding pengguna. Lihat Onboarding pengguna aplikasi bisnis.

Offboarding pengguna dan onboarding pengguna kembali.

400

Permintaan Buruk

Kesalahan pelambatan

Kode Detail Kemungkinan alasan dan 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 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. Lihat Batas template dan Kualitas template.

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

Batas laju pembatalan pendaftaran akun terlampaui

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 lain

Kode Detail Kemungkinan alasan dan 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 verifikasi 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 muatan.

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 menyertakan satu atau lebih parameter yang tidak didukung atau salah eja.

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

Untuk WhatsApp Flows dengan Endpoint - pastikan saat mengatur kunci publik bisnis, kunci tersebut adalah kunci 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

Nomor pengguna adalah bagian dari eksperimen

Pesan tidak dikirim sebagai bagian dari eksperimen.

Lihat Eksperimen Pesan Marketing.

400

Permintaan Buruk

131000

Ada masalah

Pesan gagal dikirim karena kesalahan yang tidak diketahui.

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

Untuk WhatsApp Flows dengan Endpoint - saat mengatur kunci publik bisnis, proses ini gagal menghitung tanda tangan, memanggil endpoint GraphQL, atau endpoint GraphQL menampilkan kesalahan.

500

Kesalahan Server Internal

131005

Access denied

Izin tidak diberikan atau sudah dihapus.

Gunakan debugger token akses untuk memverifikasi bahwa aplikasi Anda telah diberikan izin yang diperlukan oleh endpoint. Lihat Kesalahan autentikasi dan otorisasi.

403

Forbidden

131008

Required parameter is missing

Permintaan tidak menyertakan parameter yang wajib.

Lihat referensi endpoint untuk menentukan parameter mana yang wajib.

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 tidak tersedia untuk sementara.

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.
  • 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

Permintaan Buruk

131037

Nomor yang disediakan WhatsApp memerlukan persetujuan nama tampilan sebelum pesan dapat dikirim.

Nomor telepon bisnis 555 yang digunakan untuk mengirim permintaan tidak memiliki nama tampilan yang disetujui.

Ubah nama tampilan nomor telepon bisnis 555. Lihat juga artikel Pusat Bantuan Cara mengubah nama tampilan WhatsApp Business Anda.

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 (Hubungan Atas Nama) menunggu persetujuan atau ditolak

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.

Kirim pesan template kepada penerima.

400

Permintaan Buruk

131049

Meta memilih untuk tidak mengirimkan.

Pesan ini tidak tersampaikan untuk menjaga interaksi ekosistem yang sehat.

Jika Anda menerima kode kesalahan ini dan menduga ini karena masalah batasan, tunggu setidaknya 24 jam sebelum mengirim ulang pesan template. Melakukannya hanya akan menghasilkan tanggapan kesalahan lain karena batas tersebut mungkin berlaku untuk periode waktu yang berbeda-beda.

Lihat Batas Pengiriman Pesan Template Marketing Per-Pengguna untuk informasi tambahan.

400

Permintaan Buruk

131050

Pengguna telah berhenti menerima pesan marketing.

Tidak dapat mengirimkan pesan. Penerima ini telah memilih untuk berhenti menerima pesan marketing di WhatsApp dari bisnis Anda.

Jangan mencoba lagi untuk mengirim pesan ke pengguna ini karena pesan tersebut tidak akan diterima. Untuk mendapatkan pemberitahuan setiap kali pengguna WhatsApp menghentikan atau melanjutkan pengiriman pesan template marketing dari bisnis Anda, berlanggananlah ke webhook user_preferences.

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

Permintaan Buruk

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

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 upgradethroughput.

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 dokumen Template kami untuk mempelajari tentang parameter dan pastikan permintaan menyertakan nilai untuk semua parameter yang diperlukan oleh 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 lokale bahasa sudah benar. Lihat dokumen Template kami untuk mempelajari selengkapnya tentang template.

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 dokumen Kualitas template kami untuk mempelajari cara memeriksa status template Anda.

400

Permintaan Buruk

132007

Template Format Character Policy Violated

Konten template melanggar kebijakan WhatsApp.

Lihat dokumen Tinjauan template kami untuk mempelajari tentang 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 dokumen Template kami untuk mempelajari selengkapnya tentang parameter dan format template.

400

Permintaan Buruk

132015

Template Dijeda

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 Dinonaktifkan

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

Buat template baru dengan konten yang berbeda.

400

Permintaan Buruk

132068

Alur diblokir

Alur dalam keadaan diblokir.

Perbaiki Alurnya

400

Permintaan Buruk

132069

Alur terhambat

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 tidak tersedia untuk sementara.

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

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 mengatur ulang PIN, nonaktifkan verifikasi dua langkah, lalu atur PIN baru. Lihat Verifikasi dua langkah.

400

Permintaan Buruk

133006

Phone number re-verification needed

Nomor telepon perlu diverifikasi sebelum mendaftar.

Verifikasikan dan daftarkan nomor telepon.

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

134011

Ketentuan layanan WhatsApp Payments belum diterima

Pesan gagal terkirim karena penerimaan ketentuan layanan WhatsApp Payments tertunda untuk Akun WhatsApp Business ini.

Terima ketentuan layanan WhatsApp Payments menggunakan tautan yang disediakan dalam pesan kesalahan sebelum mencoba lagi.

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

Kode Kesalahan Marketing Messages API untuk WhatsApp

MM API untuk WhatsApp menggunakan kode kesalahan yang sama dengan Cloud API, dengan beberapa tambahan yang tercantum di bawah ini.

Contoh

{
  "error": {
    "message": "(#100) Invalid parameter",
    "type": "OAuthException",
    "code": 100,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "Message must be a template message."
    },
    "fbtrace_id": "Ak6nxJSySLEJz32Ps-QiZ1t"
  }
}

Kode

KodePesanDetailKemungkinan alasan dan solusi Kode
status
HTTP

100

(#100) Invalid parameter

Message must be a template message.

Anda mencoba mengirim pesan non-template. Jenis pesan harus template. Coba lagi menggunakan template marketing.

400 Permintaan Buruk

131009

(#131009) Parameter value is not valid

One or more parameter values are invalid.

Anda mungkin menggunakan parameter yang tidak valid. Verifikasikan bahwa Anda menggunakan parameter yang valid dan coba lagi.

Sinkronisasi iklan mungkin tidak selesai. Tunggu 10 menit dan coba lagi. Jika masalah berlanjut, hubungi dukungan.

400 Permintaan Buruk

131055

(#131055) Method not allowed

Only marketing template messages are supported

Anda mungkin telah mencoba mengirim pesan non-template, atau template autentikasi atau utilitas. Coba kirim lagi menggunakan pesan template marketing.

400 Permintaan Buruk

134100

(#134100) Only marketing messages supported

You're only able to send marketing messages on this API.

Akan tersedia dengan Graph API versi 23.0.

Anda mencoba mengirim templat utilitas atau autentikasi. Hanya template yang dikategorikan sebagai MARKETING yang didukung.

400 Permintaan Buruk

134101

(#134101) Your template is still syncing

When you send a message from a template, the template syncing process can take up to 10 minutes to complete. Wait a few minutes, and then try sending your message again.

Akan tersedia dengan Graph API versi 23.0.

Anda mencoba mengirim template yang baru dibuat sebelum menyelesaikan sinkronisasi Iklan. Sinkronisasi iklan bisa memakan waktu sampai 10 menit. Tunggu 10 menit dan coba lagi.

400 Permintaan Buruk

134102

(#134102) Template unavailable for use

Please check your eligibility status to ensure you are onboarded (https://developers.facebook.com/docs/whatsapp/marketing-messages-api-for-whatsapp/onboarding#ensure-you-are-eligible-to-onboard) or contact Meta's customer support.

Akan tersedia dengan Graph API versi 23.0.

Kami tidak dapat menyelesaikan sinkronisasi Iklan untuk template yang Anda coba kirim, atau Anda mungkin tidak memenuhi syarat MM API untuk WhatsApp.

Periksa status kelayakan Anda. Jika nilai marketing_messages_lite_api_status Akun WhatsApp Business adalah ONBOARDED, dan masalah masih berlanjut, silakan hubungi dukungan.

500 Kesalahan Server Internal

1752041

(#1752041) Duplicate Request

Duplicate Request is thrown when a client has already been invited to onboard by any partner.

Permintaan onboarding dibatasi satu per pelanggan bisnis, dengan hanya mitra pertama yang memanggil intent API yang berhasil mengirimkan permintaan. Saat klien sudah onboarding, semua Akun WhatsApp Business (WABA) mereka yang memenuhi syarat akan disertakan dalam prosesnya secara otomatis.

Jika Anda menerima kesalahan yang menunjukkan bahwa permintaan onboarding telah dibuat, tidak diperlukan tindakan lebih lanjut, karena semua WABA yang memenuhi syarat untuk klien tersebut akan onboarding tanpa langkah tambahan.

400 Permintaan Buruk