Kode kesalahan WhatsApp Cloud API
Ini adalah semua kode kesalahan WhatsApp Cloud API yang kami dokumentasikan, dalam satu tabel, beserta artinya dan apakah mencoba kembali akan membantu. Sebagian besar tidak: sifatnya deterministik, sehingga permintaan yang sama gagal dengan cara yang sama dan pengulangan permintaan buruk berubah menjadi pembatasan laju.
EasyCoexistence memantau koneksi secara terus-menerus dan mencatat event akun dan peringkat kualitas milik Meta di linimasa koneksi.
Permintaan
| Kode | Artinya | Coba kembali |
|---|---|---|
| 100 | Sebuah parameter tidak didukung, salah eja, atau formatnya salah. | Tidak |
| 131008 | Parameter wajib sama sekali tidak disertakan. | Tidak |
| 131009 | Parameter ada, tetapi nilainya ditolak oleh endpoint. | Tidak |
| 131021 | Pengirim dan penerima adalah nomor yang sama. | Tidak |
| 131051 | Jenis pesan tidak didukung, sering kali karena batasan Coexistence. | Tidak |
| 131052 | Meta tidak dapat mengunduh media yang dikirim pelanggan. | Tidak |
| 131053 | Meta tidak dapat mengunggah media yang Anda kirim. Ukuran, format, atau aksesibilitas. | Tidak |
Template
| Kode | Artinya | Coba kembali |
|---|---|---|
| 132000 | Jumlah parameter tidak sesuai dengan template. | Tidak |
| 132001 | Tidak ada template dengan pasangan nama dan bahasa tersebut. | Tidak |
| 132007 | Template melanggar kebijakan pesan. Tulis ulang dan ajukan kembali. | Tidak |
| 132012 | Format parameter tidak sesuai dengan yang ditetapkan template. | Tidak |
| 132015 | Template dijeda setelah kualitasnya menurun. Bersifat sementara. | Tunggu |
| 132016 | Template dinonaktifkan secara permanen dan tidak akan kembali. | Tidak |
Jendela dan penerima
| Kode | Artinya | Coba kembali |
|---|---|---|
| 131047 | Jendela layanan pelanggan 24 jam sudah tertutup. Kirim template. | Tidak |
| 131026 | Penerima sama sekali tidak dapat menerima pesan. | Tidak |
| 131050 | Orang tersebut berhenti berlangganan. Memang sengaja tidak ada cara mengakalinya. | Tidak |
| 130497 | Pengiriman pesan ke negara tersebut dibatasi untuk akun Anda. | Tidak |
Pendaftaran dan PIN
| Kode | Artinya | Coba kembali |
|---|---|---|
| 131045 | Nomor tidak pernah didaftarkan untuk pesan Cloud API. | Tidak |
| 133010 | Nomor belum terdaftar. Pendaftaran harus diselesaikan. | Tidak |
| 133006 | Nomor harus diverifikasi sebelum dapat didaftarkan. | Tidak |
| 133005 | PIN verifikasi dua langkah salah. Berhenti menebak. | Tidak |
| 133008 | Terlalu banyak percobaan PIN. Pendaftaran dikunci untuk sementara waktu. | Tunggu |
Akses dan akun
| Kode | Artinya | Coba kembali |
|---|---|---|
| 190 | Token akses kedaluwarsa atau dibatalkan. | Tidak |
| 368 | Akun dibatasi setelah pelanggaran kebijakan. | Tidak |
| 131031 | Akun dibatasi, atau datanya tidak cocok dengan data Meta. | Tidak |
| 131042 | Masalah pembayaran pada akun bisnis menghalangi pengiriman. | Tidak |
| 131049 | Meta memblokir pesan untuk menjaga kesehatan ekosistem. | Tidak |
Pembatasan laju
Sementara
Sinkronisasi Coexistence
Cara membaca kolom mencoba kembali
Kolom ini memiliki tiga nilai, dan salah memilih di antaranya adalah kesalahan paling mahal dalam seluruh referensi ini.
Tidak berarti kegagalannya deterministik. Permintaan, template, atau status penerima yang gagal, dan mengirimkan permintaan identik lagi akan menghasilkan kesalahan identik sambil menghabiskan throughput yang mungkin Anda perlukan nanti. Ya berarti kegagalan terjadi di sisi Meta dan jeda bertahap benar-benar menyelesaikannya. Tunggu berarti kondisinya nyata tetapi sementara: pembatasan atau penguncian yang terangkat sendiri. Mencoba kembali sebelum kondisi itu berakhir tidak menghasilkan apa-apa dan dapat memperpanjangnya.
Mengapa sebagian besar kode ini tidak dapat dicoba kembali
Karena platform mengembalikan kode khusus, bukan kode umum. Parameter yang formatnya salah, template yang tidak ada, jendela pesan yang tertutup, dan penerima yang berhenti berlangganan semuanya dapat diketahui saat respons diterima, sehingga Meta menyebutkannya secara spesifik alih-alih gagal secara samar.
- Masalah pada permintaan tidak menjadi benar pada percobaan kedua.
- Masalah template berada di dalam template, yang tidak dapat diubah oleh permintaan.
- Masalah jendela atau berhenti berlangganan berkaitan dengan status penerima, bukan status Anda.
- Pembatasan akun adalah keputusan, dan mencoba kembali bukanlah banding.
Apa yang harus dicatat saat salah satu kode ini muncul
Catat informasi yang cukup untuk mendiagnosisnya tanpa mereproduksi masalah, karena itulah perbedaan antara perbaikan lima menit dan sehari penuh menebak.
- Respons kesalahan lengkap, termasuk trace id, yang diminta dukungan Meta.
- Isi permintaan sebagaimana dikirim, bukan sebagaimana dimaksud. Perbedaan antara keduanya biasanya adalah sumber masalah.
- ID nomor telepon, agar masalah pada satu nomor dapat dibedakan dari masalah yang terjadi di seluruh akun.
- Stempel waktu, agar kegagalan dapat diperiksa terhadap status koneksi pada saat itu.
Kode yang hanya ada di Coexistence
Ada dua kode, dan keduanya membingungkan karena tampak seperti kegagalan pengiriman biasa. 2593107 dan 2593108 sama-sama berkaitan dengan sinkronisasi riwayat chat, yaitu langkah yang menyalin percakapan terbaru dari aplikasi WhatsApp Business saat sebuah nomor pertama kali terhubung.
Keduanya bukan kesalahan pengiriman pesan dan tidak berarti koneksi gagal. Sinkronisasi yang melebihi batas atau berjalan di luar jendelanya tetap membuat nomor terhubung dan dapat mengirim seperti biasa, tetapi dengan riwayat yang tersalin lebih sedikit dari yang diharapkan. Menganggapnya sebagai koneksi yang rusak dapat membuat orang memutus koneksi lalu memulai lagi, sehingga lebih banyak riwayat hilang alih-alih dipulihkan.
Pertanyaan yang sering diajukan
Kesalahan mana yang harus saya coba kembali?
131016 dan 131000, dengan jeda eksponensial. 130429, 132015, dan 133008 hilang sendiri jika Anda menunggu. Selain itu, semuanya deterministik.
Apakah kode kesalahan berarti nomor saya terputus?
Biasanya tidak. Sebagian besar berkaitan dengan permintaan, template, atau penerima. Masalah koneksi muncul sebagai webhook akun dan kualitas, bukan sebagai kesalahan pengiriman.
Apa itu trace id?
Pengenal dalam respons kesalahan yang membantu dukungan Meta menemukan permintaan tertentu. Catat pada setiap kegagalan; tanpa ini, tiket tidak dapat ditindaklanjuti.
Apakah kode ini sama di setiap penyedia?
Ya. Kode ini berasal dari Cloud API Meta, jadi identik pada penyedia mana pun yang menghubungkan nomor tersebut. Penyedia hanya dapat mengubah seberapa jelas kode itu sampai kepada Anda.
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisTidak ada biaya selama 3 hari. Batalkan kapan saja.