wiki: WA=notifikasi, Telegram=monitoring admin (+ daftar perintah)

2026-10-09 10:45:40 +07:00
1 parent ae03c365b5
commit 314dd905c6
@@ -14,7 +14,7 @@
 | [[Panduan Admin]] | Paket, pelanggan, tagihan, isolir, voucher hotspot, laporan |
 | [[Portal dan Peran]] | Admin, kasir, teknisi, kolektor, pelanggan (PWA) |
 | [[OLT dan TR-069]] | Multi-vendor OLT (SNMP/CLI), ONU, ACS/GenieACS |
-| [[WhatsApp dan Telegram]] | Bot, pengingat otomatis, struk, broadcast |
+| [[WhatsApp dan Telegram]] | WA = notifikasi keluar; Telegram = monitoring admin |
 | [[Pembayaran dan QRIS]] | QRIS statis, webhook, kode unik, gateway |
 | [[Keamanan]] | CSRF, rate limit, sesi, praktik aman |
 | [[Backup dan Update]] | Backup/restore DB, update aplikasi |
@@ -1,30 +1,61 @@
 # WhatsApp & Telegram

-## WhatsApp
+## Pembagian peran

-Dua pilihan gateway:
+- **WhatsApp = notifikasi KELUAR** (ke pelanggan, teknisi, dll). Tidak ada balasan/interaksi bot.
+- **Telegram = monitoring & kontrol ADMIN** (menu, perintah, dan alert sistem).

-1. **GoWA** (gateway eksternal) — set URL & secret serta webhook ke aplikasi.
+---
+
+## WhatsApp (notifikasi)
+
+Gateway (pilih di **Pengaturan → WhatsApp**):
+
+1. **GoWA** (gateway eksternal) — set URL & secret + webhook.
 2. **Baileys** (bawaan) — login via QR, sesi tersimpan di `baileys/`.

 Fitur:

- **Broadcast** massal dengan jeda/antrian (jeda/lanjut/stop).
+- **Broadcast** massal dengan jeda/antrian (jeda/lanjut/stop) + anti-ban Spintax.
 - **Pengingat tagihan** otomatis (template + jadwal cron).
- **Struk pelunasan**: periode bulan, nominal, sisa tunggakan.
- Tes notifikasi, reset sesi autentikasi bot.
- Perintah admin via WhatsApp (billing tools, MikroTik tools, dll).
+- **Struk pelunasan**: periode, nominal, sisa tunggakan.
+- **Notifikasi tiket** ke teknisi — otomatis saat tiket dibuat/ditugaskan. Pesannya menyertakan **💬 Chat Pelanggan** (`wa.me`) + **📍 Share Lokasi** (Google Maps).
+- Notifikasi pembayaran, tes kirim, reset sesi.

-> Template pesan diatur dari panel admin. Placeholder umum: `{{nama}}`, `{{periode}}`, `{{nominal}}`, `{{tunggakan_info}}`.
+> WhatsApp **hanya mengirim**. Bot tidak lagi membalas perintah (interaksi dipindah ke Telegram). Pesan masuk tetap **tercatat** di halaman **Live Chat** admin.

-## Telegram
+---

- Bot admin (opsional): aktifkan dan isi token + admin ID.
- Notifikasi & sinkronisasi dari panel.
+## Telegram (monitoring admin)
+
+Aktifkan di **Pengaturan**: `telegram_bot_token` + `telegram_admin_id`. Buka bot → `/menu`.
+
+| Perintah | Fungsi |
+|---|---|
+| `/menu` | Panel menu (tombol) |
+| `/sistem` | CPU / RAM / Disk / Load / Uptime + issues & warnings |
+| `/pendapatan` | Pendapatan **hari ini** & **bulan ini** + belum bayar |
+| `/tunggakan` | Total tunggakan + Top pelanggan |
+| `/tiket` | Statistik & daftar tiket open |
+| `/offline` · `/aktif` | User PPPoE **offline** / **online** |
+| `/olt` | Ringkasan ONU (total/online/offline/lemah) |
+| `/trafik` | Jumlah sesi PPPoE/Hotspot online |
+| `/ringkasan` | Ringkasan sistem |
+| `/lunas` · `/generate` · `/isolir` · `/buka` | Billing |
+| `/listonu` · `/info` · `/reboot` · `/gantissid` · `/gantisandi` | Perangkat (GenieACS) |
+| `/kick` · `/editpppoe` · `/cekpppoe` | MikroTik |
+| `/vcr` · `/vouch` | Voucher hotspot |
+| `/cari` | Cari pelanggan |
+
+Menu inline juga memuat tombol **Sistem · Tunggakan · Pendapatan · Tiket · OLT · Trafik** dan submenu **MikroTik Status** (Resource / Aktif / Offline / Secrets).
+
+> **Alert admin & monitoring** (staff, GenieACS, cron, auto-tunggakan) dikirim via **Telegram**; WhatsApp menjadi fallback bila Telegram mati.
+
+---

 ## Tips

- Pastikan nomor pengirim aktif & tidak diblokir WhatsApp.
+- Pastikan nomor pengirim WhatsApp aktif & tidak diblokir.
 - Gunakan jeda cukup pada broadcast agar tidak dianggap spam.

 > Selanjutnya: [[Pembayaran dan QRIS]].