Notifikasi
Notifikasi Push (FCM)
Penjelasan notifikasi push dari server via FCM, jenis pesan yang dikirim, dan cara mengizinkan notifikasi di perangkat.
Apa itu Notifikasi Push (FCM)?
Selain pengingat yang dibuat oleh aplikasi sendiri (client-side), POS juga menerima notifikasi push yang dikirimkan dari server pusat melalui layanan Firebase Cloud Messaging (FCM). Notifikasi jenis ini tidak memerlukan aplikasi dalam kondisi terbuka — pesan dapat masuk bahkan saat aplikasi berjalan di latar belakang atau dalam kondisi tertutup.
Jenis Notifikasi Push dari Server
Server mengirimkan notifikasi push berdasarkan kejadian penting di platform. Berikut kategori utamanya:
| Kategori | Contoh Pesan | Tujuan |
|---|---|---|
Operasional (system) | Pembaruan fitur, pengumuman dari pengelola platform | Semua staf |
Stok (inventory) | Peringatan stok bahan baku mendekati batas minimum | Staf yang berwenang |
Langganan (billing) | Masa aktif berlangganan akan berakhir, pembayaran berhasil | Manajer / Owner |
Reservasi (reservasi) | Booking baru masuk, tamu tiba | Pelayan / Host |
Pesanan (order) | Pembaruan status pesanan tertentu | Kasir / Pelayan |
Cara Kerja Push Notification
Saat Aplikasi Terbuka (Foreground)
FCM tidak menampilkan notifikasi push secara otomatis ketika aplikasi sedang dibuka. Sebagai gantinya, POS menangani pesan tersebut secara internal:
- Pesan disimpan ke inbox Notifikasi (dapat dibaca di halaman Notifikasi).
- Badge merah di ikon Bell bertambah sesuai jumlah pesan baru.
- Heads-up (pop-up) muncul sekilas di layar — kecuali jika grup notifikasi terkait sudah di-mute.
Saat Aplikasi di Latar Belakang atau Tertutup
Sistem operasi Android/iOS yang menampilkan notifikasi langsung di panel notifikasi perangkat. Ketuk notifikasi tersebut untuk membuka aplikasi dan langsung melompat ke halaman yang relevan sesuai jenis notifikasinya.
Izin Notifikasi Perangkat
Agar notifikasi push dapat berfungsi, perangkat harus mengizinkan notifikasi dari aplikasi POS.
Android
Pada Android 13 ke atas, aplikasi akan meminta izin notifikasi saat pertama kali dijalankan atau saat staf login. Pastikan izin ini disetujui.
Jika izin sudah pernah ditolak:
- Buka Pengaturan perangkat.
- Pilih Aplikasi → cari FnB POS.
- Pilih Notifikasi → aktifkan izin notifikasi.
iOS
Pada iPhone/iPad, sistem akan menampilkan dialog izin notifikasi. Pilih Izinkan agar push notification dapat diterima.
Perhatian: Tanpa izin notifikasi, push notification tidak akan muncul di panel sistem. Pesan tetap masuk ke inbox aplikasi, tetapi Anda tidak mendapat tanda apapun saat aplikasi ditutup.
Registrasi Token FCM
Setiap kali staf login, aplikasi secara otomatis mendaftarkan token FCM perangkat ke server. Token ini memastikan server dapat mengirimkan pesan push tepat sasaran ke perangkat yang benar.
Jika token berubah (misalnya setelah update sistem atau reinstall aplikasi), token baru akan didaftarkan ulang secara otomatis tanpa perlu tindakan dari staf.
Tip: Jika notifikasi push tiba-tiba berhenti masuk padahal izin sudah diberikan, coba logout lalu login kembali untuk memperbarui registrasi token FCM.
Notifikasi Push dan Inbox
Semua notifikasi push yang diterima — baik saat aplikasi terbuka maupun tertutup — otomatis tersimpan di inbox halaman Notifikasi. Anda tidak perlu khawatir kehilangan pesan meskipun tidak sempat melihat pop-up saat pesan masuk.
Untuk mengatur mana grup notifikasi yang memunculkan heads-up dan mana yang tidak, lihat artikel Preferensi & Mute per Grup.