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.

Kami tidak menyimpan pesanWhatsApp Business App + Cloud APIMCP untuk Claude dan ChatGPTAktif dalam 2 menit

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 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 7 hari. Batalkan kapan saja.

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