Helvira AI ChatBot - WordPress

KI-gesteuerter Chatbot mit RAG-Fähigkeiten für WordPress

Einführung

Helvira AI ChatBot ist ein leistungsstarkes WordPress-Plugin, das einen intelligenten KI-Chatbot zu Ihrer Website hinzufügt. Der Chatbot verwendet RAG-Technologie (Retrieval-Augmented Generation), um Fragen zu Ihrem Website-Inhalt, Produkten und Dienstleistungen zu beantworten.

Hauptfunktionen

• 🤖 KI-gesteuerte Antworten - Verwendet fortschrittliche Sprachmodelle für natürliche Gespräche
• 📚 RAG-Technologie - Indiziert automatisch Ihre Inhalte für präzise Antworten
• 🛒 WooCommerce-Integration - Einkaufsassistent mit Warenkorbverwaltung
• 🌍 Mehrsprachige Unterstützung - Erkennt automatisch und antwortet in der Sprache des Benutzers
• 🎨 Anpassbares Design - Passen Sie es Ihrer Marke mit Farben, Verläufen und benutzerdefinierten Logos an
• 📱 Mobil-responsiv - Funktioniert perfekt auf allen Geräten
• 💬 Gesprächsverlauf - Behält den Kontext während der gesamten Chat-Sitzung bei

---

Voraussetzungen

Anforderung	Minimum	Empfohlen
WordPress	5.8+	6.0+
PHP	7.4+	8.0+
MySQL	5.7+	8.0+
WooCommerce	6.0+ (optional)	8.0+

Serveranforderungen

• PHP-Erweiterung cURL aktiviert
• PHP-Erweiterung JSON aktiviert
• Ausgehende HTTPS-Verbindungen erlaubt (für API-Aufrufe)

---

Installation

Methode 1: Upload über WordPress Admin

1. Laden Sie die Plugin-ZIP-Datei herunter
2. Gehen Sie zu WordPress Admin → Plugins → Installieren
3. Klicken Sie auf Plugin hochladen
4. Wählen Sie die ZIP-Datei und klicken Sie auf Jetzt installieren
5. Klicken Sie auf Plugin aktivieren

Methode 2: Manuelle Installation (FTP)

1. Entpacken Sie die Plugin-ZIP-Datei
2. Laden Sie den helvira-Ordner nach /wp-content/plugins/ hoch
3. Gehen Sie zu WordPress Admin → Plugins
4. Finden Sie "Helvira AI Chat" und klicken Sie auf Aktivieren

---

Konfiguration

Nach der Aktivierung gehen Sie zu WordPress Admin → Helvira Chat, um das Plugin zu konfigurieren.

Allgemeine Einstellungen

Chatbot aktivieren

Schalten Sie diese Option um, um den Chatbot auf Ihrer Website anzuzeigen oder auszublenden.

• Aktiviert: Chatbot ist für alle Besucher sichtbar
• Deaktiviert: Chatbot ist ausgeblendet (nützlich für Wartung)

Chat-Titel

Der Titel, der im Chat-Widget-Header angezeigt wird.

Beispiel: "Chatten Sie mit uns", "Brauchen Sie Hilfe?", "Fragen Sie mich"

Willkommensnachricht

Die erste Nachricht, die angezeigt wird, wenn ein Besucher den Chat öffnet.

Best Practices:

• Halten Sie es freundlich und prägnant
• Erwähnen Sie, wobei der Chatbot helfen kann
• Berücksichtigen Sie Ihre Markensprache

Beispiel:

Hallo! 👋 Ich bin hier, um Ihnen bei Fragen zu unseren Produkten und Dienstleistungen zu helfen. Was möchten Sie wissen?

---

API-Konfiguration

API-Schlüssel

Ihr Helvira API-Schlüssel ist erforderlich, damit der Chatbot funktioniert.

Wie Sie einen API-Schlüssel erhalten:

1. Gehen Sie zu chat.helvira.ai
2. Erstellen Sie ein Konto oder melden Sie sich an
3. Navigieren Sie zu Einstellungen → Konto → API-Schlüssel → Anzeigen
4. Kopieren Sie den Schlüssel und fügen Sie ihn in die Plugin-Einstellungen ein

⚠️ Sicherheitshinweis: Teilen Sie niemals Ihren API-Schlüssel öffentlich. Das Plugin speichert ihn sicher in Ihrer WordPress-Datenbank.

KI-Modell

Wählen Sie Ihr Modell basierend auf Ihrem Abonnement:

Modellname
Gemmini Light (Gemma3) Standard
Gemmini (Gemma3) Premium
OSS (gpt-oss) Premium

---

Erscheinungsbild-Einstellungen

Farbstil

Wählen Sie zwischen zwei Farbmodi:

Einzelfarbe

• Eine Farbe für alle Elemente
• Sauberer, professioneller Look
• Am besten für minimalistische Designs

Verlauf

• Zwei-Farben-Verlaufseffekt
• Moderne, dynamische Erscheinung
• Anpassbare Richtung

Primärfarbe

Die Hauptfarbe verwendet für:

• Chat-Button
• Header-Hintergrund
• Senden-Button
• Benutzer-Nachrichtenblasen

Standard: #667eea (Lila-Blau)

Sekundärfarbe (nur Verlauf)

Die zweite Farbe für Verlaufseffekte.

Standard: #764ba2 (Lila)

Verlaufsrichtung

Wählen Sie, wie der Verlauf fließt:

Option	Richtung
↘️ Diagonal	Oben-links nach unten-rechts (135deg)
→ Horizontal	Links nach rechts
↓ Vertikal	Oben nach unten
↗️ Diagonal aufwärts	Unten-links nach oben-rechts (45deg)

Widget-Position

Wo der Chat-Button auf Ihrer Website erscheint:

• Unten rechts (empfohlen) - Standardposition, stört den Inhalt nicht
• Unten links - Alternative Position für RTL-Sites oder nach Präferenz
• Oben links
• Oben rechts

Benutzerdefiniertes Logo

Laden Sie ein benutzerdefiniertes Bild für den Chat-Button hoch.

Spezifikationen:

• Format: PNG (mit Transparenz) oder JPG
• Größe: 40x40 Pixel empfohlen
• Dateigröße: Unter 100KB für beste Leistung

Zum Hochladen:

1. Klicken Sie auf Hochladen
2. Wählen oder laden Sie ein Bild hoch
3. Klicken Sie auf Dieses Bild verwenden

---

Inhaltsindizierung

Das RAG-System indiziert Ihre Website-Inhalte, damit die KI Fragen genau beantworten kann.

Zu indizierende Beitragstypen

Wählen Sie, welche Inhaltstypen durchsuchbar sein sollen:

• ✅ Beiträge - Blog-Posts, Artikel
• ✅ Seiten - Statische Seiten, Über uns, Kontakt
• ✅ Produkte - WooCommerce-Produkte (falls installiert)

Empfehlung: Aktivieren Sie alle öffentlichen Inhaltstypen für umfassende Abdeckung.

Maximale Kontext-Chunks

Wie viele Inhalts-Chunks im KI-Kontext enthalten sein sollen (1-20).

Einstellung	Kompromiss
1-3	Schneller, weniger Kontext
4-6	Ausgewogen (empfohlen)
7-10	Mehr Kontext, langsamer
11-20	Maximaler Kontext, am langsamsten

Standard: 5 Chunks

Chunk-Größe (Wörter)

Anzahl der Wörter pro Inhalts-Chunk (100-2000).

• Kleinere Chunks (100-300): Präzisere Übereinstimmung, weniger Kontext pro Chunk
• Größere Chunks (500-1000): Mehr Kontext, möglicherweise weniger präzise
• Standard: 500 Wörter

Chunk-Überlappung (Wörter)

Überlappung zwischen aufeinanderfolgenden Chunks für Kontinuität (0-500).

• Warum Überlappung? Stellt sicher, dass wichtige Informationen an Chunk-Grenzen nicht verloren gehen
• Standard: 100 Wörter

Inhalte neu indizieren

Klicken Sie auf Alle Inhalte neu indizieren, um den Inhaltsindex neu aufzubauen. Tun Sie dies nach:

• Hinzufügen oder Aktualisieren signifikanter Inhalte
• Ändern der indizierten Beitragstypen
• Ändern der Chunk-Größen-/Überlappungseinstellungen
• Erstmalige Plugin-Einrichtung

ℹ️ Die Neuindizierung kann bei großen Sites mehrere Minuten dauern.

---

WooCommerce-Integration

Wenn WooCommerce installiert ist, werden zusätzliche Funktionen verfügbar.

Einkaufsassistent aktivieren

Wenn aktiviert, kann der Chatbot:

• 🛒 Warenkorb-Inhalt anzeigen - Sehen, welche Artikel im Warenkorb des Kunden sind
• ➕ Produkte hinzufügen - Artikel über Chat zum Warenkorb hinzufügen
• ➖ Produkte entfernen - Artikel aus dem Warenkorb entfernen
• 🎫 Gutscheine anwenden - Rabattcodes anwenden
• 📦 Produktinformationen - Details zu Produkten liefern
• 💡 Empfehlungen - Relevante Produkte vorschlagen

Beispielgespräche

Zum Warenkorb hinzufügen:

Benutzer: Füge dieses Produkt zu meinem Warenkorb hinzu
Bot: ✓ "Produktname" wurde zu Ihrem Warenkorb hinzugefügt. Ihr Warenkorb enthält jetzt 2 Artikel.

Gutschein anwenden:

Benutzer: Ich habe einen Rabattcode SPARE20
Bot: ✓ Gutschein "SPARE20" angewendet! Sie sparen 20% bei Ihrer Bestellung.

Produktfragen:

Benutzer: Ist das auf Lager?
Bot: Ja! Das "Produktname" ist derzeit mit 15 Einheiten auf Lager. 
     Der Preis beträgt 49,99€. Soll ich es zu Ihrem Warenkorb hinzufügen?

---

Funktionen

Mehrsprachige Unterstützung

Der Chatbot erkennt automatisch und antwortet in der Sprache des Benutzers.

Unterstützte Sprachen für Warenkorb:

• 🇬🇧 English
• 🇫🇷 Français
• 🇩🇪 Deutsch
• 🇪🇸 Español
• 🇮🇹 Italiano

Wie es funktioniert:

1. Benutzer sendet eine Nachricht in seiner Sprache
2. KI erkennt die Sprache
3. Antwort wird in derselben Sprache generiert

Seiten-Kontext-Bewusstsein

Der Chatbot weiß, welche Seite der Besucher gerade ansieht.

Beispiel:

Benutzer: Kannst du diese Seite zusammenfassen?
Bot: Sie sehen unsere "Über uns"-Seite. Diese Seite erklärt unsere 
     Firmengeschichte, gegründet 2010, unsere Mission, Qualitätsprodukte 
     anzubieten, und stellt unser Team von über 50 Mitarbeitern vor...

Gesprächsverlauf

• Chat-Verlauf wird während der Sitzung beibehalten
• KI erinnert sich an den Kontext früherer Nachrichten
• Benutzer können den Verlauf mit dem 🗑️-Button löschen

Quellenangaben

Bei Antworten aus indizierten Inhalten kann der Chatbot Quellen anzeigen:

Bot: Unsere Rückgaberichtlinie erlaubt Rückgaben innerhalb von 30 Tagen nach dem Kauf...

Quellen:
• Rückgaberichtlinie
• FAQ - Versand & Rückgaben

---

Wie es funktioniert

RAG (Retrieval-Augmented Generation)

┌─────────────────────────────────────────────────────────────┐
│                     Benutzer-Nachricht                       │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                   1. Absichtserkennung                       │
│      Bestimmen ob Chat-Frage oder Warenkorb-Aktion           │
└─────────────────────────────────────────────────────────────┘
                              │
              ┌───────────────┴───────────────┐
              ▼                               ▼
┌─────────────────────────┐     ┌─────────────────────────┐
│    Chat-Frage           │     │     Warenkorb-Aktion    │
└─────────────────────────┘     └─────────────────────────┘
              │                               │
              ▼                               ▼
┌─────────────────────────┐     ┌─────────────────────────┐
│ 2. Indizierte Inhalte   │     │ 2. Aktion ausführen     │
│    durchsuchen (RAG)    │     │    (Hinzuf./Entf./etc)  │
└─────────────────────────┘     └─────────────────────────┘
              │                               │
              ▼                               ▼
┌─────────────────────────┐     ┌─────────────────────────┐
│ 3. Kontext aufbauen     │     │ 3. Aktion bestätigen    │
│    + Seiten-Info        │     │    + Warenkorb aktual.  │
└─────────────────────────┘     └─────────────────────────┘
              │                               │
              ▼                               ▼
┌─────────────────────────────────────────────────────────────┐
│                    4. KI-Antwort                             │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                   Dem Benutzer anzeigen                      │
└─────────────────────────────────────────────────────────────┘

Inhaltsindizierungsprozess

1. Extraktion: Inhalt wird aus Beiträgen, Seiten und Produkten extrahiert
2. Chunking: Inhalt wird in handhabbare Chunks aufgeteilt
3. Speicherung: Chunks werden mit Metadaten in der Datenbank gespeichert
4. Abruf: Relevante Chunks werden basierend auf Benutzeranfragen abgerufen

---

Fehlerbehebung

Chatbot erscheint nicht

Mögliche Ursachen und Lösungen:

Ursache	Lösung
Plugin deaktiviert	In Helvira Chat → Allgemeine Einstellungen aktivieren
JavaScript-Fehler	Browser-Konsole auf Fehler prüfen
Theme-Konflikt	Mit Standard-Theme testen
Caching	Site-Cache und Browser-Cache leeren

Fehler "API-Schlüssel ungültig"

1. Überprüfen Sie, ob der API-Schlüssel korrekt ist (keine zusätzlichen Leerzeichen)
2. Prüfen Sie, ob der Schlüssel abgelaufen ist
3. Stellen Sie sicher, dass Ihr API-Konto aktiv ist
4. Verbindung in Einstellungen testen

Chatbot gibt falsche Antworten

1. Inhalte neu indizieren - Klicken Sie auf "Alle Inhalte neu indizieren"
2. Indizierte Beitragstypen prüfen - Stellen Sie sicher, dass relevante Inhalte indiziert sind
3. Max Chunks erhöhen - Erlauben Sie mehr Kontext für bessere Antworten
4. Inhaltsqualität überprüfen - KI kann nur verwenden, was indiziert ist

Langsame Antworten

Ursache	Lösung
Große Chunk-Größe	Chunk-Größe auf 300-500 reduzieren
Zu viele Chunks	Max Chunks auf 3-5 reduzieren
Langsame API	API-Status prüfen, anderes Modell versuchen
Server-Probleme	Server-Ressourcen prüfen

WooCommerce-Warenkorb-Aktionen funktionieren nicht

1. Stellen Sie sicher, dass Einkaufsassistent aktivieren AN ist
2. Prüfen Sie, ob WooCommerce aktiv und aktualisiert ist
3. Überprüfen Sie, ob das Produkt existiert und auf Lager ist
4. WooCommerce-Transients leeren

Chat-Verlauf wird nicht gespeichert

• Verlauf wird im Browser sessionStorage gespeichert
• Löscht sich beim Schließen des Browser-Tabs (beabsichtigt)
• Privater/Inkognito-Modus kann Speicherung blockieren

---

FAQ

Allgemeine Fragen

F: Ist der Chatbot kostenlos? A: Das Plugin ist kostenlos, erfordert aber einen API-Schlüssel von Helvira AI, der je nach Nutzung Kosten verursachen kann.

F: Funktioniert es mit jedem Theme? A: Ja, Helvira Chat ist so konzipiert, dass es mit jedem ordnungsgemäß codierten WordPress-Theme funktioniert.

F: Kann ich es auf mehreren Sites verwenden? A: Prüfen Sie die Lizenzbedingungen Ihres API-Schlüssels. Einige Pläne erlauben mehrere Sites.

F: Sind meine Daten sicher? A: Ja. Gespräche werden über sichere HTTPS-Verbindungen verarbeitet. Wir speichern keine Gesprächsdaten auf unseren Servern.

Technische Fragen

F: Beeinflusst es die Site-Geschwindigkeit? A: Das Chat-Widget lädt asynchron und hat minimalen Einfluss auf die Ladezeit (~50KB).

F: Kann ich die KI-Persönlichkeit anpassen? A: Die KI passt sich Ihrem Site-Namen und Ihrer Beschreibung an. Benutzerdefinierte System-Prompts könnten in zukünftigen Versionen verfügbar sein.

F: Funktioniert es mit Page Buildern? A: Ja, kompatibel mit Elementor, Divi, Beaver Builder und anderen.

F: Kann ich bestimmte Seiten ausschließen? A: Derzeit nicht. Diese Funktion ist für eine zukünftige Version geplant.

WooCommerce-Fragen

F: Kann der Chatbot Zahlungen verarbeiten? A: Nein, er kann Benutzer zur Kasse führen, aber verarbeitet keine Zahlungen.

F: Unterstützt er variable Produkte? A: Ja, er kann variable Produkte mit ausgewählten Variationen hinzufügen.

F: Kann er auf die Bestellhistorie zugreifen? A: Derzeit begrenzt. Vollständige Bestellhistorie-Funktionen sind geplant.

---

Changelog

Version 1.0.0 (Erstveröffentlichung)

• ✅ KI-gesteuerter Chatbot mit RAG
• ✅ Inhaltsindizierung für Beiträge, Seiten, Produkte
• ✅ WooCommerce-Integration (Warenkorb-Aktionen)
• ✅ Mehrsprachige Unterstützung
• ✅ Anpassbares Erscheinungsbild (Farben, Verläufe, Logo)
• ✅ Mobil-responsives Design
• ✅ Gesprächsverlauf
• ✅ Seiten-Kontext-Bewusstsein
• ✅ Moderne Admin-Einstellungs-UI

---

Support

Dokumentation: docs.helvira.ai

Support-E-Mail: support@helvira.ai

GitHub Issues: github.com/helvira/chat-plugin/issues

---

Lizenz

Dieses Plugin ist unter der GPL v2 oder später lizenziert.

Dieses Programm ist freie Software; Sie können es unter den Bedingungen
der GNU General Public License, wie von der Free Software Foundation
veröffentlicht, weitergeben und/oder modifizieren; entweder Version 2
der Lizenz oder (nach Ihrer Wahl) jede spätere Version.

---

Mit ❤️ erstellt von Helvira AI