Flow Management API Error Code saat Broadcast

Halaman ini berisi dokumentasi error yang seringkali muncul pada app.wanovasi.com saat broadcast pesan.

Error Broadcast

Kode Error	Deskripsi	Kemungkinan Solusi	HTTP Status Code
131009 Parameter value is not valid	Satu atau lebih nilai parameter tidak valid.	Lihat referensi endpoint untuk menentukan nilai mana yang didukung untuk setiap parameter, dan lihat Nomor Telepon untuk mempelajari cara menambahkan nomor telepon ke Akun WhatsApp Business.	400 Bad Request
131042 Business eligibility payment issue	Terjadi kesalahan terkait metode pembayaran.	Lihat Tentang Penagihan untuk Akun WhatsApp Business dan verifikasi penagihan sudah benar.	400 Bad Request
131026 Message Undeliverable	Tidak dapat menyampaikan pesan. Alasan dapat meliputi: Nomor telepon penerima bukan nomor telepon WhatsApp. Mengirim template autentikasi ke pengguna WhatsApp yang memiliki kode panggilan negara +91 (India). Template autentikasi saat ini tidak dapat dikirim ke pengguna WhatsApp di India. Penerima belum menerima Ketentuan Layanan dan Kebijakan Privasi yang baru. Penerima menggunakan versi WhatsApp lama; harus menggunakan versi WhatsApp berikut atau yang lebih besar: Android: 2.21.15.15 SMBA: 2.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6	Dengan menggunakan metode komunikasi non-WhatsApp, mintalah pengguna WhatsApp untuk: Mengonfirmasi bahwa mereka benar-benar dapat mengirim pesan ke nomor telepon WhatsApp Business. Mengonfirmasi bahwa mereka telah menerima Ketentuan Layanan terbaru (Pengaturan > Bantuan, atau Pengaturan > Informasi Aplikasi akan meminta mereka menerima ketentuan/kebijakan terbaru jika mereka belum melakukannya) Memperbarui ke versi terbaru klien WhatsApp.	400 Bad Request
131049 Meta chose not to deliver.	This Message was not delivered to maintain healthy ecosystem engagement.	Jangan langsung mencoba lagi jika menerima kode kesalahan ini dan menyangka hal itu dikarenakan oleh limit. Sebaliknya, coba lagi dengan peningkatan time increments yang lebih besar sampai pesan delivered, karena limit tersebut mungkin berlaku untuk time increments yang berbeda. Lihat Batas Pesan Template Marketing Per Pengguna untuk mendapatkan informasi tambahan.	400 Bad Request

Penjelasan Lengkap Error Yang Muncul

1. Kode Error: 131009 Parameter value is not valid

Error ini muncul ketika sistem menerima satu atau lebih nilai parameter yang tidak sesuai dengan aturan yang diharapkan. Bayangkan ketika mengisi formulir online: jika ada satu isian yang salah atau tidak sesuai format yang diharapkan, maka sistem akan menolak prosesnya. Demikian pula pada WhatsApp Cloud API, jika nilai yang dikirimkan (seperti nomor telepon atau parameter lainnya) tidak sesuai dengan standar yang ditentukan, maka akan muncul error "Parameter value is not valid" dengan kode 131009.

Untuk mengatasi masalah ini, ada dua hal penting yang perlu diperhatikan:

1. Periksa Referensi Endpoint: Pastikan semua nilai parameter yang digunakan sudah sesuai dengan dokumentasi resmi. Panduan lengkap mengenai parameter yang diperbolehkan pada referensi endpoint dapat dilihat di WhatsApp Cloud API Reference. Di sana, dijelaskan nilai-nilai apa saja yang didukung dan format yang benar untuk setiap parameter.

2. Periksa Nomor Telepon: Kesalahan juga bisa terjadi jika nomor telepon yang digunakan tidak sesuai standar. Untuk itu, pastikan nomor telepon telah ditambahkan dengan benar ke Akun WhatsApp Business. Panduan lengkap mengenai cara menambahkan nomor telepon dapat ditemukan di Dokumentasi Nomor Telepon WhatsApp Cloud API.

Secara sederhana, error 131009 adalah peringatan bahwa ada informasi yang dikirimkan ke sistem yang tidak tepat. Dengan mengikuti panduan dari kedua link di atas, tim teknis maupun non-teknis dapat memastikan bahwa nilai parameter yang digunakan sudah benar sehingga masalah ini bisa dihindari dan diperbaiki. Jika klien mengalami error ini, informasi tersebut dapat disampaikan dengan menjelaskan bahwa perbaikan dilakukan dengan menyesuaikan nilai parameter sesuai standar yang telah ditentukan oleh WhatsApp.

2. Kode Error: 131042 Business eligibility payment issue

Error ini muncul ketika ada masalah yang berkaitan dengan metode pembayaran pada akun WhatsApp Business. Dalam istilah sederhana, error ini mengindikasikan bahwa sistem menemukan kendala pada proses pembayaran, sehingga permintaan tidak dapat diproses. Masalah ini bisa terjadi karena beberapa alasan, seperti:

• Informasi Penagihan Tidak Lengkap atau Tidak Valid: Jika data penagihan, seperti metode pembayaran atau detail tagihan, belum diisi dengan benar atau tidak sesuai dengan persyaratan yang ditetapkan, maka sistem akan menolak permintaan.

• Verifikasi Pembayaran yang Belum Selesai: Akun mungkin belum sepenuhnya memenuhi syarat bisnis terkait pembayaran, misalnya jika proses verifikasi atau validasi data penagihan belum selesai.

Untuk mengatasi masalah ini, pastikan bahwa seluruh informasi penagihan pada akun WhatsApp Business sudah benar dan sesuai dengan standar yang diminta. Lihat panduan lengkap mengenai penagihan dan verifikasi akun pada tautan berikut: Tentang Penagihan untuk Akun WhatsApp Business. Dengan memastikan bahwa data pembayaran sudah valid dan terverifikasi, error ini dapat dihindari dan proses transaksi akan berjalan lancar. HTTP Status Code yang dikembalikan adalah 400 Bad Request, yang menandakan bahwa permintaan tidak bisa diproses karena adanya kesalahan pada data yang dikirimkan.

3. Kode Error: 131026 Message Undeliverable

Error ini terjadi ketika pesan yang dikirim tidak dapat diterima oleh penerima. Dalam bahasa sederhana, artinya sistem gagal menyampaikan pesan kepada orang yang dituju. Berikut beberapa alasan umum kenapa error ini bisa muncul:

• Nomor Telepon Bukan WhatsApp: Penerima mungkin menggunakan nomor telepon yang tidak terdaftar di WhatsApp.

• Penggunaan Template Autentikasi di India: Jika pesan mengirimkan template autentikasi kepada pengguna di India (kode panggilan +91), pesan tersebut tidak akan terkirim karena template ini belum diizinkan untuk pengguna di wilayah tersebut.

• Belum Menerima Ketentuan Layanan Terbaru: Pengguna yang belum menyetujui Ketentuan Layanan dan Kebijakan Privasi terbaru juga bisa mengalami kegagalan pengiriman pesan.

• Versi WhatsApp yang Usang: Penerima mungkin menggunakan versi WhatsApp yang sudah lama dan tidak mendukung fitur atau format pesan terbaru. Versi minimum yang disarankan adalah:

  • Android: 2.21.15.15

  • SMBA: 2.21.15.15

  • iOS: 2.21.170.4

  • SMBI: 2.21.170.4

  • KaiOS: 2.2130.10

  • Web: 2.2132.6

Untuk mengatasi masalah ini, langkah-langkah yang dapat diambil antara lain:

1. Konfirmasi Ketersediaan WhatsApp: Pastikan bahwa nomor telepon yang akan menerima pesan benar-benar terdaftar sebagai nomor WhatsApp Business.

2. Periksa Persetujuan Ketentuan Layanan: Mintalah pengguna untuk memastikan mereka telah menerima dan menyetujui Ketentuan Layanan serta Kebijakan Privasi terbaru. Biasanya, pengguna akan mendapatkan notifikasi melalui menu Pengaturan > Bantuan atau Informasi Aplikasi jika perlu memperbarui persetujuan mereka.

3. Update Versi WhatsApp: Anjurkan pengguna untuk memperbarui aplikasi WhatsApp mereka ke versi terbaru sesuai dengan minimal versi yang direkomendasikan, agar kompatibilitas pesan terjamin.

Dengan memastikan bahwa semua persyaratan di atas terpenuhi, diharapkan pesan dapat dikirim dengan sukses tanpa menemui error ini. Dokumentasi lebih lanjut mengenai cara mengatasi masalah ini dan panduan penggunaan WhatsApp Business dapat membantu memastikan bahwa pesan yang dikirim akan diterima oleh penerima.

4. Kode Error: 131049 Meta chose not to deliver.

Error ini muncul ketika sistem memilih untuk tidak mengirim pesan, meskipun pesan tersebut valid, guna menjaga kualitas dan kesehatan interaksi di ekosistem WhatsApp. Dengan kata lain, sistem memutuskan untuk tidak mengirim pesan karena ingin menghindari penyalahgunaan atau spam yang bisa mengganggu pengalaman pengguna.

Hal-hal yang perlu dipahami adalah:

• Tidak Langsung Coba Ulang: Jika error ini muncul, jangan langsung mencoba mengirim ulang pesan dengan harapan bahwa hal itu hanya karena mencapai batas pengiriman (limit).

• Penyesuaian Interval Waktu: Sebaiknya, tunggu dengan peningkatan interval waktu sebelum mencoba mengirim kembali. Hal ini karena batas pengiriman pesan marketing mungkin berlaku dalam rentang waktu tertentu, dan memberikan jeda waktu yang lebih lama bisa membantu pesan tersebut berhasil terkirim.

• Rujukan Resmi: Untuk informasi lebih lanjut mengenai batasan pengiriman pesan template marketing per pengguna, Anda dapat merujuk ke Batas Pesan Template Marketing Per Pengguna.

Singkatnya, error 131049 mengindikasikan bahwa sistem dengan sengaja menunda pengiriman pesan untuk menjaga ekosistem komunikasi yang sehat. Langkah terbaik yang dapat diambil adalah meningkatkan interval waktu antara pengiriman pesan agar batasan tersebut tidak terlampaui dan pesan dapat terkirim dengan sukses.