---
title: "Kode Error WhatsApp Cloud API: Arti dan Cara Mengatasinya"
description: "Kode error WhatsApp Cloud API yang paling sering muncul, dari 131047 dan 131026 hingga 132001 dan 130429: arti, solusi, dan kapan tidak boleh retry."
canonical: "https://omnichannels.ai/id/blog/whatsapp-api-error-codes-troubleshooting/"
language: "id"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
category: "whatsapp"
primaryQuery: "whatsapp cloud api error codes"
keywords: ["kode error whatsapp cloud api", "whatsapp error 131047", "whatsapp error 131026", "error 131049 whatsapp", "error 132001 whatsapp", "whatsapp api pesan gagal terkirim", "whatsapp rate limit 130429", "whatsapp error 131048"]
published: "2026-10-10"
author: "OmniChannels.ai Editorial Team"
reviewer: "BroadNet Messaging Solutions Team"
readingMinutes: 8
answer: "Error WhatsApp Cloud API terbagi dalam beberapa kelompok: otorisasi (0, 190, 10), integritas (368, 131031), pembatasan (4, 80007, 130429, 131048, 131049, 131056), masalah template (132000 hingga 132016), masalah penerima (131026, 131047, 131050) dan masalah permintaan (131008, 131009). Baca kode dan detail error_data, lalu putuskan: perbaiki lalu retry, tunggu lalu retry, beralih ke template atau kanal lain, atau jangan pernah retry."
takeaways: ["Error 131047 berarti jendela layanan pelanggan 24 jam sudah tertutup; kirim template yang sudah disetujui, bukan pesan bebas.", "Error 131050 berarti pengguna telah menghentikan pesan marketing; Meta menyatakan jangan retry.", "Error 131049 adalah batas marketing per pengguna; Meta menyarankan menunggu minimal 24 jam sebelum mengirim ulang.", "Error 132000 dan 132012 hampir selalu disebabkan jumlah variabel atau format yang tidak sesuai dengan template yang disetujui.", "Sebagian error dikembalikan langsung dalam respons API; sebagian lain datang belakangan lewat webhook status dengan status failed, jadi Anda harus mencatat keduanya."]
faq: 
  - q: "Apa arti error WhatsApp 131047?"
    a: "Error 131047 berarti sudah lebih dari 24 jam sejak penerima terakhir mengirim pesan ke nomor Anda, sehingga jendela layanan pelanggan tertutup. Teks bebas, media, dan pesan interaktif tidak lagi diizinkan. Kirim pesan template yang sudah disetujui, sebaiknya template utilitas (utility) yang mengajak pelanggan membalas. Saat pelanggan membalas, jendela terbuka kembali."
  - q: "Mengapa muncul error 131026 padahal nomornya ada di WhatsApp?"
    a: "Meta menjelaskan 131026 sebagai pesan tidak dapat dikirim. Penyebabnya bisa berupa nomor yang tidak terdaftar di WhatsApp, penerima yang belum menyetujui ketentuan terbaru, atau versi WhatsApp yang sudah usang. Kode negara atau format lokal yang salah juga sering menjadi penyebab. Validasi nomor dalam format internasional, minta pelanggan memperbarui aplikasi, atau gunakan SMS atau email."
  - q: "Apa perbedaan antara 130429 dan 131056?"
    a: "130429 berarti nomor Anda mencapai batas throughput Cloud API, artinya pengiriman Anda secara keseluruhan terlalu cepat; perlambat dan gunakan antrean. 131056 berarti Anda mengirim terlalu banyak pesan ke penerima yang sama dalam waktu singkat; penerima lain tidak terpengaruh. Atasi 130429 dengan kontrol laju pengiriman, dan atasi 131056 dengan memberi jeda antarpesan ke satu pengguna tersebut."
  - q: "Haruskah pesan WhatsApp yang gagal di-retry secara otomatis?"
    a: "Hanya untuk error sementara seperti 131000 (tidak diketahui), 131016 (layanan tidak tersedia), 130429 (throughput), serta 4 atau 80007 (rate limit), dengan exponential backoff. Jangan pernah retry otomatis 131050 (opt-out marketing), 131026 tanpa mengubah apa pun, error template, atau pembatasan kebijakan 368. Retry tanpa analisis memboroskan biaya, mengganggu pengguna, dan dapat menurunkan kualitas."
  - q: "Di mana saya bisa melihat detail error selengkapnya?"
    a: "Error sinkron dikembalikan dalam respons API berupa code, message, dan error_data. Kegagalan asinkron datang melalui webhook messages dengan status failed, disertai array errors yang memuat code, title, dan details. Catat seluruh objeknya, bukan hanya kodenya, karena field details sering menyebutkan parameter atau masalah media yang tepat."
sources: 
  - title: "Error codes — WhatsApp Cloud API, Meta for Developers"
    url: "https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes"
  - title: "Status messages webhook reference — Meta for Developers"
    url: "https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/reference/messages/status"
  - title: "About the platform: rate limits and encryption — Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform"
---

# Kode Error WhatsApp Cloud API: Arti dan Cara Mengatasinya

Canonical: https://omnichannels.ai/id/blog/whatsapp-api-error-codes-troubleshooting/
Language: id
Publisher: OmniChannels.ai by BroadNet Technologies

Panduan ini ditujukan bagi developer dan tim operasional pesan yang menemukan pesan WhatsApp gagal terkirim dan perlu segera tahu apakah harus memperbaiki permintaan, menunggu, mengganti jenis pesan, atau berhenti. Setiap kode di bawah ini telah diperiksa terhadap referensi kode error Cloud API dari Meta. Kode dan redaksinya dapat berubah, jadi pastikan Anda memeriksa halaman tersebut sebelum menulis logika yang bersifat permanen di kode.

## Di mana error WhatsApp Cloud API muncul?

Error muncul di dua tempat, dan Anda perlu menangkap keduanya. Error permintaan dikembalikan langsung dalam respons API; error pengiriman datang belakangan melalui webhook status.

- **Error sinkron.** Permintaan kirim ditolak dan responsnya berisi objek `error` dengan `code`, `message`, `type`, dan sering kali `error_data.details`. Contoh umumnya adalah token kedaluwarsa, parameter yang hilang, dan template yang tidak cocok.
- **Error asinkron.** Permintaan kirim berhasil dan mengembalikan ID pesan, tetapi webhook berikutnya melaporkan `status: failed` dengan array `errors`. Contoh umumnya adalah jendela layanan yang tertutup, penerima yang tidak dapat dijangkau, dan batas marketing.

Kesalahan yang sering terjadi adalah hanya mencatat respons HTTP. Tim lalu mengira kampanye berhasil karena setiap permintaan mengembalikan ID pesan, padahal ratusan pesan gagal di webhook. Untuk memahami hubungan antarstatus, baca [penjelasan status sent, delivered, read, dan failed](/id/blog/message-delivery-status-explained/).

## Apa saja kode error WhatsApp yang paling umum?

Tabel berikut memuat kode yang paling sering ditemui tim, dikelompokkan menurut langkah yang sebaiknya Anda ambil. Deskripsi merupakan parafrase dari referensi Meta.

| Kode | Arti | Solusi | Retry? |
|---|---|---|---|
| 0 | Tidak dapat mengautentikasi pengguna aplikasi; token kedaluwarsa atau dicabut | Buat access token baru | Setelah diperbaiki |
| 190 | Access token telah kedaluwarsa | Gunakan token system user yang tidak kedaluwarsa; lakukan refresh | Setelah diperbaiki |
| 3, 10, 200–299 | Izin atau kapabilitas tidak tersedia | Periksa izin token di access token debugger | Setelah diperbaiki |
| 368 | WABA dibatasi atau dinonaktifkan karena pelanggaran kebijakan | Tinjau penegakan kebijakan di WhatsApp Manager; ajukan banding jika keliru | Tidak |
| 131031 | Akun terkunci, misalnya karena kegagalan verifikasi kebijakan atau data | Periksa status kesehatan akun; selesaikan bersama Meta | Tidak |
| 4 | Aplikasi mencapai batas rate panggilan API | Kurangi volume permintaan; periksa App Dashboard | Ya, nanti |
| 80007 | WABA mencapai batas rate | Kurangi volume permintaan; retry nanti | Ya, nanti |
| 130429 | Throughput Cloud API untuk nomor telah tercapai | Gunakan antrean dan perlambat pengiriman | Ya, dengan backoff |
| 131048 | Batas rate spam: pembatasan pesan dari nomor ini | Periksa kualitas di WhatsApp Manager; perbaiki konten dan penargetan | Jangan langsung |
| 131049 | Tidak terkirim "untuk menjaga engagement ekosistem yang sehat" | Tunggu minimal 24 jam sebelum mengirim ulang | Tidak dalam 24 jam |
| 131056 | Terlalu banyak pesan ke penerima yang sama dalam waktu singkat | Beri jeda antarpesan ke pengguna tersebut | Ya, nanti |
| 131000 | Error tidak diketahui | Retry; buka tiket dukungan jika berlanjut | Ya, terbatas |
| 131016 | Layanan sementara tidak tersedia | Periksa halaman status Meta; retry | Ya, dengan backoff |
| 131008 | Parameter wajib tidak ada | Bandingkan payload dengan referensi endpoint | Setelah diperbaiki |
| 131009 | Nilai parameter tidak valid | Periksa nilainya, misalnya format nomor telepon atau ID | Setelah diperbaiki |
| 131021 | Pengirim dan penerima adalah nomor yang sama | Kirim ke nomor lain | Tidak |
| 131026 | Pesan tidak dapat dikirim | Verifikasi nomor, minta pengguna memperbarui WhatsApp, atau gunakan kanal lain | Tidak, jika tidak diubah |
| 131042 | Masalah metode pembayaran | Perbaiki penagihan: akun pembayaran, credit line, mata uang | Setelah diperbaiki |
| 131045 / 133010 | Nomor belum terdaftar di platform | Daftarkan nomor telepon bisnis | Setelah diperbaiki |
| 131047 | Sudah lebih dari 24 jam sejak pengguna terakhir membalas | Kirim template yang sudah disetujui | Sebagai template |
| 131050 | Pengguna menghentikan pesan marketing | Jangan retry; hormati preferensinya | Jangan pernah |
| 131051 | Jenis pesan tidak didukung | Gunakan jenis yang didukung | Setelah diperbaiki |
| 131052 | Tidak dapat mengunduh media yang dikirim pengguna | Minta pengguna mengirim ulang | n/a |
| 131053 | Tidak dapat mengunggah media dalam pesan Anda | Periksa tipe MIME, ukuran, dan URL | Setelah diperbaiki |
| 131057 | Akun dalam mode pemeliharaan | Tunggu; dapat terjadi saat peningkatan throughput | Ya, nanti |
| 132000 | Jumlah variabel tidak sesuai dengan template | Kirim parameter dengan jumlah persis seperti yang didefinisikan | Setelah diperbaiki |
| 132001 | Template tidak ada dalam bahasa tersebut atau belum disetujui | Periksa nama, kode bahasa, dan statusnya | Setelah diperbaiki |
| 132005 | Teks terjemahan terlalu panjang | Persingkat terjemahan template | Setelah diperbaiki |
| 132007 | Isi template melanggar kebijakan | Ubah sesuai aturan peninjauan template | Setelah diperbaiki |
| 132012 | Format nilai variabel salah | Sesuaikan dengan format yang diharapkan | Setelah diperbaiki |
| 132015 | Template dijeda karena kualitas rendah | Edit konten untuk meningkatkan kualitas | Setelah diedit |
| 132016 | Template dinonaktifkan permanen setelah berulang kali dijeda | Buat template baru dengan konten berbeda | Tidak |
| 135000 | Error tidak diketahui pada parameter permintaan | Periksa sintaks permintaan; hubungi dukungan | Setelah diperbaiki |

## Bagaimana cara mengatasi error yang paling sering menggagalkan kampanye?

Dalam praktiknya, segelintir kode menyebabkan sebagian besar kegagalan. Masing-masing punya aturan keputusan yang jelas.

### 131047: jendela layanan sudah tertutup

Pelanggan terakhir mengirim pesan lebih dari 24 jam lalu. Teks bebas, media, dan pesan interaktif hanya diizinkan di dalam jendela layanan pelanggan 24 jam; di luar jendela itu Anda harus memakai template yang sudah disetujui. Lihat [jendela layanan pelanggan 24 jam](/id/blog/whatsapp-24-hour-customer-service-window/). Agen sering terkena error ini saat membalas percakapan lama. Tampilkan status jendela kepada agen dan sediakan pemilih template saat jendela sudah berakhir.

### 131026: pesan tidak dapat dikirim

Mulailah dari kebersihan data nomor: format internasional, kode negara yang benar, dan tanpa angka nol di depan setelah kode negara. Setelah itu, terimalah bahwa sebagian nomor memang tidak ada di WhatsApp atau memakai aplikasi versi lama. Untuk pesan yang sensitif waktu seperti OTP (kode verifikasi), gunakan fallback (kanal cadangan) ke SMS. Lihat [WhatsApp vs SMS vs RCS](/id/blog/whatsapp-vs-sms-vs-rcs/).

### 131049 dan 131050: batas marketing dan opt-out

Keduanya memengaruhi pesan marketing (pemasaran). 131050 adalah pilihan eksplisit pengguna untuk berhenti menerima pesan marketing; masukkan mereka ke daftar supresi untuk pesan marketing dan berlangganan webhook preferensi pengguna dari Meta. 131049 berarti Meta memilih tidak mengirimkan pesan demi menjaga engagement pengguna; Meta menyarankan menunggu minimal 24 jam, dan retry yang lebih cepat kemungkinan besar akan gagal lagi. Kurangi frekuensi dan tingkatkan relevansi, jangan mengirim ulang.

### 130429, 131048, dan 131056: mengirim terlalu cepat atau terlalu banyak

130429 adalah masalah throughput: antrekan pesan dan terapkan backoff. 131056 terjadi pada level pasangan pengirim-penerima: Anda terlalu sering mengirim pesan ke satu orang. 131048 adalah sinyal kualitas pada nomor pengirim dan memerlukan perbaikan konten dan penargetan, bukan retry. Lihat [batas pengiriman pesan dan rating kualitas](/id/blog/whatsapp-messaging-limits-quality-rating/).

### 132000, 132001, dan 132012: template tidak cocok

Ini hampir selalu merupakan bug integrasi. Nama template, kode bahasa (misalnya `ar` versus `en_US`), dan jumlah variabel harus sama persis dengan yang disetujui. Buat pengujian yang mengirim setiap template dengan nilai contoh setiap kali Anda mengeditnya.

## Kebijakan retry yang bisa Anda terapkan

Gunakan daftar periksa ini untuk mengklasifikasikan setiap kegagalan secara otomatis.

1. **Catat** kode, title, `error_data.details`, ID pesan, penerima, dan nama template.
2. **Jangan pernah retry** 131050, 131021, 132016, 368, dan 131031. Segera laporkan 368 dan 131031 ke administrator.
3. **Perbaiki, lalu retry** error otorisasi (0, 190, 10), parameter (131008, 131009, 135000), template (132000 hingga 132015), dan penagihan (131042). Beri peringatan kepada tim yang bertanggung jawab.
4. **Backoff lalu retry** 130429, 4, 80007, 131016, dan 131057 dengan exponential backoff yang dibatasi batas maksimum.
5. **Ganti kanal atau jenis pesan** untuk 131047 (template) dan 131026 (SMS atau email).
6. **Tunggu 24 jam atau lebih** untuk 131049 dan tinjau frekuensi kampanye.
7. **Laporkan** kegagalan per kode dalam laporan kampanye, bukan sebagai satu angka total "failed".

## Contoh kasus: promosi yang gagal di sebuah retailer Riyadh

Ini contoh sintetis. "Najd Home" mengirim template marketing kepada 20.000 pelanggan yang sudah memberikan persetujuan (opt-in). API menerima setiap permintaan, tetapi webhook status menunjukkan sekitar 1.400 kegagalan.

Setelah dikelompokkan menurut kode, gambarannya jelas. Kelompok terbesar adalah 131049, sehingga tim mengeluarkan pengguna tersebut dari dua pengiriman berikutnya dan menurunkan frekuensi mingguan. Kelompok yang lebih kecil adalah 131026; hasil analisis menunjukkan banyak nomor tersimpan dengan angka nol lokal di depan, yang diselesaikan dengan perbaikan normalisasi. Beberapa pengguna 131050 dimasukkan ke daftar supresi marketing secara permanen. Beberapa error 130429 berasal dari lonjakan di awal pengiriman, sehingga pengiriman kini diatur lajunya melalui antrean.

## Kesalahan umum dan batasan yang perlu diakui

- **Menganggap setiap kegagalan layak di-retry.** Ini memboroskan biaya dan dapat menurunkan kualitas.
- **Menulis teks Meta secara permanen di kode.** Meta memperbarui title dan deskripsi; buat logika berdasarkan kode numerik dan simpan tabel rujukan yang bisa Anda perbarui.
- **Mengabaikan `error_data.details`.** Field ini sering menyebutkan parameter yang bermasalah dengan tepat.
- **Tidak semua kegagalan ada solusinya.** Sebagian penerima memang tidak dapat dijangkau di WhatsApp, dan Meta tidak menjelaskan setiap keputusan 131049. Siapkan kanal alternatif.

## Bagaimana OmniChannels.ai membantu

OmniChannels.ai, didukung BroadNet Technologies, menyediakan laporan pengiriman (DLR) dalam tampilan ringkasan dan lanjutan, lengkap dengan filter dan ekspor CSV, sehingga pesan gagal dapat dianalisis per kampanye. Fallback (kanal cadangan) dapat mengirim ulang lewat RCS atau SMS saat WhatsApp gagal, dan template ditampilkan dalam pratinjau di mock-up ponsel serta dilacak sepanjang proses persetujuan, sehingga mengurangi error ketidakcocokan. [Webhook](/developers/webhooks/) melaporkan status FAILED dan REJECTED dalam satu format yang sudah dinormalisasi, dan [dokumentasi developer](/developers/) publik kami menyertakan referensi [error dan batas](/developers/errors-and-limits/).