KI-Kundensupport Telegram Bot — Vollständiger Quellcode

Ein vollständiger, produktionsbereiter Kundensupport-Bot für Telegram, der einen KI-Assistenten, eine leichte Wissensbase und die Weitergabe an einen menschlichen Operator in einer sauberen Codebasis vereint. Entwickelt für Agenturen und Freiberufler, die Support-Bots für Kunden bereitstellen, oder für jeden, der seinen eigenen Telegram-Support-Kanal automatisieren möchte, ohne die Infrastruktur von Grund auf neu zu bauen.

Funktionsweise:
Telegram → KI → Wissensbasis → PostgreSQL → Admin-Panel (im Chat)

Hauptmerkmale:

• 🧠 KI-gestützte Antworten über jede OpenAI-kompatible API (OpenAI, OpenRouter, Groq oder ein eigengehostetes Modell) — Anbieter wechseln durch Ändern einer URL

• 📚 Integrierte FAQ / Wissensbasis mit Keyword-Suche, die KI-Antworten an Ihre echten Richtlinien bindet, kein Vektor-DB erforderlich

• 🙋 One-Command-Operatoren-Übergabe — ein Kunde tippt /operator, das Gespräch landet in der Telegram-Gruppe Ihres Support-Teams, und Admins antworten mit einer nativen Telegram-“Antwort” — kein zusätzliches Tooling

• 🗂 Vollständiger Gesprächsverlauf — Jede Nachricht (Benutzer, KI und Operator) wird in PostgreSQL protokolliert

• 🛠 Admin-Befehle direkt in Telegram — Statistiken, FAQ-Verwaltung, Broadcast-Nachrichten, pro Benutzer Verlauf und mehr

• ⚙️ Live-bearbeitbarer System-Prompt — Ändern Sie Tonfall, Regeln oder Geschäftskontext der KI mit /setprompt, kein erneutes Deployment nötig

• 📊 Integrierte Statistik — Benutzer, Nachrichten, neue Registrierungen, offene Operator-Anfragen

• 🐳 Docker & Docker-Compose — der gesamte Stack (Bot + PostgreSQL) startet mit einem einzigen Befehl

• 🔐 .env.example mit jeder Variable dokumentiert, plus eine detaillierte README und eine Schritt-für-Schritt-Einrichtung

Technologie-Stack: Python 3.12, aiogram 3 (async), SQLAlchemy 2.0 + asyncpg, PostgreSQL 16, Docker.

Enthaltene Inhalte:

• Voller, kommentierter Quellcode (33 Dateien, saubere modulare Struktur: Handler, Datenbankmodelle, KI-Ebene, Hilfsprogramme)

• Dockerfile + docker-compose.yml für sofortige Bereitstellung

• .env.example mit allen Konfigurationsvariablen

• Beispiel-FAQ-Datensatz + Seed-Skript

• Ausführliche README und ein vollständiger PDF-Einrichtungs-/Nutzungsleitfaden

Perfekter Einstieg für: E-Commerce-Support-Bots, SaaS-Hilfe desks, interne IT-Support-Bots oder als White-Label-Basis, die Sie an Ihre eigenen Kunden weiterverkaufen.