From 314dd905c6c3e1ef1c64f0c2becb56c7c3c2fefb Mon Sep 17 00:00:00 2001 From: oxpoe Date: Fri, 9 Oct 2026 10:45:40 +0700 Subject: [PATCH] wiki: WA=notifikasi, Telegram=monitoring admin (+ daftar perintah) --- Home.md | 2 +- WhatsApp-dan-Telegram.md | 55 +++++++++++++++++++++++++++++++--------- 2 files changed, 44 insertions(+), 13 deletions(-) diff --git a/Home.md b/Home.md index e6feea6..2bbae0d 100644 --- a/Home.md +++ b/Home.md @@ -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 | diff --git a/WhatsApp-dan-Telegram.md b/WhatsApp-dan-Telegram.md index 4de0370..0dd0a6d 100644 --- a/WhatsApp-dan-Telegram.md +++ b/WhatsApp-dan-Telegram.md @@ -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]].