Messaging & Notifikasi

Halaman Messaging & Notifikasi memungkinkan Anda mengonfigurasi integrasi Telegram Bot untuk menerima notifikasi real-time tentang aktivitas penting di toko Anda. Dengan mengaktifkan fitur ini, Anda akan mendapat pemberitahuan otomatis saat terjadi order baru, stok rendah, shift ditutup, dan event penting lainnya.

Path menu: Settings → Messaging (/settings/messaging)

---

Jenis Notifikasi

Berikut adalah notifikasi yang dapat dikonfigurasi untuk dikirim melalui Telegram:

Notifikasi	Keterangan
Order Baru	Dikirim setiap kali ada transaksi penjualan baru yang selesai diproses di POS. Mencakup informasi nomor order, toko, total, dan metode pembayaran.
Stok Rendah	Dikirim ketika stok suatu produk mencapai atau berada di bawah batas minimum yang telah ditentukan. Mencakup nama produk, stok saat ini, dan stok minimum.
Shift Ditutup	Dikirim ketika kasir menutup sesi/shift. Mencakup ringkasan shift: kasir, toko, total penjualan, jumlah transaksi, dan selisih kas.
Refund Diproses	Dikirim ketika refund berhasil diproses. Mencakup nomor order asal, jumlah refund, dan alasan.
Sync Gagal	Dikirim ketika sinkronisasi ke modul Accounting gagal. Mencakup nomor order dan pesan error.

---

Setup Telegram Bot

Untuk menerima notifikasi melalui Telegram, Anda perlu membuat Telegram Bot dan mengonfigurasi koneksinya di sistem. Ikuti langkah-langkah berikut:

Langkah 1: Buat Bot di Telegram

1. Buka aplikasi Telegram dan cari @BotFather.
2. Kirim perintah /newbot ke BotFather.
3. Ikuti instruksi untuk memberikan nama dan username pada bot Anda. Contoh:
   • Nama: Notifikasi Toko Saya
   • Username: tokosaya_poztix_bot
4. BotFather akan memberikan Bot Token. Simpan token ini dengan aman -- Anda akan memerlukannya di langkah berikutnya.

Contoh format Bot Token: 1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ

Langkah 2: Dapatkan Chat ID

Chat ID menentukan ke mana bot akan mengirim notifikasi. Anda bisa mengirim ke chat pribadi atau grup:

Untuk Chat Pribadi:

1. Buka bot yang baru dibuat di Telegram dan klik Start.
2. Kirim pesan apa saja ke bot (misalnya "halo").
3. Buka browser dan akses URL berikut (ganti BOT_TOKEN dengan token Anda):

   https://api.telegram.org/botBOT_TOKEN/getUpdates

4. Cari nilai "chat":{"id":...} pada respons JSON. Angka tersebut adalah Chat ID Anda.

Untuk Grup Telegram:

1. Buat grup baru atau gunakan grup yang sudah ada.
2. Tambahkan bot Anda ke grup.
3. Kirim pesan apa saja di grup.
4. Akses URL getUpdates seperti di atas dan cari Chat ID grup (biasanya berupa angka negatif, misalnya -1001234567890).

Langkah 3: Konfigurasi di Poztix

1. Buka halaman Settings → Messaging.
2. Masukkan Bot Token yang diperoleh dari BotFather.
3. Masukkan Chat ID tujuan notifikasi.
4. Klik tombol Test Koneksi untuk memverifikasi bahwa bot dapat mengirim pesan. Jika berhasil, Anda akan menerima pesan test di Telegram.
5. Klik Simpan untuk menyimpan konfigurasi.

Test Koneksi Penting

Selalu klik Test Koneksi sebelum menyimpan konfigurasi. Ini memastikan Bot Token dan Chat ID sudah benar. Jika test gagal, periksa kembali token dan chat ID yang dimasukkan.

---

Mengaktifkan / Menonaktifkan Notifikasi

Setelah konfigurasi bot selesai, Anda dapat memilih jenis notifikasi mana yang ingin diterima:

1. Pada halaman Messaging, di bagian Pengaturan Notifikasi, Anda akan melihat daftar semua jenis notifikasi.
2. Aktifkan atau nonaktifkan setiap jenis notifikasi menggunakan toggle switch.
3. Klik Simpan untuk menerapkan perubahan.

Notifikasi	Default
Order Baru	Aktif
Stok Rendah	Aktif
Shift Ditutup	Aktif
Refund Diproses	Aktif
Sync Gagal	Aktif

Hindari Notifikasi Berlebihan

Jika toko Anda memiliki volume transaksi yang sangat tinggi, pertimbangkan untuk menonaktifkan notifikasi "Order Baru" agar tidak membanjiri chat Telegram. Fokuskan pada notifikasi yang lebih kritis seperti Stok Rendah, Shift Ditutup, dan Sync Gagal.

---

Notifikasi ke Grup

Untuk toko yang memiliki beberapa anggota tim, disarankan mengirim notifikasi ke grup Telegram agar semua anggota tim mendapat informasi yang sama:

1. Buat grup Telegram khusus untuk notifikasi operasional toko (misalnya "Notif Toko A").
2. Tambahkan bot dan semua anggota tim yang perlu menerima notifikasi.
3. Gunakan Chat ID grup pada konfigurasi Messaging.

Keuntungan menggunakan grup:

• Seluruh tim mendapat notifikasi yang sama.
• Anggota tim bisa langsung berdiskusi di grup saat menerima notifikasi.
• Riwayat notifikasi tersimpan di grup dan bisa dilihat kapan saja.

---

Troubleshooting

Masalah	Solusi
Test koneksi gagal	Pastikan Bot Token yang dimasukkan benar dan lengkap. Periksa koneksi internet server.
Notifikasi tidak terkirim	Pastikan bot sudah di-start (klik Start di Telegram) dan Chat ID benar. Untuk grup, pastikan bot sudah ditambahkan sebagai anggota.
Notifikasi terlambat	Notifikasi dikirim secara asynchronous. Keterlambatan kecil (1-2 detik) adalah normal. Jika keterlambatan signifikan, periksa koneksi internet server.
Bot diblokir oleh Telegram	Jika terlalu banyak pesan dikirim dalam waktu singkat, Telegram mungkin membatasi bot. Kurangi jenis notifikasi yang aktif.
Chat ID berubah	Chat ID pribadi bersifat tetap. Namun jika grup dihapus dan dibuat ulang, Chat ID akan berubah. Perbarui Chat ID di konfigurasi.

Backup Konfigurasi

Catat Bot Token dan Chat ID di tempat yang aman. Jika konfigurasi sistem perlu di-reset, Anda dapat mengatur ulang dengan cepat tanpa harus membuat bot baru.