Stella Chatbot Plugin Dokumentation

Stella Chatbot ist ein schlüsselwortbasierter Chatbot-Plugin für WordPress, das Besucherfragen automatisch mithilfe Ihrer eigenen Q&A-Wissensdatenbank beantwortet – für das Kernerlebnis ist kein Drittanbieter-Service erforderlich. Dieser Leitfaden deckt sowohl das kostenlose Plugin als auch das eigenständige Pro-Plugin ab, mit detaillierten Erklärungen auf Feldebene und Funktionsbeschreibungen. 1) Installation Kostenlose Version Sie können das kostenlose Plugin mit einer der folgenden Methoden installieren: Methode 1: Installation über das WordPress-Plugin-Verzeichnis Gehen Sie im WordPress-Adminbereich zu Plugins > Installieren. Suchen Sie nach Stella Chatbot. Klicken Sie auf Jetzt installieren und dann auf Aktivieren. ODER Methode 2: ZIP-Datei manuell hochladen Gehen Sie zu Plugins > Installieren > Plugin hochladen. Laden Sie Ihre Stella Chatbot ZIP-Datei hoch. Klicken Sie auf Jetzt installieren und dann auf Aktivieren. Nach der Aktivierung Ein Menüpunkt Stella Chatbot erscheint in Ihrer WordPress-Admin-Seitenleiste. Gehen Sie zu Stella Chatbot > Settings (Einstellungen), um den Chatbot zu konfigurieren. Gehen Sie zu Stella Chatbot > Q&A, um Ihre ersten schlüsselwortgesteuerten Antworten hinzuzufügen. Pro-Version (Eigenständig) Gehen Sie zu Plugins > Installieren > Plugin hochladen. Laden Sie Ihre Stella Chatbot Pro ZIP-Datei hoch. Klicken Sie auf Jetzt installieren und dann auf Aktivieren. Die Pro-Version läuft als eigenständiges Plugin. Sie benötigen das kostenlose Plugin nicht zusätzlich – installieren Sie immer nur eine Version gleichzeitig. 2) Schnellstart Schnellstart (Free) Gehen Sie zu Stella Chatbot > Settings. Geben Sie einen Chatbot Name ein (z. B. "Stella"). Laden Sie ein Avatar Image für den Chat-Startbutton hoch. Aktivieren Sie Display chatbot on frontend, um ihn für Besucher sichtbar zu machen. Legen Sie eine Welcome Message (Willkommensnachricht) fest, die beim Öffnen des Chats angezeigt wird. Gehen Sie zu Stella Chatbot > Q&A und fügen Sie Ihre erste Antwort hinzu. Klicken Sie auf Save Changes (Änderungen speichern). Ihr Chatbot ist nun live. Schnellstart (Pro) Gehen Sie zu Stella Chatbot Pro > Settings. Konfigurieren Sie die Einstellungen für Allgemein, Branding, Chat-Erlebnis und Erscheinungsbild. Aktivieren Sie optional den AI Fallback und geben Sie Ihren API-Schlüssel ein. Gehen Sie zu Stella Chatbot Pro > Q&A und fügen Sie Einträge hinzu oder importieren Sie diese aus einer Datei. Aktivieren Sie Lead Capture (Lead-Erfassung) und Human Handoff (Übergabe an Menschen) nach Bedarf. Speichern und überprüfen Sie den Chatbot auf Ihrem Frontend. 3) Funktionen des kostenlosen Plugins (Detailliert) Schlüsselwortbasierte Q&A: Erstellen Sie eine Wissensdatenbank mit bis zu 49 Q&A-Einträgen. Wenn die Nachricht eines Besuchers mit einem Schlüsselwort übereinstimmt, gibt der Chatbot automatisch die konfigurierte Antwort zurück. Chatbot-Name: Legen Sie einen benutzerdefinierten Namen fest, der im Chat-Header angezeigt wird (z. B. "Stella", "Support Bot"). Avatar-Bild: Laden Sie ein benutzerdefiniertes Bild für den Chat-Startbutton und den Header im Chat hoch. Unterstützt die Formen Rund, Quadratisch und Abgerundet. Widget-Sichtbarkeit: Schalten Sie den Chatbot im Frontend ein oder aus, ohne das Plugin zu deaktivieren. Willkommensnachricht: Konfigurieren Sie eine Begrüßung, die angezeigt wird, wenn Besucher das Chat-Fenster öffnen. Kategorie-Navigation: Organisieren Sie Q&A-Einträge in Kategorien. Zeigen Sie Kategorie-Vorschlagsbuttons im Willkommensbildschirm an und blenden Sie optional nach jeder Antwort einen Link "Zurück zu den Kategorien" ein. Antwort bei fehlendem Treffer: Legen Sie eine Fallback-Nachricht fest, wenn kein passendes Schlüsselwort für die Eingabe gefunden wird. KI-Vorschläge: Zeigen Sie bis zu 3 verwandte Q&A-Vorschläge unter der Fallback-Nachricht an, um Besucher zu leiten. Datenverwaltung: Option zum Löschen aller Chatbot-Daten aus der Datenbank bei der Deinstallation des Plugins. 04) Funktionen des Pro-Plugins (Detailliert) Unbegrenzte Q&A-Einträge: Keine Obergrenze für die Anzahl der FAQ-Einträge – bauen Sie eine so große Wissensdatenbank auf, wie Sie benötigen. Flexibler Datei-Import: Massenimport von Q&A-Einträgen aus CSV-, TXT- oder DOCX-Dateien. Unterstützt die automatische Erkennung von Trennzeichen und verschiedene Dateistrukturen. KI-Fallback: Wenn kein FAQ-Treffer gefunden wird, wird automatisch eine Anfrage an einen KI-Anbieter (OpenAI, Anthropic Claude, Google Gemini, Groq oder OpenRouter) gesendet, um eine Antwort zu generieren. KI-Modell-Tester: Testen Sie Ihre KI-Anbieter-Konfiguration direkt auf der Einstellungsseite, bevor Sie live gehen. Token-Limit-Steuerung: Legen Sie die maximale Länge der KI-Antworten fest (32–4096 Token), um Kosten und Qualität zu balancieren. KI-System-Prompt: Geben Sie der KI benutzerdefinierte Anweisungen (z. B. "Du bist ein Support-Mitarbeiter der Acme Corp. Beantworte nur Fragen zu unseren Produkten."). KI-Haftungsausschluss: Zeigen Sie optional einen Hinweis unter KI-generierten Antworten an. Fuzzy Match (Unscharfe Suche): Erkennt Nutzeranfragen, die einem Schlüsselwort ähneln, aber nicht exakt übereinstimmen. Dies reduziert unbeantwortete Fragen aufgrund von Tippfehlern. Konfigurierbarer Schwellenwert (35–95%). Lead-Erfassung: Fordern Sie Besucher auf, ihren Namen und ihre E-Mail während des Chats einzugeben. Erfasste Leads werden gespeichert und sind als CSV exportierbar. Menschliche Übergabe: Bieten Sie nach einer bestimmten Anzahl fehlgeschlagener Versuche einen Link zur Kontaktaufnahme mit einem Mitarbeiter an, inklusive optionaler Anzeige von Geschäftszeiten. Sitzungsbasierte Chat-Protokolle: Zeichnen Sie jede Chat-Sitzung auf. Sehen Sie sich vollständige Transkripte an und exportieren Sie Protokolle als CSV. Analyse-Dashboard: Verfolgen Sie die Gesamtzahl der Konversationen, Nachrichten, FAQ-Trefferquoten, KI-Nutzung und die am häufigsten ausgelösten Schlüsselwörter. Vollständige Design-Kontrolle: Passen Sie die Widget-Position (unten links/rechts), das Theme (hell/dunkel), Animationen (Schweben, Pulsieren, Keine), Button-Größe, Avatar-Größe sowie Breite, Höhe und Hintergrundfarbe des Chat-Fensters an. Branding-Optionen: Entfernen oder passen Sie den "Powered by"-Credit-Text und Link im Chat-Footer an. Datenaufbewahrung & Auto-Bereinigung: Legen Sie fest, wie viele Tage Chat-Protokolle und Leads aufbewahrt werden, mit optionaler automatischer täglicher Bereinigung. 5) Leitfaden zu den einzelnen Einstellungen A) Allgemeine Konfiguration Chatbot-Name: Der Name im Chat-Header. Sichtbar für alle Besucher. Avatar / Button-Bild: Bild für den Startbutton und den Header-Avatar. Upload über die WordPress-Mediathek. Avatar-Form: Rund, Quadratisch oder Abgerundet – steuert den Eckenradius des Avatars. Widget-Sichtbarkeit: Aktivieren, um den Chatbot anzuzeigen. Deaktivieren, um ihn auszublenden, ohne Einstellungen zu verlieren. B) Chat-Erlebnis Willkommensnachricht: Die erste Nachricht beim Öffnen des Chats. Beispiel: "Hallo! Wie kann ich Ihnen heute helfen?" Willkommensnachricht anzeigen: Aktiviert oder deaktiviert die Begrüßung. Willkommensvorschläge anzeigen: Zeigt Kategorie-Buttons zusammen mit der Willkommensnachricht an. Kategorien verwalten: Definieren Sie Ihre Q&A-Kategorien (eine pro Zeile). Standard: Allgemein, Verkauf, Support. Willkommenskategorien: Wählen Sie bis zu 3 Kategorien als Schnellzugriffs-Buttons aus. Navigation (Zurück zu Kategorien): Zeigt unter jeder Antwort einen Link an, um zum Hauptmenü zurückzukehren. Antwort bei fehlendem Treffer: Nachricht, wenn kein Schlüsselwort passt. Beispiel: "Ich habe Ihre Frage nicht verstanden. Versuchen Sie einen der Vorschläge unten." KI-Vorschläge: Zeigt bis zu 3 verwandte Q&A-Einträge bei fehlendem Treffer an. C) Branding & Identität (Pro) Credit entfernen: Versteckt den Text "Powered by Stella Chatbot" im Chat-Footer. Credit-Text: Passen Sie den Text im Footer an, falls die Anzeige aktiviert ist. Credit-Link: Legen Sie eine benutzerdefinierte URL für den Credit-Link fest. D) Fortgeschrittene Automatisierung (Pro) Lead-Erfassung: Aktivieren, um Besucher nach Name und E-Mail zu fragen. Lead-Erfassungsaufforderung: Nachricht, die nach den Kontaktdaten fragt. Beispiel: "Bevor wir fortfahren, könnten Sie uns Ihren Namen und Ihre E-Mail mitteilen?" Fuzzy Match: Aktiviert die Erkennung von ähnlichen (nicht exakten) Schlüsselwörtern. Fuzzy Match Schwellenwert (%): Empfindlichkeit (35–95%). Höher = strenger. Standard: 62%. Menschliche Übergabe: Bietet nach wiederholten Fehlversuchen einen Support-Link an. Fehlversuch-Zähler: Anzahl aufeinanderfolgender unbeantworteter Nachrichten, bevor die Übergabe angeboten wird. Übergabe-Nachricht: Der Text, der den Kontakt zu einem Mitarbeiter anbietet. Support-URL: Ziel-URL für menschlichen Support (z. B. Kontaktseite). Geschäftszeiten: Anzeige der Zeiten neben der Übergabe-Nachricht. Beispiel: 09:00–18:00 Mo–Fr. E) Erscheinungsbild & Widget (Pro) Widget-Position: Platzieren Sie den Chat unten rechts oder unten links. Theme: Hell- oder Dunkelmodus für das Chat-Fenster. Animation: Startbutton-Animation – Schweben, Pulsieren oder Keine. Button-Größe (px): Breite und Höhe des Buttons (44–88px). Standard: 56px. Avatar-Größe (px): Größe des Avatars im Header (24–80px). Standard: 36px. Fensterbreite (px): Breite des Chat-Fensters (280–520px). Standard: 350px. Fensterhöhe (px): Höhe des Chat-Fensters (220–600px). Standard: 480px. Fensterfarbe: Hintergrundfarbe des Chats via Color-Picker. F) KI-Intelligenz (Pro) KI-Fallback: KI-Antworten aktivieren, wenn kein FAQ-Schlüsselwort passt. KI-Anbieter: Wählen Sie OpenAI, Anthropic (Claude), Google Gemini, Groq oder OpenRouter. API-Schlüssel: Ihr Schlüssel für den gewählten Anbieter. Sicher verschlüsselt gespeichert. Modell: Wählen Sie das KI-Modell. Modelle werden dynamisch geladen oder manuell eingegeben. Maximale Output-Token: Länge der Antworten (32–4096). Empfohlen: 128–512 für Support-Chats. System-Prompt: Anweisungen für die KI bezüglich Rolle, Tonalität und Wissensumfang. KI-Haftungsausschluss: Text unter KI-Antworten. Beispiel: "Diese Antwort wurde von einer KI generiert und ist eventuell nicht zu 100% korrekt." KI-Modell-Tester: Senden Sie eine Testnachricht, um die Verbindung zum Anbieter zu prüfen. G) Datenverwaltung Daten bei Deinstallation löschen: Wenn aktiviert, werden alle Q&A-Einträge, Protokolle und Leads beim Entfernen des Plugins dauerhaft gelöscht. Standardmäßig deaktiviert. Datenaufbewahrung (Pro): Anzahl der Tage, für die Protokolle/Leads gespeichert werden (min. 7 Tage). Standard: 180 Tage. Auto-Bereinigung (Pro): Tägliches automatisches Löschen alter Datensätze. 6) Q&A-Einträge verwalten Einen Q&A-Eintrag hinzufügen Navigieren Sie zu Stella Chatbot > Q&A und füllen Sie die folgenden Felder aus: Kategorie: Optional. Gruppieren Sie den Eintrag (z. B. "Bestellungen"). Eindeutiges Schlüsselwort: Das Auslösewort. Wenn die Nachricht dieses Wort enthält, wird die Antwort gesendet. Muss eindeutig sein. Frage: Die vollständige Frage zur Referenz. Antwort: Die Nachricht des Chatbots. Unterstützt einfaches HTML (Links, Fettgedrucktes, Listen). Klicken Sie auf Save FAQ zum Speichern oder Update FAQ zum Bearbeiten. Bearbeiten & Löschen Klicken Sie auf Edit (Bearbeiten) neben einem Eintrag. Klicken Sie auf Delete (Löschen), um einen Eintrag permanent zu entfernen. Klicken Sie auf Cancel, um den Bearbeitungsmodus ohne Speichern zu verlassen. Datei-Import (Pro) Importieren Sie Q&A-Einträge in großen Mengen aus externen Dateien. Unterstützte Formate: CSV, TXT (Reintext mit Q&A-Blöcken), DOCX. Laden Sie die Datei unter Stella Chatbot Pro > Q&A im Bereich Import Q&A hoch. Beispiel CSV-Format: keyword,question,answer,category Rückerstattung,Wie erhalte ich eine Rückerstattung?,Sie können eine Rückerstattung innerhalb von 30 Tagen beantragen.,Bestellungen Versand,Wie lange dauert der Versand?,Der Standardversand dauert 3-5 Werktage.,Versand7) Chat-Protokolle (Pro) Navigieren Sie zu Stella Chatbot Pro > Chat Logs, um alle Sitzungen einzusehen. Klicken Sie auf View Chat, um das vollständige Transkript zu lesen. Klicken Sie auf Export CSV für eine Offline-Analyse. Protokolle werden gemäß der Datenaufbewahrung automatisch gelöscht. 8) Lead-Erfassung & Leads (Pro) Aktivieren Sie Lead Capture in den Einstellungen. Unter Stella Chatbot Pro > Leads finden Sie alle Namen, E-Mails und Zeitstempel. Nutzen Sie Export CSV für Ihr CRM oder E-Mail-Marketing. Leads werden nach Ablauf der Aufbewahrungsfrist automatisch gelöscht. 9) Analyse (Pro) Unter Stella Chatbot Pro > Analytics erhalten Sie eine Leistungsübersicht: Gesamtanzahl Konversationen und Nachrichten. FAQ-Trefferquote vs. Fehlversuche. Häufigkeit der KI-Fallback-Nutzung. Am häufigsten ausgelöste Schlüsselwörter. Conversion-Daten der Lead-Erfassung. 10) Fehlerbehebung Chatbot im Frontend nicht sichtbar Prüfen Sie, ob Display chatbot on frontend in den Einstellungen aktiv ist. Leeren Sie alle Caches (WordPress, Plugins, CDN, Browser). Prüfen Sie die Browser-Konsole auf JavaScript-Fehler. Schlüsselwort löst keine Antwort aus Überprüfen Sie die exakte Schreibweise des Schlüsselworts. Stellen Sie sicher, dass das Schlüsselwort nicht doppelt vergeben wurde. Aktivieren Sie Fuzzy Match (Pro) für Tippfehler. KI antwortet nicht (Pro) Prüfen Sie API-Schlüssel und Kontoguthaben/Quoten beim Anbieter. Nutzen Sie den AI Model Tester in den Einstellungen. Stellen Sie sicher, dass AI Fallback unter AI Intelligence aktiv ist. 11) Daten & Deinstallation Beide Versionen enthalten die Option Delete data on uninstall in den Einstellungen. Falls aktiviert: Alle Einträge, Protokolle und Leads werden bei der Deinstallation unwiderruflich gelöscht. Falls deaktiviert (Standard): Die Daten bleiben in der Datenbank und stehen bei einer Neuinstallation wieder zur Verfügung. 12) Empfohlener Workflow Definieren Sie die häufigsten Fragen Ihrer Besucher. Erstellen Sie Q&A-Einträge mit klaren Schlüsselwörtern. Nutzen Sie Kategorien für eine einfache Navigation. Konfigurieren Sie eine freundliche Begrüßung und die 3 Fokus-Kategorien. Aktivieren Sie den KI-Fallback (Pro), um Lücken im FAQ zu schließen. Überwachen Sie Protokolle und Analysen (Pro), um den Chatbot stetig zu verbessern.