Black Fox Group
EN

Panduan Paket Terpadu

Artikel Tutorial Smart Support Bot & Smart Support Manager

Kedua program bekerja sebagai satu kesatuan: Smart Support Manager mengelola katalog dan media di Windows via SSH, sedangkan Smart Support Bot menjawab pengguna Telegram secara langsung.

Halaman Produk Unduh Paket (ZIP) FAQ & Pemecahan Masalah Semua Tutorial

Cara Kerja Bot & Manager Bersama

  • Smart Support Manager (Windows): Berjalan di http://127.0.0.1:8766 untuk memindai dokumen, membuat katalog AI, memetakan foto, antrean SSH, dan instalasi server.
  • Smart Support Bot (Linux VPS): Berjalan di /opt/smart-support dan membaca katalog/media dari /opt/smart-support/products/<id>/.
  • Sinkron Tanpa Skrip Manual: Tidak perlu menyunting JSON server secara manual.

Urutan Pengaturan yang Disarankan

  • 1. Koneksi: Jalankan Start-Smart-Support-Manager.bat dan atur SSH & AI di Settings.
  • 2. Konten: Daftarkan produk di Products → terbitkan di Catalog → unggah & petakan gambar di Upload Queue, Media, Catalog photos.
  • 3. Deploy & Uji: Jalankan Install bot, uji /start dan Ask AI di Telegram, lalu pantau History.

1. Dashboard & Indikator Status Langsung

Saat Start-Smart-Support-Manager.bat dijalankan, buka http://127.0.0.1:8766:

  • Lencana Status Atas: Memantau koneksi Server (SSH), Expert + AI, dan Expert + bot + AI.
  • 4 Bahasa Panel: Ganti bahasa panel di kanan atas (فارسی, English, Русский, 中文).
  • Ringkasan & Panduan 5 Langkah: Jumlah produk aktif dan status antrean unggah.
Tips: Susun draf secara lokal lalu publikasikan begitu indikator Server berwarna hijau.
Gambar 1: Dashboard Smart Support Manager
Gambar 1: Dashboard Smart Support Manager

2. Menambahkan Produk & Sumber Dokumen (Products)

Di tab Products tentukan aplikasi apa saja yang dilayani bot:

  • ID & Nama Produk: Isi Product ID unik dan nama tampilan.
  • Format Sumber: Mendukung folder/file TXT, MD, JSON, CSV, HTML, PDF, DOCX, Go, Python.
  • Folder Gambar & Jalur Server: Jalur tetap server di /opt/smart-support/products/<id>.
  • Sakelar On / Off: Sembunyikan atau aktifkan produk di Telegram kapan saja.
Gambar 2: Tab Products
Gambar 2: Tab Products

3. Pembuatan Katalog AI, Review & Publikasi (Catalog)

Halaman Catalog mengubah dokumen mentah menjadi panduan terstruktur:

  • Buat Otomatis dengan AI: Hasilkan judul, ringkasan, dan daftar fitur.
  • Sunting Manual: Perbaiki teks atau tambah/hapus entri fitur sebelum tayang.
  • Publikasi: Tekan Use catalog in bot untuk mengaktifkan di Telegram atau Stop using catalog untuk menjeda.
Isolasi Produk: Ask AI hanya menggunakan katalog produk yang sedang dipilih.
Gambar 3: Tab Catalog
Gambar 3: Tab Catalog

4. Upload Queue, Media & Catalog photos

Kelola tangkapan layar fitur melalui tiga tab terhubung:

  • Upload Queue: Pilih gambar lalu klik Process waiting agar terkirim aman satu per satu lewat SSH.
  • Media: Pindai foto produk dan cocokkan dengan fitur katalog memakai AI.
  • Catalog photos: Tinjau foto terpetakan, klik untuk perbesar (Esc menutup), kembalikan ke Media, atau hapus.
Aturan Kirim: Hanya gambar yang sudah terpetakan di Catalog photos yang ikut terkirim di Telegram.
Gambar 4a: Upload Queue
Gambar 4a: Upload Queue
Gambar 4b: Tab Media
Gambar 4b: Tab Media
Gambar 4c: Catalog photos
Gambar 4c: Catalog photos

5. Instalasi Bot Satu Klik & Settings

Pasang bot dan layanan Expert di VPS tanpa mengetik file systemd:

  • Install bot: Masukkan host SSH, folder lokal Smart Support Bot, dan token dari @BotFather.
  • Polling vs Webhook: Pilih Polling — no webhook untuk pengaturan termudah atau Webhook di balik proxy HTTPS (8080).
  • 3 Langkah Deploy: Klik Install bot → Install Expert → Activate bot and Expert.
  • Settings & Stop all: Konfigurasi SSH, Bot AI, sinkronisasi Expert, dan hentikan tugas lewat Stop all.
Keamanan: Kata sandi SSH terenkripsi lokal; token bot tersimpan di file .env server.
Gambar 5a: Install bot
Gambar 5a: Install bot
Gambar 5b: Settings
Gambar 5b: Settings

6. Menggunakan Bot Telegram, History & Contact

Setelah aktif, pelanggan langsung dilayani di Telegram:

  • Alur Pengguna: /start / /lang untuk 4 bahasa, menu fitur bergambar, Ask AI per produk, /menu, dan /help.
  • Perintah Admin Telegram: /agents, /active_agent, /failover, /safety_status, dan /catalog_scan.
  • Log History: Mencatat waktu UTC, file, aksi, serta status ok / FAILED.
  • Tab Contact: Tautan GitHub resmi dan perintah instalasi cepat PowerShell.
Scan Ulang Cepat: Jalankan /catalog_scan di chat admin setelah perubahan manual di server.
Gambar 6a: Log History
Gambar 6a: Log History
Gambar 6b: Tab Contact
Gambar 6b: Tab Contact

7. Tanya Jawab & Pemecahan Masalah (FAQ)

Pertanyaan / MasalahKemungkinan PenyebabSolusi
Perubahan katalog belum muncul di TelegramHanya disimpan lokal atau sakelar produk Off.Pastikan status On di Products lalu tekan Use catalog in bot di Catalog.
Bot mengirim teks tanpa gambarGambar belum dipetakan di Catalog photos.Unggah lewat Upload Queue lalu petakan di Media / Catalog photos.
Webhook tidak menerima pesanReverse proxy HTTPS belum meneruskan ke port 8080.Ganti ke Polling — no webhook di Install bot atau periksa SSL proxy.
Lencana Server tetap merahHost, port SSH, user, atau kata sandi/kunci salah.Perbaiki di Settings, tekan Save lalu Connect.
Pembuatan AI atau Ask AI timeoutEndpoint OpenAI-compatible, model, atau API key tidak valid.Periksa pengaturan di Settings → Bot AI dan uji dengan Connect to AI.
Bisakah mengelola banyak produk sekaligus?Ya, tiap produk terisolasi berdasarkan ID.Buat Product ID terpisah untuk setiap aplikasi di Products.
Halaman Produk Lihat di GitHub Semua Tutorial