Meta Tech Provider

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.

Tiada penyimpanan mesejAplikasi Perniagaan + Cloud APIMCP untuk Claude dan ChatGPTHidup dalam 2 minit

Request

Code	What it means	Retry
100	A parameter is unsupported, misspelled or malformed.	No
131008	A required parameter was not included at all.	No
131009	A parameter is present with a value the endpoint rejects.	No
131021	Sender and recipient are the same number.	No
131051	The message type is not supported, often a Coexistence limit.	No
131052	Meta could not download media a customer sent.	No
131053	Meta could not upload media you sent. Size, format or reach.	No

Template

Code	What it means	Retry
132000	The number of parameters does not match the template.	No
132001	No template exists with that name and language pair.	No
132007	The template breaks messaging policy. Rewrite and resubmit.	No
132012	Parameter format does not match what the template defines.	No
132015	The template is paused after a quality decline. Temporary.	Wait
132016	The template is permanently disabled. It will not come back.	No

Window and recipient

Code	What it means	Retry
131047	The 24-hour service window is closed. Send a template.	No
131026	The recipient cannot receive the message at all.	No
131050	The person opted out. There is no workaround, by design.	No
130497	Messaging that country is restricted for your account.	No

Registration and PIN

Code	What it means	Retry
131045	The number was never registered for Cloud API messaging.	No
133010	The number is not registered. Registration must be completed.	No
133006	The number must be verified before it can be registered.	No
133005	The two-step verification PIN was wrong. Stop guessing.	No
133008	Too many PIN attempts. Registration is locked for a period.	Wait

Access and account

Code	What it means	Retry
190	The access token expired or was invalidated.	No
368	The account is restricted after a policy violation.	No
131031	The account is restricted, or its data does not match Meta's.	No
131042	A payment problem on the business account blocks sending.	No
131049	Meta blocked the message to protect ecosystem health.	No

Rate limits

Code	What it means	Retry
130429	The account's messaging throughput limit was reached.	Wait
131048	A spam rate limit was hit. Quality, not volume, is the cause.	No
131056	Too many messages between your number and one recipient.	No
80007	The account hit its management call limit. Usually polling.	Wait

Transient

Code	What it means	Retry
131016	A Meta service is temporarily unavailable.	Yes
131000	Unclassified failure. Retry once, then escalate with the trace id.	Yes

Coexistence sync

Code	What it means	Retry
2593107	The chat history synchronisation limit was exceeded.	No
2593108	A sync was attempted outside the 24-hour sync window.	No

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 7 hari. Batalkan pada bila-bila masa.

Teruskan membaca

ReferenceWhatsApp error 131047: re-engagement messageError 131047 means more than 24 hours have passed since that customer last messaged you, so the customer service window is closed and free text will not deliver.ReferenceWhatsApp error 100: invalid parameterError 100 means the request carried a parameter Meta does not accept: unsupported, misspelled, or the wrong shape for that endpoint.ReferenceWhatsApp error 131016: service unavailableError 131016 means a service on Meta's side is temporarily unavailable.ReferenceA number stopped working: how to find out whyWhen a connected number stops working, the cause is almost never the code.ReferenceWhatsApp webhook fields, and which ones go whereA WhatsApp Business Account delivers events as named fields.GuideWhatsApp Coexistence: the app and the API on one numberCoexistence is Meta's official mode for running the WhatsApp Business app and the Cloud API on one number at the same time.