Black Fox Group
EN

Verbundene Suite-Anleitung

Smart Support Bot & Smart Support Manager Anleitung

Beide Programme arbeiten zusammen: Unter Windows erstellt Smart Support Manager Kataloge und Medien-Zuordnungen per SSH, während Smart Support Bot auf Linux Kunden in Telegram betreut.

Produktübersicht Suite herunterladen (ZIP) FAQ & Fehlerbehebung Alle Tutorials

Zusammenspiel beider Komponenten

  • Smart Support Manager (Windows): Läuft auf http://127.0.0.1:8766 für Dokumentscan, KI-Kataloge, Foto-Mapping, Upload-Queue und Server-Setup.
  • Smart Support Bot (Linux VPS): Läuft unter /opt/smart-support und nutzt alle Daten aus /opt/smart-support/products/<id>/.
  • Nahtloser Betrieb: Keine manuelle JSON-Bearbeitung auf dem Server nötig.

Empfohlene Reihenfolge

  • 1. Verbindung herstellen: Start-Smart-Support-Manager.bat starten und SSH + KI in Settings konfigurieren.
  • 2. Inhalte aufbauen: Produkt in Products anlegen → in Catalog freigeben → Bilder via Upload Queue, Media & Catalog photos verknüpfen.
  • 3. Starten & prüfen: Über Install bot deployen, in Telegram /start + Ask AI testen und in History prüfen.

1. Dashboard & Live-Statusanzeigen

Nach Start von Start-Smart-Support-Manager.bat öffnet sich http://127.0.0.1:8766:

  • Status-Pills oben: Server (SSH), Expert + AI und Expert + bot + AI zeigen den Live-Zustand.
  • 4 UI-Sprachen: Oben rechts zwischen Deutsch/English, Persisch, Russisch und Chinesisch wechseln.
  • Übersicht: Aktive Produkte, Warteschlange und 5-Schritte-Leitfaden.
Tipp: Offline vorbereiten und veröffentlichen, sobald Server grün leuchtet.
Abb. 1: Dashboard von Smart Support Manager
Abb. 1: Dashboard von Smart Support Manager

2. Produkte & Quellen anlegen (Products)

Im Tab Products definieren Sie jedes unterstützte Produkt:

  • Produkt-ID & Name: Eindeutige Product ID und Anzeigenamen festlegen.
  • Quellformate: Verzeichnisse oder Dateien mit TXT, MD, JSON, CSV, HTML, PDF, DOCX, Go, Python.
  • Bilder & Serverpfad: Fester Pfad /opt/smart-support/products/<id> auf dem VPS.
  • On / Off-Schalter: Produkt jederzeit im Bot pausieren ohne Datenverlust.
Abb. 2: Products-Ansicht
Abb. 2: Products-Ansicht

3. KI-Katalog generieren, prüfen & veröffentlichen (Catalog)

Der Tab Catalog verwandelt Quelldokumente in strukturierte Support-Texte:

  • KI-Generierung: Automatischer Entwurf für Titel, Zusammenfassungen und Funktionsliste.
  • Manuelle Feinarbeit: Texte und Einträge direkt bearbeiten, ergänzen oder löschen.
  • Freigabe: Mit Use catalog in bot veröffentlichen oder mit Stop using catalog deaktivieren.
Saubere Trennung: Ask AI nutzt ausschließlich den Katalog des aktiven Produkts.
Abb. 3: Catalog-Editor & Freigabe
Abb. 3: Catalog-Editor & Freigabe

4. Upload-Queue, Media & Catalog photos

Passende Screenshots werden über drei koordinierte Reiter verwaltet:

  • Upload Queue: Bilder auswählen und mit Process waiting zuverlässig per SSH hochladen.
  • Media: Gescannte Produktbilder prüfen und per KI Funktionen zuordnen.
  • Catalog photos: Verknüpfte Bilder sichten, per Klick vergrößern (Esc schließt), zurückschieben oder löschen.
Senderegel: Nur verknüpfte Bilder in Catalog photos erscheinen automatisch in Telegram.
Abb. 4a: Upload Queue
Abb. 4a: Upload Queue
Abb. 4b: Media-Übersicht
Abb. 4b: Media-Übersicht
Abb. 4c: Catalog photos
Abb. 4c: Catalog photos

5. 1-Klick-Installation & Einstellungen (Install bot / Settings)

Beide Server-Dienste lassen sich direkt aus dem Panel installieren:

  • Install bot: SSH-Zugang, lokalen Smart Support Bot-Ordner und @BotFather-Token angeben.
  • Polling oder Webhook: Polling — no webhook ohne Domain oder Webhook hinter HTTPS-Proxy (Port 8080).
  • 3 Installationsschritte: Install bot → Install Expert → Activate bot and Expert.
  • Settings & Stop all: SSH, Bot AI (Endpoint, Modell, Key), Expert-Sync sowie Not-Stopp Stop all.
Sicherheit: SSH-Passwörter bleiben lokal verschlüsselt; Bot-Tokens liegen geschützt in .env.
Abb. 5a: Install bot
Abb. 5a: Install bot
Abb. 5b: Settings
Abb. 5b: Settings

6. Telegram-Bot, History-Protokoll & Contact

Nach Aktivierung steht der Bot Nutzern und Admins sofort zur Verfügung:

  • Nutzerfluss: /start / /lang für 4 Sprachen, bebilderte Produktmenüs, produktbezogenes Ask AI, /menu und /help.
  • Admin-Befehle: /agents, /active_agent, /failover, /safety_status und /catalog_scan im privaten Admin-Chat.
  • History-Log: Zeitstempel, Datei, Aktion und Status ok / FAILED für alle Vorgänge.
  • Contact-Reiter: GitHub-Repo, Website und PowerShell-Einzeiler.
Sofort-Rescan: Nach manuellen Server-Änderungen /catalog_scan ausführen.
Abb. 6a: History-Protokoll
Abb. 6a: History-Protokoll
Abb. 6b: Contact-Seite
Abb. 6b: Contact-Seite

7. Häufige Fragen & Fehlerbehebung (FAQ)

Frage / ProblemMögliche UrsacheLösung
Katalogänderung fehlt im BotNur lokal gespeichert oder Produkt steht auf Off.Unter Products auf On stellen und in Catalog auf Use catalog in bot klicken.
Bot sendet Text ohne BilderBilder wurden noch keiner Katalogfunktion zugeordnet.Über Upload Queue hochladen und in Media / Catalog photos verknüpfen.
Webhook erhält keine UpdatesHTTPS-Proxy leitet nicht an internen Port 8080 weiter.In Install bot auf Polling — no webhook wechseln oder SSL-Proxy prüfen.
Server-Status bleibt rotSSH-Host, Port, Benutzer, Passwort oder Key-Pfad fehlerhaft.In Settings korrigieren, Save und Connect klicken.
KI-Antwort oder Build hängtUngültiger Endpoint, Modellname oder API-Schlüssel.Angaben unter Settings → Bot AI mit Connect to AI prüfen.
Mehrere Produkte gleichzeitig?Ja, jedes Produkt ist nach ID vollständig isoliert.Für jedes Produkt eine eigene Product ID unter Products anlegen.
Produktübersicht Auf GitHub ansehen Alle Tutorials