Panduan Chat Mikhmon
Setup dan Penggunaan Chat Admin
Panduan khusus untuk setup awal Chat Admin, termasuk kewajiban set password admin baru, alur login, sinkronisasi, dan operasional harian.
Daftar Bab Panduan Chat
Ikuti urutan dari setup password pertama sampai validasi operasional.
- 1. Akses Awal Chat Admin
- 2. Setup Password Admin Pertama
- 3. Install PWA Admin (Wajib)
- 4. Optimasi Permission Android (Wajib untuk Notifikasi Stabil)
- 5. Login Harian dan Keamanan Login
- 6. Konfigurasi Wajib Setelah Login
- 7. Fitur Utama Chat Mikhmon
- 8. Troubleshooting Umum
- Catatan Penting
- FAQ Chat Mikhmon
1. Akses Awal Chat Admin
Masuk ke halaman login chat admin dan pahami mode setup awal.
- Akses URL Chat Admin Login di browser: /chat/admin/login.php.
- Jika ini instalasi baru dan belum ada local admin, halaman akan menampilkan status Setup Required.
- Username admin pada setup awal mengikuti admin session aktif, ditampilkan sebagai username tetap (fixed).
- Jika akses dari dashboard chat dan local admin belum dibuat, akan muncul banner Set Local Admin Password.
Screenshot Terkait
2. Setup Password Admin Pertama
Tahap wajib agar login local admin bisa digunakan stabil.
- Isi Password baru minimal 8 karakter.
- Isi Confirm Password dengan nilai yang sama.
- Klik tombol Set Admin Password.
- Setelah sukses, sistem menampilkan notifikasi bahwa akun siap digunakan untuk login.
Screenshot Terkait
3. Install PWA Admin (Wajib)
Setelah setup password pertama, admin wajib install PWA sebelum dashboard bisa dipakai penuh.
- Setelah setup password sukses, login ke Chat Admin Dashboard.
- Jika penguncian PWA aktif, muncul overlay "Install PWA Diperlukan" yang mengunci halaman admin web.
- Klik tombol Install Sekarang.
- Jika prompt belum muncul, buka menu browser lalu pilih "Add to Home screen" atau "Install app".
- Setelah install diterima, tunggu reload lalu tutup tab browser biasa.
- Buka kembali dari icon aplikasi di home screen/desktop agar mode standalone terdeteksi.
- Jika gate masih tampil, klik Saya Sudah Install untuk cek ulang status.
- Jika browser tidak mendukung PWA, gunakan Chrome/Edge versi terbaru.
Screenshot Terkait
4. Optimasi Permission Android (Wajib untuk Notifikasi Stabil)
Setelah PWA terpasang, atur permission Android agar notifikasi chat tidak telat atau hilang.
- Buka App Info aplikasi PWA chat dari Settings Android.
- Masuk ke Notifications, aktifkan Allow notifications.
- Aktifkan notifikasi popup/floating (nama menu bisa Pop-up, Floating notifications, atau Heads-up).
- Di Battery, ubah ke No restrictions / Unrestricted agar proses background tidak dibatasi.
- Di menu App battery usage atau Advanced, matikan Pause app if unused (Android 12+).
- Jika ada opsi Auto-start / Background activity, aktifkan agar aplikasi tetap bisa memproses notifikasi.
- Buka kembali aplikasi dari icon PWA, lalu lakukan tes kirim notifikasi/chat untuk verifikasi.
Screenshot Terkait
5. Login Harian dan Keamanan Login
Alur login harian setelah local admin berhasil dibuat dan PWA terpasang.
- Masuk lagi ke halaman login, isi Username dan Password local admin.
- Klik Login untuk masuk ke Chat Server Admin Dashboard.
- Jika gagal login berulang (5 kali), akun akan lock sekitar 15 menit.
- Setiap login sukses akan memicu heartbeat agar sinkronisasi data tetap berjalan di background.
Screenshot Terkait
6. Konfigurasi Wajib Setelah Login
Checklist minimum sebelum chat dipakai operasional.
- Pilih router session di card Router Session Selection.
- Jalankan Sync Now pada Hotspot Cache Sync untuk mengambil data terbaru dari router.
- Pastikan status sync Ready dan cek Last Sync sudah terisi.
- Verifikasi statistik dasar (total users, vouchers, sold/used) agar data awal terbaca benar.
Screenshot Terkait
7. Fitur Utama Chat Mikhmon
Fitur yang paling sering dipakai admin harian.
- Tabs utama admin: Chats, Users, Sales, dan pages utilitas dari burger menu.
- Hotspot cache sync: manual Sync Now dan auto-sync via heartbeat (sekitar 10 menit).
- Admin tools: Edit Profile, Admin Setting, Notification Wizard, PWA Settings.
- System tools: System Info dan DB Backup & Restore untuk maintenance.
Screenshot Terkait
8. Troubleshooting Umum
Langkah cepat jika setup atau operasi chat tidak berjalan normal.
- Jika Setup Required tidak muncul padahal belum pernah set password, cek database chat dapat diinisialisasi tanpa error.
- Jika Set Admin Password gagal, pastikan password dan konfirmasi sama serta minimal 8 karakter.
- Jika layar "Install PWA Diperlukan" tidak hilang, pastikan aplikasi dibuka dari icon PWA (bukan tab browser biasa).
- Jika tombol Install Sekarang tidak memunculkan prompt, install manual dari menu browser.
- Jika notifikasi tidak muncul floating, cek ulang izin Notifications dan aktifkan popup/floating notification.
- Jika notifikasi telat, pastikan Battery optimization aplikasi sudah No restrictions / Unrestricted.
- Jika aplikasi sering berhenti sendiri, matikan Pause app if unused di pengaturan aplikasi Android.
- Jika login gagal terus, tunggu lockout selesai lalu coba lagi dengan kredensial benar.
- Jika data user belum update, pastikan router session benar lalu ulangi Sync Now.
- Jika auto-sync tidak bergerak, cek heartbeat status dari dashboard chat admin dan login ulang untuk trigger heartbeat.
Screenshot Terkait
Catatan Penting
Poin keamanan dan stabilitas yang wajib diperhatikan admin.
- Gunakan password admin chat yang kuat dan berbeda dari password default lama.
- Mode admin bisa dikunci sampai PWA terpasang dan aplikasi dibuka dari icon (mode standalone).
- Untuk Android, wajib atur notifikasi popup/floating, Battery ke No restrictions, dan matikan Pause app if unused.
- Jangan reset database chat saat operasional aktif kecuali ada rencana maintenance jelas.
- Sebelum deploy ke pelanggan, lakukan uji end-to-end: login chat, sinkronisasi, kirim pesan, dan alur reminder.
- Simpan jalur akses penting: /chat/admin/login.php dan /chat/admin/index.php.
Screenshot Terkait
FAQ Chat Mikhmon
Pertanyaan yang paling sering muncul saat setup awal dan penggunaan harian.
Kenapa admin harus membuat password baru saat setup awal?
Tanpa local admin password, login local tidak aktif dan mode setup akan terus muncul.
Apakah username saat setup awal bisa diganti?
Pada setup awal, username mengikuti admin session aktif dan ditampilkan sebagai fixed username.
Berapa minimal panjang password setup?
Minimal 8 karakter sesuai validasi form setup.
Jika salah password berkali-kali apa yang terjadi?
Setelah 5 kali gagal login, akun dikunci sementara sekitar 15 menit.
Kapan admin wajib install PWA?
Setelah setup password pertama berhasil dan admin login ke dashboard chat. Jika gate aktif, instalasi PWA wajib diselesaikan sebelum lanjut.
Kenapa setelah install PWA halaman masih terkunci?
Biasanya karena masih dibuka dari tab browser biasa. Tutup lalu buka dari icon aplikasi PWA, kemudian klik Saya Sudah Install jika diminta.
Kalau prompt install tidak muncul, bagaimana?
Gunakan menu browser lalu pilih Add to Home screen atau Install app. Setelah itu buka dari icon aplikasi.
Di mana mengatur opsi wajib install PWA untuk admin?
Buka halaman PWA Settings dari menu admin, lalu cek toggle Wajibkan Admin Install PWA.
Bagaimana mengaktifkan notifikasi floating untuk PWA di Android?
Buka App Info aplikasi PWA, masuk ke Notifications, aktifkan Allow notifications dan popup/floating notification (nama menu bisa berbeda tiap brand).
Kenapa notifikasi chat sering telat masuk di Android?
Biasanya karena pembatasan baterai. Ubah Battery optimization aplikasi ke No restrictions/Unrestricted dan pastikan background activity tidak dibatasi.
Apa fungsi Pause app if unused dan kenapa harus dimatikan?
Fitur ini menghentikan aktivitas aplikasi yang jarang dipakai. Matikan agar PWA chat tetap aktif memproses notifikasi saat idle.
Kapan harus klik Sync Now manual?
Klik saat setup pertama, setelah perubahan besar data, atau saat data dashboard chat terasa belum sinkron.
Apa langkah cepat setelah setup password berhasil?
Login ulang, selesaikan install PWA jika gate muncul, optimalkan permission Android, lalu pilih router session dan jalankan Sync Now.