> For the complete documentation index, see [llms.txt](https://docs.watzap.id/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.watzap.id/help/waba-official/cara-kirim-broadcast-waba-official/solusi-broadcast-failed-gagal-terkirim.md).
# Solusi Broadcast Failed / Gagal Terkirim
Cara melihat alasan pesan broadcast WABA Official yang gagal (Failed) atau dilewati (Skipped) di WatZap, arti pesan error dari Meta, dan solusinya.
Pesan broadcast WABA Official bisa gagal karena nomor penerima, karena batas kirim, karena template, atau karena masalah di akun bisnis Kamu. WatZap mencatat alasan gagal yang dikirim Meta untuk setiap pesan, jadi Kamu bisa langsung tahu bagian mana yang perlu diperbaiki.
## Cara melihat alasan gagal
{% stepper %}
{% step %}
### Buka halaman Broadcasts
Di menu samping bagian **WABA OFFICIAL**, klik **Broadcasts**.
1. Kolom **Failed**: jumlah pesan yang gagal di setiap broadcast.
2. **Ikon info (ⓘ)** di sebelah angka: muncul bila ada alasan gagal yang tercatat.
{% endstep %}
{% step %}
### Arahkan kursor ke ikon info
1. Arahkan kursor (atau ketuk di HP) ke **ikon info**.
2. Muncul daftar alasan dengan format `(jumlah x) - alasan`, diurutkan dari yang paling banyak.
Bila alasan diawali `(#angka)`, angka itu adalah **kode error Meta**, misalnya `(#131026)`. Kode ini memudahkan Kamu mencocokkan dengan tabel di bawah.
{% endstep %}
{% step %}
### Buka Report untuk melihat per kontak
1. Klik **ikon titik tiga (⋮)** di baris broadcast.
2. Pilih **Report**.
{% endstep %}
{% step %}
### Saring kontak yang gagal
1. Kotak **Failed**: jumlah kontak yang tidak menerima pesan, termasuk yang dilewati (**Skipped**).
2. Pilih **Failed** di filter status untuk menampilkan kontak yang gagal.
3. Arahkan kursor ke label **Failed** di baris kontak untuk melihat alasannya.
{% hint style="info" %}
Angka di kolom **Failed** halaman **Broadcasts** hanya menghitung pesan berstatus **Failed**. Angka **Failed** di halaman **Report** juga menghitung kontak **Skipped**, jadi angkanya bisa lebih besar.
{% endhint %}
{% endstep %}
{% endstepper %}
## Failed dan Skipped, apa bedanya?
* **Failed**: WatZap sudah meneruskan pesan ke Meta, tapi Meta menolak atau tidak bisa mengantarkannya.
* **Skipped**: WatZap tidak mengirim pesan ke nomor itu karena nomornya ada di **daftar nomor yang dilewati** (*blacklist*). Nomor masuk daftar ini secara otomatis setelah pesan sebelumnya ke nomor tersebut gagal.
Arahkan kursor ke label **Skipped** untuk melihat keterangannya:
1. Label **Skipped** di baris kontak.
2. Keterangan: **permanently blacklisted** (dilewati seterusnya) atau **temporarily blacklisted** (dilewati selama 24 jam).
Di menu **Lists**, nomor yang akan dilewati ditandai:
1. **Ikon merah** di sebelah nomor WhatsApp.
2. Keterangan **This number will be skipped in the broadcast sending.** saat kursor diarahkan ke ikon.
Jenis kegagalan menentukan apakah nomor penerima ikut dilewati di broadcast berikutnya:
| Alasan gagal | Nomor di broadcast berikutnya |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| Masalah di akun atau konten Kamu: *Business eligibility payment issue*, *Re-engagement message*, *Media upload error*, *Account not registered*, *healthy ecosystem engagement* (131049), *maintenance mode* (131057) | Tetap dikirim |
| Batas kirim sementara: *Rate limit hit* (130429), *Spam rate limit hit* (131048), pesan lain yang menyebut *rate limit* | Dilewati 24 jam |
| Alasan lainnya, misalnya *Message undeliverable* (131026) atau penerima berhenti menerima pesan marketing (131050) | Dilewati seterusnya |
{% hint style="warning" %}
Belum ada tombol untuk mengeluarkan nomor dari daftar yang dilewati. Kalau broadcast gagal massal karena masalah akun atau template (misalnya akun terkunci atau template dijeda Meta) lalu banyak nomor ikut berstatus **Skipped** padahal masalahnya sudah beres, hubungi tim support WatZap dan sertakan nama broadcast-nya.
{% endhint %}
## Arti alasan gagal dan solusinya
Masalah di nomor penerima
| Kode | Alasan dari Meta | Artinya & solusi |
| ------ | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 131026 | *Message undeliverable* | Nomor tidak punya akun WhatsApp, memakai WhatsApp versi sangat lama, atau belum menyetujui ketentuan terbaru WhatsApp. Pastikan nomor aktif, atau hubungi lewat kanal lain. |
| 131049 | *This message was not delivered to maintain healthy ecosystem engagement.* | Meta menahan pesan marketing agar penerima tidak menerima terlalu banyak promosi. Tunggu minimal 24 jam sebelum mengirim lagi ke orang yang sama. |
| 131050 | Penerima memilih berhenti menerima pesan marketing dari bisnis Kamu. | Hormati pilihannya. Keluarkan nomor ini dari list promosi. |
| 131056 | Terlalu banyak pesan ke nomor yang sama dalam waktu singkat (*pair rate limit*). | Beri jeda sebelum mengirim lagi ke nomor itu. Pengiriman ke nomor lain tidak terpengaruh. |
Masalah batas kirim dan kualitas nomor Kamu
| Kode | Alasan dari Meta | Artinya & solusi |
| ------ | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 130429 | *Rate limit hit* | Kecepatan kirim nomor Kamu sedang mencapai batas. Tunggu, lalu kirim lagi dengan jumlah lebih kecil. |
| 131048 | *Spam rate limit hit* | Meta membatasi jumlah pesan dari nomor Kamu karena banyak umpan balik negatif. Cek **Business Profile** → **Quality Rating**, hentikan broadcast sementara, dan perbaiki isi template. |
Batas jumlah penerima per 24 jam juga berpengaruh. Lihat [Cara Meningkatkan Batas Kirim Pesan](/help/waba-official/cara-meningkatkan-batas-kirim-pesan.md).
Masalah template dan isi pesan
| Kode | Alasan dari Meta | Artinya & solusi |
| -------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 131053 | *Media upload error* | Gambar/video/dokumen di header template tidak bisa diunduh atau formatnya tidak didukung. Pakai file JPG/PNG, MP4, atau PDF yang bisa diakses, lalu buat broadcast lagi. |
| 132000, 132012 | Jumlah atau format isi variabel tidak sesuai template. | Pastikan setiap variabel terisi dan kolom kontak yang dipilih tidak kosong. Lihat [Cara Menggunakan Fitur Variabel WABA Official](/help/waba-official/cara-menggunakan-fitur-variabel-waba-official.md). |
| 132001 | Template tidak ada dalam bahasa tersebut atau belum disetujui. | Pakai template berstatus **Approved**. |
| 132015, 132016 | Template dijeda (*paused*) atau dinonaktifkan karena kualitasnya rendah. | Perbaiki isi template, atau buat template baru dengan isi berbeda. Lihat [Cara Membuat Template WABA Official](/help/waba-official/cara-membuat-template-waba-official.md). |
| 131047 | *Re-engagement message* | Lebih dari 24 jam sejak penerima terakhir membalas, padahal yang dikirim bukan template. Untuk menghubungi ulang pelanggan, selalu pakai template yang sudah disetujui. |
Masalah akun bisnis (biasanya semua pesan berhenti)
| Kode | Alasan dari Meta | Artinya & solusi |
| -------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 131042 | *Business eligibility payment issue* | Ada masalah metode pembayaran di akun Meta. Lihat [Solusi Broadcast Failed (Business Eligibility Payment Issue)](/help/waba-official/cara-kirim-broadcast-waba-official/solusi-broadcast-failed-business-eligibility-payment-issue.md). |
| 131031, 368 | Akun dikunci atau dibatasi karena melanggar kebijakan. | Cek alasannya di Business Support Home dan ajukan banding. Lihat [Cara Mengatasi Kendala WABA Terkena Restricted](/help/waba-official/cara-connect-nomor-waba-official/cara-mengatasi-kendala-waba-terkena-restricted.md). |
| 131037 | Nomor pengirim belum punya nama tampilan yang disetujui. | Cek **Business Profile** → tab **Display Name**, lalu ajukan ulang nama tampilan bila ditolak. |
| 133010, 131045 | Nomor belum terdaftar (*Account not registered*). | Cek **Business Profile** → tab **Connect Account**. Lihat [Cara Mengatasi Kendala Connect WhatsApp Business API & Coexistence](/help/waba-official/cara-connect-nomor-waba-official/cara-mengatasi-kendala-connect-whatsapp-business-api-and-coexistence.md). |
| 131057 | Akun sedang dalam mode pemeliharaan (*maintenance mode*). | Tunggu sampai pemeliharaan selesai, lalu kirim ulang. |
| 190 | Token akses sudah kedaluwarsa. | Hubungkan ulang nomor. Lihat [Cara Reconnect Nomor WABA](/help/waba-official/cara-connect-nomor-waba-official/cara-reconnect-nomor-waba.md). |
Daftar lengkap kode error resmi: [WhatsApp Cloud API Error Codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes).
## Broadcast berstatus Failed tanpa angka gagal
Kadang seluruh broadcast gagal sebelum ada pesan yang terkirim, sehingga kolom **Failed** tetap `0` tapi statusnya **Failed**. Buka **Report** broadcast tersebut:
1. Status **Failed** di kanan atas.
2. Alasan kegagalan tampil di bawah judul broadcast (bila tercatat).
| Alasan yang tampil | Solusi |
| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `broadcast tidak memiliki kontak` | List yang dipilih kosong atau tidak berisi nomor WhatsApp. Pilih list lain, lalu buat broadcast baru. |
| `kredensial WABA tidak lengkap` | Koneksi nomor WABA bermasalah. Cek **Business Profile**, lalu hubungkan ulang bila perlu. |
| `Template requires HEADER … but header media link is empty` | Header template butuh gambar/video/dokumen, tapi file-nya kosong. Pilih template lain atau perbaiki template. |
| `Template carousel tidak punya kartu yang bisa dikirim.` / `Kartu … tidak punya gambar atau video yang bisa dikirim.` | Lengkapi media di setiap kartu carousel. |
| `header media milik Meta gagal disiapkan: …` | File header template tidak bisa disiapkan. Coba lagi beberapa saat, atau pakai template dengan file baru. |
Untuk mengirim ulang, buat broadcast baru dengan template dan list yang sudah diperbaiki. Lihat [Cara Kirim Broadcast WABA Official](/help/waba-official/cara-kirim-broadcast-waba-official.md).
## Agar broadcast tidak gagal lagi
* Kirim hanya ke kontak yang sudah setuju menerima pesan (*opt-in*).
* Hindari mengirim lebih dari satu pesan marketing ke orang yang sama dalam 24 jam, kecuali dia membalas.
* Pantau **Quality Rating** di **Business Profile**. Kalau turun ke **MEDIUM** atau **LOW**, hentikan broadcast 24–48 jam.
* Pakai variabel nama agar pesan terasa personal, dan sediakan tombol untuk berhenti berlangganan.
Tips lengkapnya: [Tips WABA Anti Spam & Restricted](/help/waba-official/tips-waba-anti-spam-and-restricted.md). Kebijakan resmi: [WhatsApp Business Messaging Policy](https://business.whatsapp.com/policy).