MasukMulai uji coba gratis
Meta Tech Provider

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.

Pesan tidak disimpan secara defaultWhatsApp Business App + Cloud APIMCP untuk Claude dan ChatGPTAktif dalam 2 menit

Permintaan

KodeArtinyaCoba kembali
100Sebuah parameter tidak didukung, salah eja, atau formatnya salah.Tidak
131008Parameter wajib sama sekali tidak disertakan.Tidak
131009Parameter ada, tetapi nilainya ditolak oleh endpoint.Tidak
131021Pengirim dan penerima adalah nomor yang sama.Tidak
131051Jenis pesan tidak didukung, sering kali karena batasan Coexistence.Tidak
131052Meta tidak dapat mengunduh media yang dikirim pelanggan.Tidak
131053Meta tidak dapat mengunggah media yang Anda kirim. Ukuran, format, atau aksesibilitas.Tidak

Template

KodeArtinyaCoba kembali
132000Jumlah parameter tidak sesuai dengan template.Tidak
132001Tidak ada template dengan pasangan nama dan bahasa tersebut.Tidak
132007Template melanggar kebijakan pesan. Tulis ulang dan ajukan kembali.Tidak
132012Format parameter tidak sesuai dengan yang ditetapkan template.Tidak
132015Template dijeda setelah kualitasnya menurun. Bersifat sementara.Tunggu
132016Template dinonaktifkan secara permanen dan tidak akan kembali.Tidak

Jendela dan penerima

KodeArtinyaCoba kembali
131047Jendela layanan pelanggan 24 jam sudah tertutup. Kirim template.Tidak
131026Penerima sama sekali tidak dapat menerima pesan.Tidak
131050Orang tersebut berhenti berlangganan. Memang sengaja tidak ada cara mengakalinya.Tidak
130497Pengiriman pesan ke negara tersebut dibatasi untuk akun Anda.Tidak

Pendaftaran dan PIN

KodeArtinyaCoba kembali
131045Nomor tidak pernah didaftarkan untuk pesan Cloud API.Tidak
133010Nomor belum terdaftar. Pendaftaran harus diselesaikan.Tidak
133006Nomor harus diverifikasi sebelum dapat didaftarkan.Tidak
133005PIN verifikasi dua langkah salah. Berhenti menebak.Tidak
133008Terlalu banyak percobaan PIN. Pendaftaran dikunci untuk sementara waktu.Tunggu

Akses dan akun

KodeArtinyaCoba kembali
190Token akses kedaluwarsa atau dibatalkan.Tidak
368Akun dibatasi setelah pelanggaran kebijakan.Tidak
131031Akun dibatasi, atau datanya tidak cocok dengan data Meta.Tidak
131042Masalah pembayaran pada akun bisnis menghalangi pengiriman.Tidak
131049Meta memblokir pesan untuk menjaga kesehatan ekosistem.Tidak

Pembatasan laju

KodeArtinyaCoba kembali
130429Batas throughput pesan akun telah tercapai.Tunggu
131048Pembatasan laju spam tercapai. Penyebabnya kualitas, bukan volume.Tidak
131056Terlalu banyak pesan antara nomor Anda dan satu penerima.Tidak
80007Akun mencapai batas panggilan manajemen. Biasanya akibat polling.Tunggu

Sementara

KodeArtinyaCoba kembali
131016Layanan Meta untuk sementara tidak tersedia.Ya
131000Kegagalan tanpa klasifikasi. Coba kembali sekali, lalu eskalasikan dengan trace id.Ya

Sinkronisasi Coexistence

KodeArtinyaCoba kembali
2593107Batas sinkronisasi riwayat chat terlampaui.Tidak
2593108Sinkronisasi dicoba di luar jendela sinkronisasi 24 jam.Tidak

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.

Lanjut membaca