Kod ralat WhatsApp Cloud API
Ini ialah semua kod ralat WhatsApp Cloud API yang kami dokumentasikan, dalam satu jadual, bersama maksud setiap kod dan sama ada mencuba semula membantu. Kebanyakannya tidak: kod ini bersifat deterministik, jadi permintaan yang sama gagal dengan cara yang sama dan gelung cuba semula menukar permintaan tidak sah menjadi had kadar.
EasyCoexistence memantau sambungan secara berterusan dan merekod peristiwa akaun serta kualiti daripada Meta pada garis masa sambungan.
Permintaan
| Kod | Maksudnya | Cuba semula |
|---|---|---|
| 100 | Satu parameter tidak disokong, tersalah eja atau formatnya tidak sah. | Tidak |
| 131008 | Parameter wajib langsung tidak disertakan. | Tidak |
| 131009 | Parameter ada, tetapi nilainya ditolak oleh endpoint. | Tidak |
| 131021 | Pengirim dan penerima ialah nombor yang sama. | Tidak |
| 131051 | Jenis mesej tidak disokong, selalunya had Coexistence. | Tidak |
| 131052 | Meta tidak dapat memuat turun media yang dihantar oleh pelanggan. | Tidak |
| 131053 | Meta tidak dapat memuat naik media yang anda hantar. Saiz, format atau capaian. | Tidak |
Template
| Kod | Maksudnya | Cuba semula |
|---|---|---|
| 132000 | Bilangan parameter tidak sepadan dengan template. | Tidak |
| 132001 | Tiada template dengan pasangan nama dan bahasa tersebut. | Tidak |
| 132007 | Template melanggar dasar pemesejan. Tulis semula dan hantar semula. | Tidak |
| 132012 | Format parameter tidak sepadan dengan yang ditetapkan oleh template. | Tidak |
| 132015 | Template dijeda selepas kualitinya merosot. Sementara sahaja. | Tunggu |
| 132016 | Template dinyahdayakan secara kekal. Ia tidak akan kembali. | Tidak |
Tetingkap dan penerima
Pendaftaran dan PIN
| Kod | Maksudnya | Cuba semula |
|---|---|---|
| 131045 | Nombor itu tidak pernah didaftarkan untuk pemesejan Cloud API. | Tidak |
| 133010 | Nombor itu tidak berdaftar. Pendaftaran mesti diselesaikan. | Tidak |
| 133006 | Nombor itu mesti disahkan sebelum boleh didaftarkan. | Tidak |
| 133005 | PIN pengesahan dua langkah salah. Berhenti meneka. | Tidak |
| 133008 | Terlalu banyak cubaan PIN. Pendaftaran dikunci untuk satu tempoh. | Tunggu |
Akses dan akaun
| Kod | Maksudnya | Cuba semula |
|---|---|---|
| 190 | Token akses telah tamat tempoh atau dibatalkan. | Tidak |
| 368 | Akaun dihadkan selepas pelanggaran dasar. | Tidak |
| 131031 | Akaun dihadkan, atau datanya tidak sepadan dengan data Meta. | Tidak |
| 131042 | Masalah pembayaran pada akaun perniagaan menghalang penghantaran. | Tidak |
| 131049 | Meta menyekat mesej itu untuk melindungi kesihatan ekosistem. | Tidak |
Had kadar
| Kod | Maksudnya | Cuba semula |
|---|---|---|
| 130429 | Had throughput pemesejan akaun telah dicapai. | Tunggu |
| 131048 | Had kadar spam telah dicapai. Puncanya kualiti, bukan jumlah. | Tidak |
| 131056 | Terlalu banyak mesej antara nombor anda dan seorang penerima. | Tidak |
| 80007 | Akaun mencapai had panggilan pengurusan. Biasanya akibat tinjauan berulang (polling). | Tunggu |
Sementara
Penyegerakan Coexistence
Cara membaca lajur cuba semula
Lajur ini mempunyai tiga nilai, dan tersalah memilih antara nilai tersebut ialah kesilapan paling mahal dalam keseluruhan rujukan ini.
Tidak bermaksud kegagalan itu bersifat deterministik. Permintaan, template atau keadaan penerima yang gagal, dan menghantar permintaan yang sama sekali lagi menghasilkan ralat yang sama sambil menggunakan throughput yang mungkin anda perlukan kemudian. Ya bermaksud kegagalan berlaku di pihak Meta dan jeda semula benar-benar menyelesaikannya. Tunggu bermaksud keadaan itu nyata tetapi sementara: had atau kunci yang akan terangkat sendiri, dan mencuba semula sebelum itu tidak membantu malah boleh memanjangkannya.
Mengapa kebanyakannya tidak boleh dicuba semula
Kerana platform mengembalikan kod khusus, bukan kod umum. Parameter yang tidak sah, template yang tidak wujud, tetingkap pemesejan yang tertutup dan penerima yang menarik diri semuanya boleh dikenal pasti ketika respons diterima. Jadi, Meta menamakannya dengan jelas dan bukan gagal secara samar.
- Masalah permintaan tidak menjadi betul pada cubaan kedua.
- Masalah template berada dalam template itu sendiri, yang tidak boleh diubah oleh permintaan.
- Masalah tetingkap atau pilihan keluar berkaitan dengan keadaan penerima, bukan keadaan anda.
- Sekatan akaun ialah keputusan, dan mencuba semula bukan rayuan.
Perkara yang perlu dilog apabila salah satu kod ini muncul
Maklumat yang mencukupi untuk mendiagnosisnya tanpa menghasilkannya semula, iaitu perbezaan antara pembaikan lima minit dengan sehari meneka.
- Respons ralat penuh, termasuk ID jejak, yang diperlukan oleh sokongan Meta.
- Isi badan permintaan seperti yang dihantar, bukan seperti yang dimaksudkan. Jurang antara kedua-duanya biasanya ialah puncanya.
- ID nombor telefon, supaya masalah pada satu nombor dapat dibezakan daripada masalah merentas akaun.
- Cap masa, supaya kegagalan boleh disemak berbanding keadaan sambungan pada ketika itu.
Kod yang hanya wujud pada Coexistence
Dua kod, dan kedua-duanya mengelirukan kerana kelihatan seperti kegagalan penghantaran biasa. 2593107 dan 2593108 berkaitan dengan penyegerakan sejarah chat, iaitu langkah menyalin perbualan terkini daripada aplikasi WhatsApp Business apabila nombor mula disambungkan.
Kod ini bukan ralat pemesejan dan tidak bermaksud sambungan gagal. Penyegerakan yang melebihi had atau berjalan di luar tetingkapnya meninggalkan nombor dalam keadaan bersambung dan boleh menghantar seperti biasa, tetapi dengan sejarah yang disalin kurang daripada jangkaan. Membacanya sebagai sambungan rosak menyebabkan orang memutuskan sambungan dan bermula semula, lalu kehilangan lebih banyak sejarah dan bukannya memulihkannya.
Soalan lazim
Ralat manakah yang patut saya cuba semula?
131016 dan 131000, dengan jeda eksponen. 130429, 132015 dan 133008 pulih sendiri jika anda menunggu. Yang lain bersifat deterministik.
Adakah kod ralat bermaksud nombor saya terputus sambungan?
Biasanya tidak. Kebanyakannya berkaitan dengan permintaan, template atau penerima. Masalah sambungan muncul sebagai webhook akaun dan kualiti, bukan ralat penghantaran.
Apakah ID jejak?
Pengenal dalam respons ralat yang membolehkan sokongan Meta mencari permintaan tertentu. Logkannya bagi setiap kegagalan; tanpanya, tiket tidak dapat diambil tindakan.
Adakah kod ini sama pada setiap penyedia?
Ya. Kod ini datang daripada Cloud API Meta, jadi sama sahaja walau apa pun penyedia yang menyambungkan nombor itu. Penyedia hanya boleh mengubah sejauh mana jelasnya kod tersebut sampai kepada anda.
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaTiada caj selama 3 hari. Batalkan pada bila-bila masa.