Aplikasi Android TBR Client¶

TBR Client adalah aplikasi Android resmi untuk pelanggan internet TB Radius. Berbasis PWA wrapper — UI sama dengan portal web client.tbradius.com, tapi native experience: icon di home screen, splash screen, push notification, dll.

PWA vs Native App¶

Aspek	PWA (Web Portal)	Native App (TBR Client)
Install	"Add to Home Screen" dari browser	Download dari Play Store
Update	Otomatis (saat refresh)	Via Play Store update
Push Notif	Bisa (modern browser)	Bisa, lebih reliable
Offline support	Limited	Better caching
Native features	Limited (geolocation, camera)	Full access
Resource HP	Lebih hemat	Lebih banyak RAM
Update by tenant	Otomatis sync	Tergantung user update

Saran: Promote keduanya. Pelanggan yang tech-savvy akan install app, yang awam pakai PWA. Cover both.

Cara Pelanggan Install¶

Dari Play Store¶

Buka Google Play Store
Search: TBR Client atau TB Radius
Klik Install
Setelah install, buka app
Login dengan nomor HP + OTP WhatsApp

Dari Link Direct (Sideload)¶

Kalau app belum publish di Play Store atau pelanggan di region tertentu:

Anda kirim link APK ke pelanggan
Pelanggan download APK
Settings → Security → Install from Unknown Sources → Enable
Tap APK file → Install
Open & login

Sideload risk

APK dari source non-Play Store tidak verified Google. Pastikan link APK Anda dari sumber resmi (mis. tbradius.com), bukan share via WhatsApp dari pelanggan ke pelanggan.

Fitur Eksklusif App (vs PWA)¶

App Android punya beberapa fitur yang lebih baik dari PWA:

Fitur	Detail
Push notification reliable	Native FCM, jarang miss
Auto-login persistent	Token disimpan secure (Android Keystore), tidak expired
Better offline	Cache lebih agresif, view tagihan offline
Native share	Share invoice/receipt ke WhatsApp/email langsung
Biometric login	Fingerprint / Face ID (kalau didukung HP)
App-specific theme	Tampilan native Android Material You

Persyaratan HP Pelanggan¶

✅ Android 7.0 (Nougat) atau lebih tinggi
✅ ~30 MB storage free
✅ Internet untuk first login (offline mode setelah)
✅ WhatsApp aktif untuk OTP

Promote App ke Pelanggan¶

Saat pelanggan akses portal web, tampilkan banner:

📱 Install aplikasi TBR Client untuk pengalaman lebih cepat. Download di Play Store →

2. WhatsApp Welcome¶

Saat onboarding pelanggan baru, kirim link install app di WA.

3. QR Code di Brosur / Material Promosi¶

QR code → langsung ke Play Store. Pelanggan scan saat install layanan.

4. Incentive (Opsional)¶

Untuk push adoption, bisa kasih insentif:

Diskon pembayaran via app
Reward poin (kalau ada loyalty program)
Akses fitur premium

Cara Update App¶

App pakai standard Google Play update:

Auto-update (default) — pelanggan otomatis dapat versi terbaru
Manual update — pelanggan buka Play Store → app → Update

Kalau ada update penting (mis. bug fix critical), tampilkan banner di app:

⚠️ Update tersedia. Tap untuk update.

Best Practices¶

Konsisten dengan PWA

Pengalaman di app dan PWA harus sama:

Fitur sama
Tampilan sama (tema, warna)
Flow login sama

Pelanggan pindah dari PWA ke app (atau vice versa) → tidak bingung.

Onboarding tutorial

Tampilkan tutorial saat first launch app:

3-4 screen swipe-able
Highlight fitur utama (cek tagihan, bayar, ganti WiFi)
Tombol "Skip" untuk pelanggan yang tidak sabar
Tombol "Mulai" di akhir → langsung ke login

Versi update tidak terlalu sering

Force update tiap minggu = annoy pelanggan. Strategi:

Mayor update (UI redesign, fitur baru): 1-2× setahun
Minor update (improvement): bulanan
Hotfix (bug critical): segera, tapi force update only kalau benar-benar perlu

Tidak semua HP pelanggan support

HP lama (Android < 7) atau HP entry-level dengan RAM rendah mungkin tidak bisa install. Mereka tetap bisa pakai PWA via browser.

Privacy & permission

App butuh beberapa permission Android. Justify ke pelanggan:

Internet: untuk akses portal
Notification: untuk push tagihan
Storage (kalau download invoice): untuk save PDF

Jangan request permission yang tidak perlu (mis. Camera, Contacts, Location). Pelanggan curiga = uninstall.

Troubleshooting¶

Pelanggan tidak temukan app di Play Store

Kemungkinan:

App belum publish untuk semua region. Cek Play Console.
Pelanggan di region tidak supported (mis. Anda batasi distribusi)
Nama search berbeda — share link direct ke Play Store
HP terlalu lama — tidak compatible

Install gagal "Aplikasi tidak terpasang"

Storage HP penuh
HP rooted dengan custom ROM yang bermasalah
File APK corrupt (kalau sideload) — re-download

Login app gagal padahal PWA bisa

Cache app bermasalah → clear app data di Settings HP
Versi app outdated → update
Endpoint API berubah (rare) → reinstall

Push notif tidak masuk di app

Notification permission disabled di Settings HP → enable
Battery saver kill app → exclude TBR Client dari battery optimization
Token FCM lama (kalau pelanggan reinstall) — login ulang akan refresh token

FAQ¶

Q: Apakah app tersedia untuk iOS? A: Saat ini hanya Android. iOS user pakai PWA via Safari — install PWA via Share → "Add to Home Screen". Pengalaman 80% mirip native app.

Q: App di Play Store gratis? A: Iya, gratis download. Pelanggan tetap bayar layanan internet ke Anda (tenant), bukan ke TB Radius.

Q: Bisa custom app dengan nama brand saya (whitelabel)? A: Available di paket Enterprise — build APK custom dengan nama dan logo brand Anda, publish di Play Store sendiri. Hubungi support untuk detail.

Q: Pelanggan punya 1 nomor HP tapi punya 2 akun (1 rumah + 1 kantor)? A: Bisa. App support switch antar akun di Settings → Switch Account. Login multiple akun, switch dengan 1 tap.

Q: App jalan di background? A: Iya, untuk terima push notification. Kalau pelanggan force-stop atau battery saver, push bisa miss. Pelanggan harus allow app jalan background.