WhatsApp BusinessPublished 6 September 2026

10 Kesalahan Pakai WhatsApp API yang Bikin Nomor Dibatasi

Nomor WhatsApp bisnis jarang bermasalah karena Anda melanggar aturan besar. Yang menurunkan kualitasnya justru kebiasaan harian yang sudah berjalan berbulan-bulan, dinilai Meta dari tujuh hari terakhir, dan tercatat di tiga layar yang jarang dibuka.

10 Kesalahan Pakai WhatsApp API yang Bikin Nomor Dibatasi
Ali Mkumbwa (Unsplash)
  • Nomor WhatsApp bisnis jarang jatuh karena satu pelanggaran besar, melainkan karena kebiasaan berbulan-bulan yang dinilai Meta dalam jendela tujuh hari terakhir.
  • Tiap hukuman punya ambang angkanya sendiri: template dijeda 3 jam, lalu 6 jam, lalu dimatikan permanen, dan status Flagged yang tidak membaik dalam tujuh hari menurunkan jatah kirim satu tingkat.
  • Seluruh buktinya sudah ada di akun Anda, tersebar di tiga layar yang jarang dibuka: kualitas tiap nomor, status tiap template, dan riwayat perubahan kategori template.
  • Obrola menyatukan WhatsApp, Instagram, dan Facebook dalam satu inbox tim, lengkap dengan tahap penjualan di tiap percakapan.

Broadcast terakhir tercatat terkirim, dan yang membalas jauh lebih sedikit dari biasanya. Tidak ada pesan gagal di dasbor penyedia, tidak ada peringatan, tidak ada satu pun tanda bahwa jangkauan Anda sudah berubah.

Masalahnya, WhatsApp Business Platform hampir tidak pernah menghukum dengan cara yang terlihat pada hari kejadiannya. Kualitas nomor dihitung dari tujuh hari terakhir, dan tiap template dinilai terpisah dari nomor yang mengirimnya.

Akibatnya, akun yang berjalan mulus selama sembilan bulan bisa kehilangan separuh jatah kirimnya tanpa pernah ditegur satu kali pun. Sepuluh kesalahan berikut punya ambang angkanya masing-masing, dan semuanya sudah tercatat di akun Anda sendiri.

Seorang perempuan memeriksa ponsel di depan rak gaun di sebuah toko pakaian
Ilustrasi Unsplash

Tiga Layar yang Menentukan Nasib Nomor WhatsApp Anda

Sebelum membahas kesalahannya, ada gunanya tahu di mana bukti tiap kesalahan itu disimpan. Ketiganya ada di WhatsApp Manager, dan ketiganya bisa dibuka sendiri tanpa menunggu penyedia.

1. Kualitas dan status tiap nomor

Meta memberi tiap nomor bisnis sebuah quality rating berwarna: hijau untuk kualitas tinggi, kuning untuk sedang, merah untuk rendah.

Mekanismenya dijelaskan paling terbuka di dokumentasi AWS End User Messaging Social tentang phone number quality rating: skor dihitung dari bagaimana pesan Anda diterima pelanggan selama tujuh hari terakhir, dengan bobot lebih besar pada pesan yang paling baru.

Sinyal yang dipakai bukan tebakan. Yang dihitung adalah blokir, laporan, dan alasan yang dipilih pelanggan ketika memblokir sebuah bisnis.

Di samping warna itu ada status nomor, dan tiga status ini sering disamakan padahal artinya berbeda jauh:

  • Connected — nomor berjalan normal dan Anda bisa mengirim sebatas kuota.
  • Flagged — kualitas nomor rendah. Kalau tidak membaik dalam tujuh hari, status kembali Connected tetapi batas percakapan yang Anda mulai turun satu tingkat.
  • Restricted — jatah percakapan Anda untuk periode 24 jam berjalan sudah habis. Pesan masuk tetap bisa dijawab, dan setelah periode itu lewat Anda bisa mengirim lagi.

Satu status soal kualitas, satu status soal kuota. Menyamakan keduanya dengan "nomor kena blokir" adalah awal dari kesalahan nomor tujuh di bawah.

2. Kualitas dan status tiap template

Template punya rapor sendiri, terpisah dari nomornya. Sebuah template bisa berstatus Active, In Review, Paused, atau Disabled, dan kualitasnya bisa jatuh ke Active – Low quality meski nomor Anda masih hijau.

Di sinilah kebanyakan pemilik toko kehilangan jejak. Halaman depan terlihat sehat, sementara satu template promo yang dipakai tiap Jumat sedang dijeda diam-diam.

3. Riwayat perubahan kategori template

Layar ketiga adalah Template Category Updates di WhatsApp Manager, ditambah email yang dikirim Meta ke admin akun WhatsApp Business Anda.

Meta bisa memindahkan template dari utility ke marketing, dan perpindahan itu langsung mengubah biayanya. Menurut dokumentasi kategorisasi template Meta, Anda punya 60 hari untuk meninjau dan mengajukan banding lewat Business Support Home.

Diagram empat bagian rapor nomor WhatsApp: skor kualitas dari sinyal tujuh hari terakhir, lalu status Connected, Flagged, dan Restricted dengan artinya masing-masing
Satu skor warna, tiga status nomor

10 Kesalahan Pakai WhatsApp API dan Cara Memperbaikinya

Urutannya bukan dari yang paling berat, melainkan dari yang paling sering sudah berjalan berbulan-bulan sebelum ada yang menyadarinya.

1. Menganggap punya nomor pelanggan sama dengan punya izin

Daftar kontak toko tumbuh dari pesanan, lalu semuanya masuk ke satu daftar broadcast. Terasa wajar, karena nomornya memang diberikan sendiri oleh pelanggan.

Kebijakan Pesan WhatsApp Business menyebut dua syarat yang terpisah: pelanggan memberikan nomor ponselnya, dan Anda menerima izin yang menyatakan dia ingin menerima pesan lanjutan dari Anda.

Biayanya tidak berhenti di Meta. UU No. 27 Tahun 2022 tentang Pelindungan Data Pribadi menuntut persetujuan yang eksplisit dan terekam (Pasal 20 dan 22), memberi pelanggan hak menarik persetujuan (Pasal 9), dan mewajibkan Anda berhenti memproses datanya dalam 3x24 jam setelah permintaan itu masuk (Pasal 40). Sanksi administratifnya sampai 2% pendapatan tahunan (Pasal 57).

Perbaikannya kecil dan sekali kerja: satu kalimat izin di titik pelanggan menyerahkan nomornya, tersimpan bersama tanggalnya. Form di dalam chat adalah tempat paling murah untuk merekamnya, karena pelanggan tidak perlu keluar dari percakapan.

2. Broadcast marketing ke daftar lama yang sudah dingin

Daftar dua tahun lalu dipakai lagi untuk promo bulan ini, dengan alasan nomornya toh masih ada. Yang berubah bukan nomornya, melainkan ingatan orang di ujung sana.

Pelanggan yang lupa pernah membeli dari Anda tidak mencari tombol berhenti berlangganan. Dia memblokir, lalu memilih alasan, dan alasan itu masuk langsung ke skor tujuh hari nomor Anda.

Ada jalur hukuman kedua yang sama sekali tidak lewat Meta. Kementerian Komunikasi dan Digital menerima laporan lebih dari 30.000 nomor sepanjang Januari–Juli 2026 lewat aduannomor.id, seperti disampaikan Menteri Meutya Hafid pada 23 Juli 2026. Pemblokirannya dikerjakan bersama operator seluler, dan pada 18 Mei 2026 Komdigi menyebut angka 13.000 nomor yang sudah diblokir.

Perbaikannya: potong daftar berdasarkan transaksi terakhir, bukan berdasarkan jumlah. Kirim ke yang belanja enam bulan terakhir dulu, lihat hasilnya, baru melebar.

Dua orang bekerja berdampingan di satu meja kerja yang penuh
Ilustrasi Unsplash

3. Menulis promosi lalu mengajukannya sebagai utility

Godaannya jelas: utility lebih murah, jadi kalimat promo diberi bungkus notifikasi. "Pesanan Anda sudah dikirim, jangan lewatkan diskon 20% minggu ini."

Dokumentasi kategorisasi Meta menetapkan dua syarat yang harus dipenuhi sekaligus. Template utility harus non-promosional, tanpa maksud membujuk sama sekali, dan harus spesifik atas permintaan pengguna atau benar-benar penting baginya.

Satu klausa diskon membatalkan syarat pertama. Meta lalu memindahkan template itu ke marketing, dan biasanya Anda diberi pemberitahuan satu hari sebelumnya.

Biasanya, bukan selalu. Sejak 16 April 2025, akun yang sudah pernah ditegur soal penyalahgunaan kategori tidak lagi mendapat pemberitahuan 24 jam. Perpindahan kategorinya berlaku seketika.

Dan template marketing selalu ditagih, di dalam maupun di luar jendela 24 jam. Yang tadinya gratis berubah jadi biaya per pesan tanpa Anda mengubah apa pun, seperti yang dibahas lebih rinci di tulisan kami soal perubahan biaya chat WhatsApp.

Perbaikannya: pisahkan tegas. Satu template notifikasi tanpa satu pun kata jualan, satu template promo yang memang diajukan sebagai marketing.

4. Mengira broadcast terkirim padahal ditahan

Dasbor penyedia menulis "terkirim", laporan bacanya rendah, dan tidak ada satu pun baris error. Ini gejala paling membingungkan dari semuanya.

Penyebabnya sebuah mekanisme bernama template pacing. Menurut dokumentasi template pacing Meta, sistem menahan sebagian pesan dari template baru untuk mengumpulkan umpan balik awal, dan mekanisme ini berlaku untuk template marketing maupun utility.

Pesan yang ditahan berstatus held_for_quality_assessment. Dari situ ada dua akhir yang mungkin:

  • Umpan baliknya positif dan kualitas template naik, sehingga pesan yang ditahan dilepas dan terkirim normal.
  • Umpan baliknya negatif dan kualitas template jatuh, sehingga tiap pesan yang ditahan dibuang, dengan webhook berstatus failed dan kode 132015.

Perbaikannya: berhenti membaca angka "terkirim" sebagai angka "sampai". Minta penyedia menunjukkan jumlah delivered dan daftar kode gagal untuk tiap kampanye, lalu cocokkan dengan jumlah penerima. Selisihnya adalah kampanye yang sebenarnya tidak pernah terjadi.

5. Memakai lagi template yang pernah dijeda tanpa mengubah isinya

Template promo yang bulan lalu bermasalah dipakai lagi bulan ini karena statusnya sudah kembali normal. Isinya sama persis.

Dokumentasi template pausing Meta menyebut jeda dimulai ketika sebuah template mencapai kualitas terendah, yaitu status Active – Low quality. Eskalasinya bertingkat dan angkanya tetap:

  • Jeda pertama: 3 jam.
  • Jeda kedua: 6 jam.
  • Jeda ketiga: template dinonaktifkan.

Dua hal yang sering terlewat. Pertama, template yang dijeda selama pacing harus dilepas manual lewat WhatsApp Manager atau API sebelum bisa dipakai lagi. Kedua, sekali sebuah template utility pernah dijeda, template utility baru dan template yang baru dilepas berpotensi kena pacing selama tujuh hari berikutnya.

Perbaikannya: perlakukan jeda pertama sebagai vonis atas isi pesannya, bukan gangguan teknis. Tulis ulang kalimat pembukanya, kurangi frekuensinya, baru ajukan lagi.

Diagram alur jeda template: dari status Active – Low quality ke jeda 3 jam, lalu jeda 6 jam, lalu template dinonaktifkan dan tidak bisa dipakai lagi
Jeda template: 3 jam, 6 jam, mati

6. Mengejar tier lewat volume, bukan lewat verifikasi bisnis

Cara yang paling sering dicoba adalah menaikkan jumlah kiriman, dengan harapan sistem melihat Anda serius. Ini jalan paling lambat sekaligus paling berisiko.

Dokumentasi messaging limits Meta menyusun jatahnya bertingkat: 250, 2.000, 10.000, 100.000, lalu tanpa batas. Yang dihitung adalah jumlah nomor unik yang Anda kirimi pesan di luar jendela layanan pelanggan, dalam periode 24 jam bergerak.

Untuk naik dari 250 ke 2.000 ada tiga jalan, dan dua di antaranya tidak menuntut satu pesan tambahan pun:

  • Verifikasi bisnis Anda sendiri.
  • Minta partner memverifikasi bisnis Anda.
  • Kirim 2.000 pesan terkirim ke nomor unik di luar jendela layanan dalam periode 30 hari bergerak, memakai template berkualitas tinggi.

Di atas 2.000, kenaikan berjalan otomatis dengan dua syarat sekaligus: kualitas pesan tinggi di seluruh nomor dan template Anda, dan dalam tujuh hari terakhir Anda memakai paling tidak separuh dari jatah yang berlaku. Kalau keduanya terpenuhi, jatah naik satu tingkat dalam waktu 6 jam.

Perbaikannya: selesaikan verifikasi bisnis lebih dulu. Menaikkan volume dengan daftar yang belum rapi justru menabrak kesalahan nomor dua.

Diagram lima tingkat jatah kirim WhatsApp: 250 nomor unik per 24 jam, 2.000, 10.000, 100.000, lalu tanpa batas, dengan syarat naik tiap tingkatnya
Lima tingkat jatah kirim WhatsApp

7. Membeli nomor baru begitu nomor lama berstatus Restricted

Reaksi pertama yang paling umum, dan hampir selalu keliru. Restricted terbaca seperti hukuman, padahal artinya jatah 24 jam Anda sudah terpakai habis.

Dokumentasi AWS menyebutnya jelas: pada status itu Anda tetap bisa menjawab pesan yang masuk, dan begitu periode 24 jam lewat, pengiriman terbuka lagi. Tidak ada yang perlu dibeli.

Nomor baru justru memulai semuanya dari nol. Jatahnya kembali ke 250 nomor unik per 24 jam, tanpa riwayat kualitas yang bisa dipakai untuk naik, dan pelanggan lama tidak mengenali nomornya.

Status yang benar-benar memakan jatah adalah Flagged. Kalau kualitas tidak membaik dalam tujuh hari, nomor kembali ke Connected tetapi batas percakapan yang Anda mulai turun satu tingkat.

Perbaikannya: pastikan status nomor dulu sebelum bertindak. Restricted diselesaikan dengan menjadwalkan kiriman jadi beberapa gelombang, cara yang sama dengan menangani lonjakan chat promo.

8. Menghitung jendela 24 jam dari balasan tim, bukan dari pesan pelanggan

Banyak toko menghitung sisa waktunya sejak admin membalas. Jamnya berjalan dari pesan terakhir pelanggan, dan tiap balasan pelanggan menyetel ulang hitungannya jadi 24 jam penuh.

Selisih ini yang membuat tagihan naik tanpa penjelasan. Menurut dokumentasi harga WhatsApp Business Platform, semua pesan non-template gratis dan template utility gratis selama jendela layanan pelanggan masih terbuka, sementara template marketing selalu ditagih.

Ada satu jendela lagi yang sering tidak dihitung. Percakapan yang datang dari iklan Click-to-WhatsApp membuka Free Entry Point selama 72 jam, terhitung sejak Anda membalas.

Perbaikannya: tandai jam pesan terakhir pelanggan, bukan jam balasan tim. Hitungannya sudah kami jabarkan langkah demi langkah di panduan menghitung biaya service message, berikut apa yang berubah mulai 1 Oktober.

Seorang pelanggan membayar di meja kasir sebuah kedai kopi kecil
Ilustrasi Unsplash

9. Memakai template utility sebagai pengganti percakapan

Gejalanya terlihat pada pelanggan yang menerima empat notifikasi untuk satu pesanan: diterima, diproses, dikemas, dikirim. Semuanya utility, semuanya sah, semuanya gratis di dalam jendela.

Yang tidak gratis adalah kesabaran orangnya. Blokir dan laporan yang muncul dari kiriman semacam ini masuk ke skor nomor Anda, dan template yang jatuh ke kualitas rendah masuk ke tangga jeda 3 jam tadi.

Perbaikannya: satu notifikasi untuk tiap perubahan yang benar-benar berarti bagi pelanggan, lalu sisanya dijawab saat dia bertanya. Ini alasan yang sama kenapa autoresponder yang baik justru tahu kapan berhenti menjawab.

10. Tidak ada satu orang pun yang memegang WhatsApp Manager

Kesalahan kesepuluh adalah yang membuat sembilan sebelumnya bisa berjalan berbulan-bulan. Akun dibuat saat pertama berlangganan, emailnya email pemilik, dan sejak itu tidak pernah dibuka lagi.

Semua peringatan Meta dikirim ke sana. Pemberitahuan satu hari sebelum kategori template berubah, tegurannya, dan jendela banding 60 hari yang berjalan tanpa menunggu siapa pun membaca.

Perbaikannya: tunjuk satu nama, bukan sebuah tim. Satu orang yang membuka WhatsApp Manager tiap Senin dan meneruskan isinya ke inbox tim, bukan menyimpannya di kotak masuk pribadi.

Mengapa Kesalahan Ini Baru Terlihat Setelah Berbulan-bulan

Penilaiannya kumulatif di dalam jendela yang bergerak

Skor kualitas tidak menghukum satu kiriman. Skor itu membaca tujuh hari terakhir dengan bobot lebih besar pada yang paling baru, jadi satu broadcast buruk hanya menggeser sedikit.

Yang menjatuhkan adalah pola. Broadcast yang sama tiap Jumat selama tiga bulan membuat tiap minggu memperberat minggu sebelumnya.

Peringatannya masuk ke email admin, bukan ke inbox tim

Orang yang melihat pelanggan berhenti membalas dan orang yang menerima email Meta biasanya bukan orang yang sama. Keduanya memegang separuh cerita.

Pesan yang ditahan tidak terbaca sebagai kegagalan

Status held_for_quality_assessment bukan error, jadi dasbor penyedia sering menampilkannya sebagai bagian dari pengiriman yang berhasil. Pesan yang akhirnya dibuang dengan kode 132015 baru muncul di webhook, bukan di laporan kampanye.

Kualitasnya dinilai dua lapis

Nomor punya rapor, template punya rapor. Nomor bisa tetap hijau sementara satu template sedang menuju jeda ketiganya, dan sebaliknya nomor bisa Flagged meski tiap templatenya terlihat baik-baik saja.

Struktur biayanya berubah dua kali dalam waktu singkat

Sejak 1 Juli 2025 Meta menagih per pesan template terkirim, dan aturan penagihan balasan berubah lagi pada 1 Oktober 2026. Hitungan yang Anda buat tahun lalu sudah tidak berlaku, dan tagihan yang naik sering dibaca sebagai kenaikan volume, padahal kategorinya yang berpindah.

Seseorang mengetik di laptop yang terbuka di atas meja kayu
Ilustrasi Unsplash

Pemeriksaan 30 Menit di Akun Anda Minggu Ini

Enam langkah, semuanya di WhatsApp Manager, semuanya menghasilkan angka yang bisa dicatat. Kerjakan sekali, lalu ulangi tiap bulan.

1. Lima menit: buka kualitas dan status tiap nomor

Catat warnanya dan statusnya. Kalau ada yang Flagged, hitungan tujuh harinya sedang berjalan sekarang, bukan nanti.

2. Delapan menit: urutkan template berdasarkan status

Cari yang berstatus Paused dan yang berkualitas Active – Low quality. Tiap template di daftar itu sudah pernah dijeda paling tidak sekali, dan jeda berikutnya lebih panjang.

3. Lima menit: buka Template Category Updates

Lihat apakah ada template yang dipindahkan ke marketing. Kalau perpindahannya masih dalam 60 hari, banding masih terbuka lewat Business Support Home.

4. Lima menit: cocokkan jumlah broadcast terakhir

Ambil tiga kampanye terakhir. Bandingkan jumlah penerima dengan jumlah yang benar-benar delivered, lalu minta penyedia menunjukkan kode gagalnya bila selisihnya besar.

5. Lima menit: hitung berapa persen kontak yang pernah memberi izin

Ambil seratus kontak terbaru dan hitung berapa yang punya catatan izin dengan tanggal. Angka di bawah separuh berarti daftar broadcast Anda lebih besar daripada daftar yang boleh Anda kirimi.

6. Dua menit: tunjuk satu penerima email akun

Pastikan ada satu nama yang bertanggung jawab membuka email WhatsApp Business tiap minggu. Ini langkah paling murah di daftar ini dan yang paling sering dilewati.

Tangan menuliskan daftar periksa di sebuah buku catatan
Ilustrasi Unsplash

Rapikan Akun WhatsApp Business Anda dengan Obrola!

Yang dibutuhkan toko seukuran ini bukan dasbor tambahan, melainkan satu tempat di mana percakapan dan konsekuensinya terlihat bersamaan. Selama chat tersebar di beberapa ponsel, blokir dan laporan yang menurunkan kualitas nomor hanya akan terbaca sebagai pelanggan yang berhenti membalas.

Obrola menyatukan chat WhatsApp, Instagram, dan Facebook dalam satu inbox tim, jadi tidak ada kanal yang dijaga satu orang sendirian. Tiap percakapan membawa tahap penjualannya sendiri, sehingga Anda bisa memisahkan pelanggan yang memang menunggu notifikasi dari pelanggan yang sudah selesai dan tidak perlu dikirimi apa pun. Serah terima antar-admin terjadi di dalam percakapan, bukan di grup internal, seperti yang dibahas di tulisan kami soal kesalahan customer service dan cara menangani lonjakan chat promo.

Hasilnya sederhana: daftar kirim Anda menyusut ke orang yang memang ingin dikirimi, dan itu satu-satunya cara yang berkelanjutan untuk menjaga nomor tetap hijau.

Jika Anda sedang menebak kenapa jangkauan broadcast turun sementara tagihan naik, diskusikan kebutuhan bisnis Anda bersama tim Obrola.

Pertanyaan yang Sering Diajukan Tentang Kesalahan WhatsApp API (FAQ)

Apakah nomor yang berstatus Flagged bisa pulih?

Bisa, dan jendelanya tujuh hari. Kalau kualitas membaik sebelum tujuh hari lewat, status kembali normal tanpa konsekuensi; kalau tidak, nomor tetap kembali ke Connected tetapi batas percakapan yang Anda mulai turun satu tingkat.

Selama masa itu, cara tercepat memperbaikinya adalah berhenti mengirim ke daftar dingin, bukan mengirim lebih banyak ke daftar yang aktif.

Apakah pindah penyedia menghapus riwayat kualitas nomor?

Tidak. Kualitas nomor dan pesan ditentukan Meta, bukan oleh penyedia yang Anda pakai untuk mengaksesnya, jadi riwayatnya melekat pada nomor dan akun WhatsApp Business Anda.

Pindah penyedia bisa memperbaiki alat kerja dan pelaporan, tetapi tidak mengembalikan tier yang sudah turun.

Apakah template yang sudah dinonaktifkan bisa diajukan lagi?

Yang tercatat di dokumentasi Meta hanya tiga tahap: jeda 3 jam, jeda 6 jam, lalu nonaktif. Jalan ke depan biasanya membuat template baru dengan isi yang berbeda, bukan menghidupkan yang lama.

Satu hal yang perlu diingat sejak 16 April 2025: akun yang sudah pernah ditegur soal kategori template tidak lagi mendapat pemberitahuan 24 jam sebelum kategorinya dipindahkan, sehingga template pengganti sebaiknya dibuat benar-benar bersih dari kalimat promosi.

Apakah pelanggan yang sudah memblokir bisa dihubungi lagi?

Tidak lewat nomor yang sama, dan mengirim dari nomor lain tidak menyelesaikan apa pun. Blokir beserta alasannya sudah masuk sebagai sinyal kualitas, dan kebijakan WhatsApp menuntut izin yang masih berlaku sebagai syarat menghubungi seseorang.

Yang bisa dilakukan adalah membuka jalan agar dia menghubungi Anda lebih dulu, misalnya lewat iklan Click-to-WhatsApp yang membuka jendela 72 jam sejak Anda membalas.

Artikel terkait

Sumber