B BGWA Docs
Konsep

Cara pengiriman

Mengapa pesan dikirim bertahap, apa saja yang dijaga, dan batas yang berlaku demi keamanan nomor Anda.

WhatsApp memantau pola pengiriman. Pesan yang ditembakkan sekaligus, berulang, atau ke banyak nomor asing adalah ciri utama akun yang diblokir. Karena itu BGWA memasang penjaga pengiriman di antara API dan WhatsApp.

Antrean dan jeda

Setiap pesan yang lolos pemeriksaan masuk antrean lalu dikirim satu per satu:

  • Jeda acak antar pesan (lebih pendek untuk kontak lama dan OTP, lebih panjang untuk penerima baru).
  • Indikator "sedang mengetik" sebelum pesan dikirim.
  • Istirahat panjang setelah beberapa belas pesan berturut-turut.

Akibatnya pesan bisa tiba beberapa detik sampai beberapa menit setelah request, tergantung panjang antrean. Respons POST /messages memuat eta_seconds (perkiraan) dan scheduled_for (waktu rencana kirim).

Penerima baru dan kontak lama

BGWA membedakan dua jenis penerima:

JenisDefinisiPerlakuan
Penerima baruNomor yang belum pernah membalas pesan device ini.Jeda lebih panjang dan batas harian/per jam yang lebih ketat.
Kontak lamaNomor yang sudah pernah membalas.Jeda lebih pendek dan batas harian lebih longgar.

Batas bawaan

Nilai di bawah adalah bawaan sistem. Admin BGWA dapat menyesuaikannya, jadi anggap sebagai acuan, bukan jaminan.

BatasBawaan
Penerima baru per hari100
Penerima baru per jam25
Pesan ke kontak lama per hari300
Pesan identik ke penerima baru per jam3
Pesan sama ke nomor yang samaditolak dalam 10 menit
Tautan per pesanmaksimal 2
OTP per jam20 (maks. 200 karakter, tanpa tautan)
Antrean tertundamaksimal 500 pesan

Pemanasan device baru

Nomor yang baru terhubung dibatasi lebih rendah, lalu naik bertahap seiring umur device:

Umur devicePenerima baru per hari
0 – 3 hari20
4 – 7 hari40
8 – 14 hari70
Lebih dari 14 haribatas penuh (bawaan 100)

Pemeriksaan sebelum masuk antrean

Request ditolak langsung (tanpa memakai kuota) jika:

  • Nomor tidak terdaftar di WhatsApp. BGWA mengecek nomor lebih dulu. Hasilnya diingat selama beberapa hari. Respons 422 dengan reason: "not_on_whatsapp".
  • Pesan duplikat. Teks sama ke nomor yang sama dalam 10 menit.
  • Isi terlalu seragam. Teks identik ke banyak penerima baru. Variasikan dengan spintax.
  • Terlalu banyak tautan (lebih dari 2 dalam satu pesan).
  • Penerima berhenti berlangganan. Bila penerima membalas STOP atau berhenti, nomornya tidak akan dikirimi lagi oleh device ini.
  • Kuota habis atau antrean penuh.

Perlindungan otomatis

Daftar nomor kotor

Jika dalam waktu singkat banyak nomor yang Anda kirimi ternyata tidak terdaftar di WhatsApp, BGWA menjeda pengiriman ke nomor yang belum dikenal (respons 503, reason: "invalid_numbers_high"). Kontak lama dan balasan tidak terpengaruh. Bersihkan daftar nomor Anda, lalu coba lagi nanti.

Pembatasan dari WhatsApp (kode 463)

Bila WhatsApp menolak beberapa pesan ke nomor berbeda karena akun dibatasi memulai chat baru, BGWA otomatis menjeda pengiriman ke penerima baru selama beberapa jam (reason: "new_contacts_paused"). Kontak yang pernah berbalas dan OTP tetap berjalan. Ini melindungi nomor Anda dari pembatasan yang lebih berat.

Jam malam (opsional)

Admin dapat mengaktifkan jam malam yang menahan pengiriman ke penerima baru (bukan OTP). Pesan yang ditahan dijadwalkan pagi harinya, dengan status scheduled.

Kuota bulanan

Setiap paket punya kuota pesan per bulan dan jumlah device maksimal. Pesan yang masih menunggu di antrean ikut dihitung terhadap kuota. Saat kuota habis, API menjawab 429 sampai periode berikutnya atau sampai Anda menaikkan paket.

Praktik terbaik

  • Kirim ke orang yang mengharapkannya: pelanggan, pemesan, atau pengguna yang memberi nomornya. Laporan spam adalah penyebab utama blokir.
  • Variasikan isi pesan dengan spintax dan variabel nama. Hindari teks identik ke banyak orang.
  • Pakai nomor yang hangat: punya riwayat chat, bukan nomor yang baru dibuat.
  • Hormati opt-out. BGWA otomatis menghentikan kiriman bagi yang membalas STOP, jangan mencoba mengakalinya.
  • Pantau hasil lewat webhook dan berhenti mengirim ke nomor yang selalu gagal.
  • Jangan coba-coba ulang tanpa batas ketika menerima 422/429/503. Hormati Retry-After.