WhatsApp Gateway
Panduan lengkap WhatsApp Gateway bawaan LancarTech — dari setup koneksi, multi-device, round-robin load balancing, template pesan otomatis, broadcast campaign, hingga monitoring dan rate limiting. Semua notifikasi ISP Anda dikirim langsung dari dashboard tanpa aplikasi pihak ketiga tambahan.
Overview
LancarTech menyediakan WhatsApp Gateway terintegrasi yang dirancang khusus untuk kebutuhan ISP. Tidak perlu berlangganan layanan WhatsApp API terpisah — cukup scan QR code dari dashboard, dan nomor WhatsApp Anda langsung siap mengirim notifikasi ke seluruh subscriber.
Gateway ini mendukung dua mode koneksi: langsung dari nomor Anda) dan third-party API). Anda juga dapat menggunakan keduanya secara bersamaan dengan fitur multi-koneksi dan load balancing otomatis.
Tanpa Biaya Tambahan
Koneksi in-house menggunakan nomor WhatsApp Anda sendiri — tidak ada biaya per-pesan atau langganan API bulanan.
Multi-Koneksi & Load Balancing
Multi-koneksi per tenant — hubungkan beberapa nomor WA dan distribusi pesan dengan round-robin load balancing.
Template Pesan Dinamis
Template pesan dinamis dengan variabel: {nama}, {invoice}, {jumlah}, {jatuh_tempo} — personalisasi otomatis.
Rate Limiting Cerdas
Rate limiting cerdas — mencegah spam dan menjaga reputasi nomor WhatsApp Anda.
Jenis Koneksi
LancarTech mendukung dua jenis koneksi WhatsApp yang dapat digunakan secara terpisah maupun bersamaan. Pilih jenis koneksi yang paling sesuai dengan kebutuhan dan skala operasi ISP Anda.
| Aspek | In-House (WhatsApp Web) | Fonnte (Third-Party API) |
|---|---|---|
| {{nama}} | Nama subscriber | Budi Santoso |
| {{nomor_invoice}} | Nomor invoice tagihan | INV-2026-0042 |
| {{jumlah_tagihan}} | Nominal tagihan yang harus dibayar | Rp 150.000 |
| {{tanggal_jatuh_tempo}} | Tanggal jatuh tempo pembayaran | 5 April 2026 |
| {{status_layanan}} | Status layanan internet subscriber | Aktif |
bawah 2.000, koneksi in-house sudah cukup dan menghemat biaya operasional. Untuk ISP yang lebih besar atau yang membutuhkan uptime 99.9%, pertimbangkan Fonnte sebagai primary dan in-house sebagai fallback.
Setup Koneksi In-House
Koneksi in-house menggunakan protokol WhatsApp Web multi-device. Setelah scan QR code, koneksi akan aktif dan HP Anda tidak perlu online 24/7. Berikut langkah-langkah setup koneksi in-house:
Navigasi ke menu Jaringan > WhatsApp Gateway di sidebar dashboard. Halaman ini menampilkan daftar koneksi WhatsApp yang aktif.
Klik tombol Tambah Koneksi di pojok kanan atas. Pilih tipe koneksi: In-House (WhatsApp Web) atau Fonnte (Third-Party API).
Untuk koneksi in-house, buka WhatsApp di ponsel Anda, masuk ke Linked Devices, dan scan QR code yang ditampilkan di dashboard.
Setelah scan berhasil, status koneksi akan berubah menjadi Connected. Kirim pesan test untuk memastikan koneksi berfungsi dengan baik.
Jika Anda memiliki beberapa koneksi, pilih satu sebagai default untuk pengiriman pesan otomatis. Koneksi lain akan digunakan sebagai fallback.
bukan nomor pribadi utama Anda. Gunakan nomor khusus bisnis/CS agar tidak tercampur dengan pesan pribadi. Nomor yang terlalu sering mengirim pesan massal berisiko terkena pembatasan atau ban dari WhatsApp.
Setup Fonnte
Fonnte adalah layanan third-party WhatsApp API untuk pengiriman pesan massal dengan reliability tinggi. Setup hanya memerlukan API key dari dashboard Fonnte.
Masuk ke dashboard Fonnte (fonnte.com), salin API Token dari halaman pengaturan akun Anda.
Kembali ke LancarTech, pilih tipe koneksi Fonnte, dan masukkan API Token. Sistem akan memvalidasi token secara otomatis.
Kirim pesan test ke nomor Anda untuk memverifikasi integrasi. Periksa status delivery di log pengiriman.
koneksi in-house terputus, sistem otomatis mengalihkan pengiriman ke koneksi Fonnte yang aktif.
Multi-Koneksi & Round-Robin
Untuk ISP dengan jumlah subscriber besar, satu koneksi WhatsApp mungkin tidak cukup untuk mengirim semua notifikasi tepat waktu. LancarTech mendukung multi-koneksi dengan load balancing otomatis menggunakan algoritma round-robin.
Cara Kerja Round-Robin
Saat ada pesan yang perlu dikirim, sistem memilih koneksi aktif secara bergiliran. Jika Anda memiliki 3 koneksi aktif (A, B, C), pesan pertama dikirim via A, pesan kedua via B, pesan ketiga via C, lalu kembali ke A, dan seterusnya. Distribusi ini memastikan beban pengiriman merata dan mengurangi risiko rate limiting per nomor.
Notifikasi Otomatis
Pesan dikirim otomatis berdasarkan trigger event: invoice terbit, reminder jatuh tempo, layanan aktif/suspend, dan pembayaran diterima.
Broadcast Campaign
Kirim pesan massal ke grup subscriber tertentu — filter berdasarkan area, paket, status, atau custom tag.
Jumlah Koneksi:: Jumlah maksimal koneksi Pricing untuk detail lengkap.
Template Pesan
Setiap notifikasi WhatsApp menggunakan template pesan yang mendukung variabel dinamis. Variabel akan otomatis diganti dengan data aktual subscriber saat pesan dikirim. Anda dapat menyesuaikan template untuk setiap jenis notifikasi.
Variabel yang Tersedia
| Variabel | Deskripsi | Contoh Output |
|---|---|---|
| {{nama}} | Nama subscriber | Budi Santoso |
| {{nama_paket}} | Nama paket layanan | Internet 20 Mbps |
| {{tagihan}} | Nominal tagihan | Rp 150.000 |
| {{jatuh_tempo}} | Tanggal jatuh tempo | 5 April 2026 |
| {{sisa_hari}} | Hari menuju jatuh tempo | Setiap koneksi memiliki salah satu status: |
| {{nomor_invoice}} | Nomor invoice | INV-2026-0042 |
| {{link_bayar}} | URL pembayaran Tripay | https://pay.lancar.id/xxxx |
| {{nama_isp}} | Nama perusahaan ISP | LancarNet |
| {{periode}} | Periode billing | April 2026 |
Contoh Template Reminder
Halo {{nama}},
Tagihan paket *{{nama_paket}}* periode *{{periode}}* sebesar *{{tagihan}}* jatuh tempo *{{jatuh_tempo}}* ({{sisa_hari}} hari lagi).
Bayar via: {{link_bayar}}
No. Invoice: {{nomor_invoice}}
Terima kasih, {{nama_isp}}Contoh Template Konfirmasi Pembayaran
Halo {{nama}}, pembayaran diterima!
Invoice: {{nomor_invoice}} — *LUNAS*
Paket: {{nama_paket}} | {{tagihan}}
Periode: {{periode}}
Layanan aktif hingga periode berikutnya. {{nama_isp}}Setiap jenis notifikasi (reminder, konfirmasi, isolir, tiket) memiliki template terpisah yang dapat disesuaikan. Gunakan preview untuk melihat hasil akhir sebelum menyimpan.
Jenis Notifikasi Otomatis
LancarTech mengirim notifikasi WhatsApp secara otomatis pada berbagai event penting dalam siklus layanan ISP. Setiap jenis notifikasi dapat diaktifkan atau dinonaktifkan secara independen.
Reminder H-7
Pengingat pertama dikirim 7 hari sebelum jatuh tempo. Pesan berisi informasi tagihan dan link pembayaran online.
Reminder H-3
Pengingat kedua dikirim 3 hari sebelum jatuh tempo. Nada pesan lebih mendesak dengan sisa waktu pembayaran.
Reminder H-1
Pengingat terakhir dikirim 1 hari sebelum jatuh tempo. Pesan menekankan deadline pembayaran besok.
Notifikasi Jatuh Tempo
Notifikasi pada hari jatuh tempo. Subscriber diberitahu bahwa pembayaran sudah jatuh tempo hari ini.
Peringatan Overdue
Peringatan 3 hari setelah jatuh tempo. Subscriber diberitahu bahwa layanan akan disuspend jika belum membayar.
Notifikasi Suspend
Notifikasi bahwa layanan telah disuspend karena belum ada pembayaran. Berisi link untuk melakukan pembayaran dan reaktivasi.
dapat disesuaikan per tenant. Misalnya, Anda dapat mengubahnya menjadi H-10, H-5, H-2 sesuai kebiasaan pembayaran subscriber di area Anda. Konfigurasi di
Broadcast & Campaign
Selain notifikasi otomatis, LancarTech menyediakan fitur broadcast untuk mengirim pesan massal ke subscriber. Fitur ini berguna untuk pengumuman maintenance, promo paket baru, atau informasi penting lainnya.
Langkah Membuat Broadcast
Navigasi ke WhatsApp > Broadcast, klik Buat Campaign. Masukkan nama campaign dan pilih template pesan yang akan digunakan.
Filter subscriber berdasarkan area, paket, status layanan, atau tag custom. Preview jumlah penerima sebelum mengirim.
Pilih kirim sekarang atau jadwalkan untuk waktu tertentu. Sistem mengirim secara bertahap dengan jeda antar pesan untuk menghindari rate limit.
broadcast berdasarkan status layanan (aktif/suspended), area, paket, status pembayaran, dan tag kustom — sehingga pesan tepat sasaran.
limiting bawaan untuk melindungi nomor WhatsApp Anda dari ban. Pesan dikirim secara bertahap dengan jeda antar pesan yang dikonfigurasi otomatis berdasarkan jumlah total penerima. Hindari mengirim broadcast ke lebih dari 1.000 penerima dalam satu jam.
Monitoring Koneksi
LancarTech secara aktif memantau status setiap koneksi WhatsApp. Dashboard monitoring menampilkan status real-time, histori koneksi, dan statistik pengiriman pesan. Sistem melakukan health check otomatis setiap 30 detik untuk memastikan semua koneksi berfungsi optimal.
Setiap koneksi memiliki salah satu status: Connected, Disconnected, Reconnecting, Reconnecting QR Pending.
Mekanisme Auto-Reconnect
Navigasi ke WhatsApp > Monitoring untuk melihat status real-time semua koneksi, jumlah pesan terkirim, dan tingkat keberhasilan delivery.
Setiap pesan memiliki status: Sent, Delivered, Read, atau Failed. Filter log berdasarkan tanggal, status, atau nomor tujuan untuk troubleshooting.
menampilkan metrik real-time: total pesan terkirim (harian / mingguan / bulanan), jumlah pesan gagal beserta alasan, dan antrian pesan yang sedang diproses — semua dengan breakdown per koneksi.
Rate Limiting & Plan Limits
Untuk melindungi nomor WhatsApp dari ban dan memastikan kualitas layanan, LancarTech menerapkan rate limiting pada beberapa level. Batasan ini juga terkait dengan paket SaaS yang digunakan tenant.
Rate limit per koneksi: jeda acak 2-5 detik antar pesan, maks 15 pesan/menit, 500/jam, 5.000/hari. Broadcast: batch 50 pesan dengan cooldown 30 detik. Dikelola otomatis via Redis.
Batas per Paket SaaS
| Paket | Koneksi | Pesan/Bulan | Broadcast |
|---|---|---|---|
| Starter | 1 | 5.000 | 500/campaign |
| Growth | 3 | 15.000 | 2.000/campaign |
| Enterprise | 10 | Unlimited | 5.000/campaign |
Peringatan dikirim saat mencapai 80% dan 95% batas bulanan. Upgrade paket kapan saja untuk meningkatkan kuota.
Best Practices
Berikut praktik terbaik untuk memaksimalkan efektivitas WhatsApp Gateway dan menjaga kesehatan nomor WhatsApp Anda:
Pesan Tidak Terkirim
Periksa status koneksi WhatsApp di dashboard. Pastikan ponsel terhubung ke internet dan sesi WhatsApp Web masih aktif. Restart koneksi jika perlu.
QR Code Expired
QR code memiliki masa berlaku terbatas. Jika expired, klik Refresh QR untuk generate QR baru dan scan ulang dari ponsel.
Rate Limit Tercapai
Kurangi frekuensi pengiriman atau tambah koneksi WhatsApp untuk mendistribusi beban. Periksa limit di halaman Plan & Usage.
Pesan Masuk Spam
Hindari mengirim pesan berulang dengan konten identik. Gunakan variabel personalisasi dan variasi template untuk menjaga kualitas pesan.
Koneksi Sering Putus
Pastikan ponsel yang digunakan memiliki koneksi internet stabil dan baterai cukup. Pertimbangkan dedicated device untuk WhatsApp Gateway.
Broadcast Gagal Sebagian
Beberapa nomor mungkin tidak valid atau telah memblokir Anda. Periksa log delivery untuk detail error dan bersihkan daftar kontak secara berkala.