Notifikasi WhatsApp

Halaman ini mengatur ke mana notifikasi operasional modul Retail (misalnya stok rendah, penjualan, kas) dikirim melalui WhatsApp — ke grup atau ke nomor staf. Konfigurasi bersifat per-event: Anda bisa menentukan tujuan default untuk seluruh modul, lalu menimpanya (override) pada event tertentu, dan untuk event yang relevan juga mengirim salinan ke nomor pelanggan.

Path menu: Pengaturan → Notifikasi WhatsApp (/settings/messaging)

---

Prasyarat: Add-on WhatsApp Gateway

Halaman ini hanya berfungsi jika add-on WhatsApp Gateway aktif untuk institusi Anda. Konfigurasi nomor dan koneksi WhatsApp bersifat terpusat di SSO (Console Poztix), bukan di modul Retail — halaman ini hanya memilih event mana yang dikirim dan ke tujuan apa.

Jika add-on belum aktif, halaman menampilkan peringatan "Add-on WhatsApp belum aktif" dan seluruh pengaturan disembunyikan. Untuk mengaktifkannya:

1. Aktifkan add-on WhatsApp Gateway untuk institusi Anda.
2. Hubungkan nomor WhatsApp di Console Poztix → Pengaturan → WhatsApp.
3. Kembali ke halaman ini — pengaturan event akan muncul.

Catatan: Karena konfigurasi WhatsApp bersifat kanonik di SSO, satu nomor/koneksi yang sama dipakai lintas modul (Retail, Hotel, dan lainnya). Yang berbeda per modul hanya daftar event dan tujuannya.

---

Tujuan notifikasi default

Bagian atas halaman berisi satu kolom Tujuan notifikasi default:

Kolom	Keterangan
Tujuan notifikasi default	Nomor staf operasional format 62xxx atau ID grup WhatsApp. Dipakai untuk semua event modul Retail yang tidak menetapkan tujuan khusus sendiri.

Perilaku:

• Isi dengan nomor (contoh 628123456789) atau ID grup WhatsApp tujuan alert operasional.
• Jika institusi Anda sudah punya default global (diatur di SSO), placeholder kolom akan menampilkan nilai global tersebut. Biarkan kolom ini kosong untuk memakai default global; isi hanya bila modul Retail perlu tujuan berbeda dari default global.

Tips: Untuk toko dengan beberapa staf, gunakan ID grup WhatsApp sebagai tujuan default agar semua anggota tim menerima alert yang sama dan bisa langsung berdiskusi di grup.

---

Pengaturan per-event

Di bawah tujuan default, halaman menampilkan daftar kartu event dalam bentuk grid. Daftar event tidak tetap — diambil secara dinamis dari registry event di SSO untuk modul Retail (app_id 10), sehingga event yang muncul mengikuti fitur yang tersedia. Jika belum ada event terdaftar, halaman menampilkan pesan "Belum ada event notifikasi terdaftar untuk modul ini."

Setiap kartu event memuat:

Elemen	Keterangan
Judul & deskripsi	Nama dan penjelasan singkat event (dari registry SSO).
Notif ke operasional (grup/staf)	Centang untuk mengaktifkan pengiriman event ini ke tujuan operasional.
Tujuan khusus event	Muncul saat operasional dicentang. Isi nomor/ID grup untuk menimpa tujuan default. Kosongkan untuk memakai tujuan default.
Kirim ke pelanggan (nomor pelanggan)	Hanya muncul pada event yang relevan dengan pelanggan. Centang untuk mengirim salinan notifikasi ke nomor pelanggan terkait.

Mengatur satu event

1. Temukan kartu event yang ingin diatur.
2. Centang Notif ke operasional (grup/staf) untuk mengaktifkannya.
3. (Opsional) Pada kolom tujuan khusus yang muncul, isi nomor 62xxx atau ID grup bila event ini perlu dikirim ke tujuan berbeda dari tujuan default. Kosongkan untuk memakai tujuan default.
4. (Opsional) Jika kartu menampilkan Kirim ke pelanggan (nomor pelanggan), centang bila salinan notifikasi juga perlu dikirim ke pelanggan.
5. Ulangi untuk event lain sesuai kebutuhan.
6. Klik Simpan.

Tips: Placeholder kolom tujuan khusus menampilkan tujuan default yang berlaku (default modul, atau default global jika default modul kosong). Jadi Anda selalu bisa melihat ke mana event akan dikirim meski kolomnya dibiarkan kosong.

---

Menyimpan

1. Setelah semua tujuan dan pilihan event diatur, klik tombol Simpan di kanan bawah.
2. Sistem menyimpan: tujuan default modul, status aktif per event, tujuan khusus per event, dan pilihan kirim-ke-pelanggan.
3. Notifikasi muncul singkat: "Pengaturan notifikasi disimpan" bila berhasil, atau pesan galat bila gagal.

Perhatian: Jika add-on WhatsApp dinonaktifkan setelah konfigurasi tersimpan, penyimpanan akan ditolak dan halaman kembali menampilkan peringatan add-on belum aktif. Pastikan add-on tetap aktif agar notifikasi berjalan.

---

Troubleshooting

Masalah	Solusi
Muncul "Add-on WhatsApp belum aktif"	Aktifkan add-on WhatsApp Gateway dan hubungkan nomor di Console Poztix → Pengaturan → WhatsApp.
"Belum ada event notifikasi terdaftar"	Belum ada event modul Retail yang terdaftar di registry SSO. Hubungi admin Poztix bila fitur yang Anda harapkan seharusnya tersedia.
Notifikasi tidak sampai ke grup	Pastikan ID grup WhatsApp benar dan nomor gateway sudah menjadi anggota grup. Cek juga koneksi WhatsApp di Console Poztix.
Notifikasi tidak sampai ke nomor staf	Pastikan format nomor 62xxx (bukan 08xxx), dan event sudah dicentang Notif ke operasional.
Pelanggan tidak menerima notifikasi	Opsi Kirim ke pelanggan hanya tersedia pada event yang relevan; pastikan tercentang dan data nomor pelanggan tersedia pada transaksi terkait.