Black Fox Group
FA

Complete Coupled Suite Tutorial

Smart Support Bot & Smart Support Manager Tutorial Article

Both programs operate as one tightly integrated workflow: build AI catalogs and map screenshots in Smart Support Manager on Windows, deploy with one click over SSH, and support customers live through Smart Support Bot on Telegram.

Product Overview Download Suite (ZIP) FAQ & Troubleshooting Back to All Tutorials

How Bot & Manager Work Together

  • Smart Support Manager (Windows): Opens locally at http://127.0.0.1:8766 to parse docs/code, generate draft catalogs, organize screenshot mappings, queue SSH uploads, and install server services.
  • Smart Support Bot (Linux VPS): Runs continuously under /opt/smart-support and reads every published catalog.json and mapped media/ folder under /opt/smart-support/products/<id>/.
  • Seamless Handshake: Your support team updates knowledge safely in a visual browser UI while Telegram users always receive accurate, product-isolated guidance.

Recommended Setup Order

  • 1. Connect Infrastructure: Launch Start-Smart-Support-Manager.bat, then configure VPS SSH login and AI keys in Settings.
  • 2. Build & Map Product Content: Register product IDs & sources in Products, generate & publish in Catalog, and upload/map images via Upload Queue, Media, and Catalog photos.
  • 3. Deploy & Verify: Run the 3 deployment buttons on Install bot, test /start and Ask AI in Telegram, and monitor audit records in History.

1. Dashboard, Live Status Pills & Quick Overview (Dashboard)

Launching Start-Smart-Support-Manager.bat opens the local web panel at http://127.0.0.1:8766. The Dashboard shows real-time health across local Expert, AI, and VPS:

  • Top Connection Status Pills: Live badges for Server (VPS SSH connection), Expert + AI (Manager catalog AI engine), and Expert + bot + AI (full end-to-end bot sync).
  • 4-Language Web Switcher: Switch Manager's interface instantly between فارسی, English, Русский, and 中文 in the top-right bar.
  • Workspace Telemetry & Quick Flow: Review active product count, queued uploads, and the quick 5-step operational summary.
Working Offline vs Live: You can draft catalogs locally anytime, then publish straight to Telegram once the Server badge turns green.
Figure 1: Smart Support Manager Dashboard with Server, Expert + AI, and Bot status pills
Figure 1: Smart Support Manager Dashboard with Server, Expert + AI, and Bot status pills

2. Registering Products & Knowledge Sources (Products)

Use the Products tab to define each application or service supported by your Telegram bot:

  • Product Identity: Assign a URL-safe Product ID (for example vpn-installer) and the display label shown in Manager and Telegram menus.
  • Multi-Format Source Folders: Point Manager to local folders or files containing TXT, MD, JSON, CSV, HTML, PDF, DOCX, Go, or Python files.
  • Image Folder & Fixed Server Path: Select the local screenshots folder; remote storage is standardized at /opt/smart-support/products/<id>.
  • Active Switch (On / Off): Toggle a product Off to pause visibility in Telegram menus and AI without deleting its server files.
Figure 2: Products tab — configuring Product ID, docs/code folders, photo folder, and On/Off toggle
Figure 2: Products tab — configuring Product ID, docs/code folders, photo folder, and On/Off toggle

3. AI Catalog Generation, Human Review & Publishing (Catalog)

The Catalog page converts raw docs and source code into structured support entries ready for Telegram:

  • Auto-Build Drafts: Select a product and trigger AI generation to extract title, short summary, full overview, and structured feature entries.
  • Review & Edit Every Entry: Refine wording directly in form boxes or add/edit individual features (such as Settings or List) so the bot matches exact terminology.
  • Publish to Telegram (Use catalog in bot): Click Use catalog in bot to upload the reviewed catalog.json and make it active on the server, or Stop using catalog to unpublish.
Per-Product AI Isolation: Because each product builds its own catalog, Telegram Ask AI strictly answers within the active product scope.
Figure 3: Catalog tab — editing overview, features, and clicking Use catalog in bot
Figure 3: Catalog tab — editing overview, features, and clicking Use catalog in bot

4. Upload Queue, Media Scanning & Catalog Photos (Upload Queue / Media / Catalog photos)

Smart Support Bot automatically attaches relevant UI screenshots to Telegram guides. Manage media cleanly across three coordinated tabs:

  • Ordered Upload Queue: Select local screenshots (even outside the main product folder) and click Process waiting to upload them safely one by one over SSH.
  • Media Library & AI Matching: Inspect all scanned screenshots for the selected product and run AI analysis to suggest matching catalog features.
  • Catalog photos Gallery: Review mapped photos per catalog feature, click thumbnails to open full-size lightbox previews (Esc closes), adjust mappings, return photos to Media, or remove unused files.
Media Rule: Only confirmed, feature-mapped images listed under Catalog photos are sent automatically alongside Telegram answers.
Figure 4a: Upload Queue — queuing local images and tracking SSH transfer progress
Figure 4a: Upload Queue — queuing local images and tracking SSH transfer progress
Figure 4b: Media tab — managing raw product images and AI feature mapping
Figure 4b: Media tab — managing raw product images and AI feature mapping
Figure 4c: Catalog photos tab — reviewing linked feature screenshots and lightbox previews
Figure 4c: Catalog photos tab — reviewing linked feature screenshots and lightbox previews

5. One-Click Bot Installation & AI/Server Settings (Install bot & Settings)

Deploy both server services—Smart Support Bot and the remote Expert coordinator—without manual SSH scripts:

  • Install bot Server & Token Setup: Enter VPS host, SSH port (22), username/password or SSH key, local Smart Support Bot folder, and Telegram Bot Token from @BotFather.
  • Choose Polling or Webhook: Keep Polling — no webhook for instant domain-free operation, or enter your HTTPS public base URL and internal webhook port (8080) behind a reverse proxy.
  • 3-Step Server Deployment: Click 1. Install bot, then 2. Install Expert, then 3. Activate bot and Expert to start both systemd services.
  • Settings & Stop all: Save SSH credentials, configure Bot AI (API endpoint, model, API key), sync via Connect Expert to bot and AI, or halt active Manager jobs anytime using Stop all.
Credential Security: SSH passwords stay encrypted locally and server tokens are written to protected .env files.
Figure 5a: Install bot tab — SSH setup, Polling vs Webhook selector, and 3-step deployment
Figure 5a: Install bot tab — SSH setup, Polling vs Webhook selector, and 3-step deployment
Figure 5b: Settings tab — server connection, Bot AI endpoint/model, Expert sync, and Stop all
Figure 5b: Settings tab — server connection, Bot AI endpoint/model, Expert sync, and Stop all

6. Using the Telegram Bot, Audit History & Contact (Telegram Bot, History & Contact)

Once activated, end-users interact seamlessly inside Telegram while admins maintain full visibility from both Telegram and Manager:

  • Telegram User Flow: Sending /start or /lang presents 4 languages (فارسی, English, Русский, 中文). Users browse active products via reply keyboards, open illustrated feature guides, or tap Ask AI for product-scoped answers. /menu and /help work anytime.
  • Telegram Admin Commands: Authorized admins can run /agents, /active_agent, /failover, /safety_status, and /catalog_scan directly in private admin chat, or manage agents and forwarding inside Admin Settings.
  • Manager History Log: Tracks timestamps, modified files, actions (save_catalog_text, publish_catalog_to_bot, connect_server), target VPS, and ok / FAILED status.
  • Manager Contact Page: Houses official GitHub links, website URL, and the copy-ready one-command Windows PowerShell installer.
Instant Catalog Refresh: If you update server files manually, run /catalog_scan in admin Telegram chat or click Use catalog in bot again in Manager.
Figure 6a: History tab — full timestamped audit trail of catalog edits and deployments
Figure 6a: History tab — full timestamped audit trail of catalog edits and deployments
Figure 6b: Contact tab — official repository links and one-command Windows installer
Figure 6b: Contact tab — official repository links and one-command Windows installer

7. Frequently Asked Questions & Troubleshooting (FAQ)

Question or SymptomLikely CauseResolution
Edited catalog is not appearing in TelegramChanges were saved locally without publishing or the product toggle is Off.Confirm product is On in Products, then click Use catalog in bot inside Catalog.
Bot replies with text but omits screenshotsImages remain unmapped in Media or failed to reach Catalog photos.Upload via Upload Queue and map each image to a feature in Media / Catalog photos.
Webhook mode stops receiving Telegram updatesHTTPS domain reverse proxy is not forwarding traffic to internal port 8080.Switch to Polling — no webhook in Install bot or verify SSL + proxy forwarding.
Server status pill remains redIncorrect host IP, SSH port, username, password, or SSH private key path.Update credentials in Settings → Server connection, click Save, then Connect.
Catalog generation or Ask AI times outInvalid OpenAI-compatible endpoint, model name, API key, or network block.Verify API endpoint, model, and key in Settings and test with Connect to AI.
Can one bot support multiple unrelated products?Yes — every product runs in an isolated folder and AI scope.Create a separate Product ID per app in Products; knowledge and screenshots never cross over.
Product Overview View on GitHub Back to All Tutorials