WhatsApp Gateway¶

WhatsApp Gateway memungkinkan TB Radius kirim pesan WA otomatis ke pelanggan untuk:

📨 OTP login — pelanggan login portal pakai nomor HP + kode OTP via WA
💳 Reminder tagihan — H-3, H-1, hari jatuh tempo
✅ Konfirmasi pembayaran — auto-notif saat invoice paid
🚨 Alert isolir — beritahu pelanggan kalau diisolir karena menunggak
📢 Broadcast pengumuman — info maintenance, promo, dll

WhatsApp jauh lebih efektif daripada SMS atau email — open rate 90%+ vs email ~20%.

Pilihan Gateway WA¶

Ada beberapa cara kirim WA otomatis:

Method	Cara Kerja	Pro	Con
Unofficial gateway (3rd party)	Pakai library WhatsApp Web automation	Murah (Rp 100-300 per pesan), mudah signup	Risiko nomor di-ban WhatsApp
WhatsApp Business API (official)	Resmi dari Meta via BSP (Business Solution Provider)	100% legal, scalable, ada template tersertifikasi	Mahal (~Rp 800/pesan), proses approve lambat
Mesin pribadi (manual)	Tidak rekomendasi — tidak otomatis	Gratis	Skala terbatas, butuh manual

TB Radius support kedua model. Untuk start, unofficial gateway cukup. Saat scale 1000+ pesan/hari atau perlu compliance ketat, upgrade ke WA Business API.

Pilihan Provider Gateway Unofficial Populer¶

Provider	Harga	Catatan
Fonnte	Mulai Rp 100/pesan	Populer di komunitas dev ID, dokumentasi bagus
Wablas	Rp 100-300/pesan	Stabil, banyak fitur
Wassenger	$$$	Lebih kompleks, fitur enterprise
Whacenter	Lokal Indonesia	Murah

Saran: Untuk start, pakai Fonnte atau Wablas — UI sederhana, signup cepat, harga jelas.

Persyaratan¶

✅ Nomor HP yang akan jadi "sender" — sebaiknya nomor khusus brand Anda (jangan nomor pribadi)
✅ Nomor HP yang sudah terdaftar WhatsApp Business (gratis, install via Play Store/App Store)
✅ Akun di provider gateway pilihan + saldo/kredit awal
✅ API key & device ID dari provider

Setup Best Practice¶

1. Siapkan Nomor Khusus¶

Jangan pakai nomor pribadi Anda sebagai sender. Bikin nomor baru:

Nomor prabayar baru (provider lokal: Telkomsel, XL, Indosat)
Aktifkan WhatsApp Business (bukan WhatsApp biasa)
Set profile bisnis: nama brand, logo, alamat, jam operasional
Setup greeting message & away message

Daftar di website provider (mis. fonnte.com / wablas.com)
Top-up saldo awal (mulai Rp 50.000-100.000 untuk test)
Pair device — scan QR code di app WhatsApp Business dengan provider gateway (mirip cara connect WhatsApp Web)
Dapat API key + Device ID

3. Aktifkan di TB Radius¶

Buka Settings → WhatsApp Gateway
Pilih provider yang dipakai
Paste API Key & Device ID
Set default sender name (mis. "Akbar Net Support")
Klik Save → test kirim ke nomor Anda sendiri
Cek WhatsApp Anda — kalau pesan masuk, gateway aktif ✅

4. Setup Template Pesan (Opsional)¶

Customize template pesan default. Variabel yang bisa dipakai:

Variabel	Isi
`{nama}`	Nama pelanggan
`{tagihan}`	Nominal tagihan (mis. "Rp 350.000")
`{jatuh_tempo}`	Tanggal jatuh tempo
`{paket}`	Nama paket internet
`{nomor_invoice}`	Nomor invoice
`{link_bayar}`	Link halaman pembayaran
`{brand}`	Nama brand tenant

Contoh template reminder H-3:

Halo {nama},

Pengingat tagihan {paket} senilai {tagihan} akan jatuh tempo {jatuh_tempo}.

Bayar sekarang lewat: {link_bayar}

Terima kasih,
{brand}

5. Aktifkan Auto-Trigger¶

Di Settings → Notifikasi, atur kapan WA dikirim otomatis:

✅ Reminder H-3 sebelum jatuh tempo
✅ Reminder H-1
✅ Hari jatuh tempo
✅ Konfirmasi pembayaran berhasil
✅ Alert saat diisolir
✅ Konfirmasi setelah pembayaran (un-isolir)

Best Practices¶

Jangan spam

WhatsApp ban nomor yang kirim pesan massal terlalu cepat. Idealnya:

Max 50-100 pesan per jam (untuk akun baru)
Spread pesan secara natural (jangan kirim 500 pesan dalam 5 menit)
Pakai variasi template (jangan persis sama isi pesan ke semua)

TB Radius punya throttling otomatis kalau dipasang.

Backup gateway

Pakai 2 nomor sender untuk failover. Kalau 1 nomor di-ban WA, masih ada cadangan. Setup di Settings → WA Gateway → Tambah Device Lain.

Personalisasi pesan

Template kurang personal = engagement rendah. Tambahkan:

Nama pelanggan ({nama})
Detail spesifik (paket mereka, tagihan exact)
CTA jelas (link bayar)

Risiko nomor di-ban

WhatsApp punya algoritma deteksi spam. Nomor bisa di-ban kalau:

Banyak pelanggan block/report spam
Volume kirim ekstrem (10.000+/hari dari 1 nomor)
Pakai 1 nomor untuk broadcast ke ratusan nomor yang tidak save kontak

Mitigasi: - Pelanggan disarankan save nomor brand Anda - Pesan harus relevant (transactional, bukan promo random) - Limit broadcast (kalau ada) max 100 nomor sekali kirim

Kalau di-ban, ganti nomor baru.

Bukan jaminan delivery 100%

Pesan WA bisa tidak masuk karena:

Pelanggan offline lama
Storage HP penuh
WhatsApp pelanggan uninstall
Pelanggan sudah block nomor sender

Solusi: kombinasi WA + push notif (PWA) untuk multi-channel.

Troubleshooting¶

Test send WA tidak masuk ke nomor saya

Cek satu per satu:

Saldo di provider gateway cukup? Top-up dulu
Device "Connected" di provider? Login dashboard provider → cek status device → kalau "Disconnected", scan ulang QR
API key benar? Re-paste, hati-hati spasi/typo
Nomor target valid? Format harus internasional (628xxx atau +628xxx)

Kadang masuk, kadang tidak

Biasanya issue di provider gateway side:

Rate limit hit (terlalu banyak kirim)
Device WhatsApp lagi disconnect dari server provider
Maintenance provider

Solusi: cek log di dashboard provider, restart device (logout-login WhatsApp Web), atau coba provider lain.

Pelanggan komplain "tidak terima WA reminder"

Step troubleshoot:

Cek log kirim WA di dashboard TB Radius — apakah ter-log "Sent"?
Cek dashboard provider — status delivery (Sent/Delivered/Read)
Tanya pelanggan: nomor di TB Radius sama persis dengan nomor WhatsApp mereka?
Pelanggan pernah block nomor sender?

Pesan masuk tapi terdeteksi spam di HP pelanggan

Pelanggan belum save kontak nomor brand Anda → masuk "Unknown"
Edukasi pelanggan: save nomor support Anda
Hindari kata-kata "spammy" di template (gratis, diskon besar, klik link cepat)
Pakai gateway dengan reputasi bagus (jangan provider asal-asalan)

Bisa pakai WhatsApp Business API (official)?

Bisa. TB Radius support 360dialog, Meta Cloud API, atau via BSP lain. Setup lebih kompleks (butuh approval template, KYC), cocok untuk skala enterprise. Hubungi support untuk panduan.

FAQ¶

Q: Bisa pakai WhatsApp pribadi sebagai sender? A: Secara teknis bisa, tapi sangat tidak disarankan. Risiko:

Nomor pribadi Anda di-ban WhatsApp
Pelanggan blast personal chat
Tidak professional

Pakai nomor khusus brand.

Q: Berapa biaya total pakai WhatsApp Gateway? A: Estimasi untuk 100 pelanggan:

100 pelanggan × 5 pesan/bulan (reminder H-3, H-1, due, konfirmasi, dll) = 500 pesan/bulan
500 × Rp 150 = Rp 75.000/bulan

Sangat murah dibanding manual call/SMS.

Q: Bisa terima WA balasan dari pelanggan? A: Provider gateway biasanya kirim only. Untuk 2-way conversation (chatbot), butuh fitur premium provider atau pakai WhatsApp Business API official.

Q: Beda WhatsApp Business vs WhatsApp biasa untuk gateway? A: WhatsApp Business punya:

Profile bisnis (nama, logo, jam operasional)
Auto-reply (greeting, away message)
Label kontak
Quick replies

Untuk gateway, pakai WhatsApp Business lebih professional & cocok.