Grundkonzepte

Das Verständnis dieser Bausteine wird die Nutzung jeder weiteren Funktion in FRENZY.BOT erleichtern. Diese Seite erklärt in einfachem Deutsch, wie das System funktioniert.

Wie FRENZY.BOT arbeitet

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│ Ihre Daten  │ ──→ │ Indexierung  │ ──→ │   Qdrant    │
│Dateien, URLs│     │ (Embeddings) │     │ (Vektor-DB) │
│    FAQs     │     └──────────────┘     └──────┬──────┘
└─────────────┘                                 │
                                                │ abrufen
┌─────────────┐     ┌──────────────┐     ┌──────┴──────┐
│  Benutzer-  │ ──→ │  FRENZY.BOT  │ ──→ │  KI-Modell  │
│    Frage    │     │ (RAG-Engine) │ ←── │(via OpenRouter)│
└─────────────┘     └──────┬───────┘     └─────────────┘
                           │
                    ┌──────┴──────┐
                    │   Antwort   │
                    │+ Lead-Daten │
                    │+ Analytics  │
                    └─────────────┘

Sie laden Ihre Daten hoch — Dateien, Website-URLs und FAQ-Paare fließen in die Knowledge Base.
Das System indexiert sie — Inhalte werden in numerische Embeddings umgewandelt und in Qdrant (Vektor-Datenbank) gespeichert, damit sie nach Bedeutung und nicht nur nach Schlüsselwörtern durchsucht werden können.
Ein Benutzer stellt eine Frage — über das Widget, WhatsApp, Telegram oder einen anderen verbundenen Kanal.
FRENZY.BOT ruft relevante Inhalte ab — das System findet mittels semantischer Suche die passendsten Teile Ihrer Wissensdatenbank.
Das KI-Modell generiert eine Antwort — die abgerufenen Inhalte + die Frage des Benutzers werden über OpenRouter an das KI-Modell (Claude, GPT, Gemini etc.) gesendet.
Alles wird nachverfolgt — die Konversation, Antwortzeit, Token-Nutzung und alle erfassten Lead-Daten werden für Berichte gespeichert.

Bot

Ihr Bot ist der KI-Assistent, den Sie erstellen. Jeder Bot hat seine eigenen:

Knowledge Base (Wissensdatenbank) — Die Dokumente, URLs und FAQs, aus denen er lernt.
Einstellungen — KI-Modell, System-Prompt, Temperatur, Branding, Widget-Konfiguration.
Konversationen — Chat-Verlauf mit Benutzern.
Leads — Kontakte, die während der Gespräche erfasst wurden.
Analytics — Nutzungsmetriken und Funnel-Daten.
Widget — Ein eigener Embed-Code mit eindeutiger data-bot-id.

In einem Multi-Bot-Setup können Sie mehrere Bots über eine einzige Installation betreiben – jeder komplett isoliert von den anderen.

Verwaltung unter: Einstellungen, Knowledge Base, Embed und dem Workspace-Dropdown im Header.

Knowledge Base

Die Knowledge Base ist die Bibliothek, die Ihr Bot liest, bevor er eine Frage beantwortet. Sie macht Ihren Bot spezifisch für Ihr Unternehmen, anstatt eine generische KI zu sein.

Drei Datenquellen:

Quelle	Bestens geeignet für	Indexierungsgeschwindigkeit
Dateien (PDF, DOCX, TXT, CSV etc.)	Interne Dokumente, Richtlinien, Produktspezifikationen	Minuten
URLs (jede öffentliche Webseite)	Website-Inhalte, Hilfeartikel, Blog-Posts	Minuten
FAQs (manuelle F&A-Paare)	Kritische Antworten, die Sie exakt steuern möchten	Sofort

Kernprinzip: Wenn ein Thema nicht in der Knowledge Base enthalten ist, antwortet der Bot möglicherweise generisch oder lehnt die Antwort ab. Je mehr relevante Inhalte Sie hinzufügen, desto besser arbeitet der Bot.

Den vollständigen Leitfaden finden Sie unter Knowledge Base.

Kanäle (Channels)

Kanäle sind die Orte, an denen Ihre Benutzer mit dem Bot interagieren.

Kanal	Typ	Einrichtung
Website-Widget	Primär	Embed-Skript auf Ihrer Seite
WhatsApp	Messaging	WAHA Docker + QR-Code Kopplung
Telegram	Messaging	Bot-Token von @BotFather
Discord	Community	Bot-Token vom Developer Portal
Instagram	Social	Page Access Token
Messenger	Social	Facebook-Seiten-Integration
Slack	Workplace	App-Token
Webhook	Benutzerdefiniert	Jeder HTTP-Endpunkt

Jeder Kanal kann seinen eigenen Antwortstil haben — die KI passt Tonfall und Antwortlänge an die jeweilige Plattform an (z. B. kürzer bei WhatsApp, ausführlicher im Website-Widget).

Details finden Sie unter Kanäle.

Sessions & Konversationen

Eine Session ist ein vollständiges Gespräch zwischen einem Benutzer und Ihrem Bot. Jede Session verfolgt:

Nachrichten — Jede Frage und Antwort in der Konversation.
Token — Wie viele KI-Token verbraucht wurden (beeinflusst die Kosten).
Dauer — Wie lange das Gespräch dauerte.
Quelle — Über welchen Kanal die Konversation stattfand.
Lead-Daten — Alle Kontaktinformationen, die während des Chats erfasst wurden.

Sessions sind die Grundlage für Analysen, Qualitätsprüfungen und Lead-Erfassung. Überprüfen Sie diese unter Konversationen.

Leads & Integrationen

Ein Lead ist ein während eines Chats erfasster Kontakt — Name, E-Mail, Telefon, Firma und alle von Ihnen konfigurierten benutzerdefinierten Felder.

Leads fließen durch eine Pipeline:

Neu → Kontaktiert → Qualifiziert → Konvertiert (oder Verloren)

Integrationen leiten Leads automatisch an Ihre externen Tools weiter:

E-Mail — SMTP-Benachrichtigungen an Ihr Team.
Webhook — JSON-Payloads an Ihre eigenen Endpunkte.
Google Sheets — Zeilen für ein schlankes CRM anhängen.
MailChimp — Kontakte zu E-Mail-Marketing-Listen hinzufügen.

Details finden Sie unter Lead-Management und Integrationen.

Module

Module sind optionale Funktionen, die Sie aktivieren oder deaktivieren können, ohne das Kernsystem zu beeinträchtigen:

Modul	Funktion
Live-Webzugriff (Tavily)	Erlaubt dem Bot die Suche im Live-Web, wenn interne Daten nicht ausreichen
Human Handoff	Übergibt Gespräche an menschliche Agenten
Text-to-Speech	Wandelt KI-Antworten in Audio-Wiedergabe um
Terminbuchung	In-Chat-Terminplanung via Calendly
Lead-Formular	Erfasst Kontaktinformationen während des Gesprächs
WhatsApp	Automatisierte Nachrichtenübermittlung via WAHA

Durchsuchen und verwalten Sie Module unter Module.

Kurzer Selbstcheck

Nutzen Sie diese Checkliste, um sicherzustellen, dass Ihr Bot voll einsatzbereit ist:

[ ] Knowledge Base befüllt — Mindestens eine Datei, URL oder FAQ hinzugefügt und Status steht auf Live.
[ ] OpenRouter verbunden — Die KI-Engine zeigt einen verbundenen Anbieter und ein ausgewähltes Modell an.
[ ] Widget bereitgestellt — Das Embed-Skript ist auf Ihrer Website und die Chat-Blase erscheint.
[ ] Integrationen aktiviert — Leads werden an Ihr CRM, E-Mail oder Webhook weitergeleitet.

Wenn alle vier Punkte zutreffen, ist Ihr System voll funktionsfähig und bereit für den Live-Betrieb.