KI Produktberater Handbuch.

Dieses Handbuch zeigt Schritt für Schritt, wie du den KI-gestützten Pre-Sales-Chat einrichtest, einen KI-Anbieter anbindest und die Beratung an deinen Katalog anpasst.

Systemvoraussetzungen

Shopware 6.7 und ein API-Key bei einem der vier unterstützten KI-Anbieter: OpenAI, Anthropic (Claude), Mistral oder Google Gemini. Für die automatische Bereinigung der Protokolle muss ein Worker laufen.

Hinweis: Der Berater empfiehlt ausschließlich Produkte aus dem echten Katalog deines Shops. Erfundene Artikel sind technisch ausgeschlossen.

Installation

Im Admin unter Erweiterungen, Meine Erweiterungen, Hochladen installieren - oder den Plugin-Ordner nach custom/plugins/StawKiProductAdvisor legen und über die Konsole installieren:

bin/console plugin:refresh bin/console plugin:install --activate StawKiProductAdvisor bin/console assets:install bin/console cache:clear

Aktivieren und Anbieter wählen

Im Admin unter Marketing, KI Produktberater aktivieren, den Anbieter wählen und den API-Key hinterlegen. Jeder Anbieter hat einen eigenen Key und ein eigenes Modell, du kannst also zwischen Anbietern wechseln, ohne Keys zu verlieren. Alle Einstellungen lassen sich pro Sales-Channel getrennt setzen.

Was der Berater macht

Der Produktberater ist ein Pre-Sales-Chat im Storefront. Er beantwortet Kundenfragen und empfiehlt dazu passende Produkte. Die Antwort wird per Server-Sent-Events gestreamt, erscheint also fortlaufend statt erst am Ende, auf Wunsch mit Tippeffekt.

Beratung nur aus dem echten Katalog

Bei jeder Anfrage durchsucht das Plugin zuerst den Katalog. Die KI darf anschließend nur aus den gefundenen Treffern empfehlen. Damit ist ausgeschlossen, dass sie Produkte erfindet, die es im Shop nicht gibt - der häufigste Vorwurf gegen KI-Chats im Handel.

Intelligente Suche

Ein schneller Vorab-Call extrahiert aus der Kundenfrage Suchbegriffe sowie Preis- und Eigenschafts-Vorgaben, etwa Farbe, Material oder Größe. Fällt dieser Call aus, greift ein lokaler Fallback. Das Zeitlimit liegt bei 10 Sekunden, damit der Chat nicht hängt. Das Modell für diese Extraktion lässt sich getrennt vom Antwort-Modell wählen.

Allgemein

Aktiv
Schaltet den Berater im jeweiligen Sales-Channel ein.
Anbieter, API-Key, Modell
OpenAI, Anthropic, Mistral oder Gemini - je Anbieter eigener Key und eigenes Modell.
Anzeige-Bereich
Legt fest, wo der Chat erscheint.
Intelligente Suche, Extraktions-Modell
Aktiviert die Vorab-Analyse der Frage und bestimmt das dafür genutzte Modell.

Verhalten

Name, Avatar
Anzeigename und Bild des Beraters.
Begrüßung
Erste Nachricht beim Öffnen des Chats.
Schnellstart-Vorschläge
Vorgefertigte Einstiegsfragen zum Antippen.
Persona
Tonalität und Rolle, in der die KI antwortet.
Zustimmungstext
Text des optionalen Zustimmungs-Gates vor der ersten Nachricht.

Position und Darstellung

Position 8 Möglichkeiten
Platzierung des Chat-Buttons im Storefront.
Offsets
Feinjustierung des Abstands zu den Rändern.
Akzentfarbe
Farbe von Button und Chat-Elementen.
Proaktives Öffnen, Puls
Automatisches Öffnen nach Verzögerung und Aufmerksamkeits-Puls am Button.

Statistik

Logging
Speichert anonymisierte Anfragen zur Auswertung.
Aufbewahrung in Tagen
Ältere Einträge werden von einem täglichen Task automatisch gelöscht.
Auswertung, CSV-Export
Statistikansicht im Admin und Export der Rohdaten.

Quickview und Variantenkonfigurator

Empfohlene Produkte erscheinen direkt im Chat als Quickview. Bei Variantenartikeln ist ein Konfigurator eingebaut: Die Auswahl löst die passende Variante auf, sodass Warenkorb- und Produktlink auf genau diese Variante zeigen und nicht auf den Hauptartikel.

Proaktiver Trigger

Optional öffnet sich der Chat nach einer einstellbaren Verzögerung von selbst. Ergänzend kann der Button pulsieren, um Aufmerksamkeit zu erzeugen. Beides ist abschaltbar.

Conversion-Tracking

Für jede Empfehlung erfasst das Plugin Klicks, Warenkorb-Zugänge und den Warenkorbwert. Damit lässt sich beziffern, was der Berater tatsächlich zum Umsatz beiträgt, statt nur Gesprächszahlen zu zeigen.

Auswertung und CSV-Export

Die Statistik im Admin zeigt die häufigsten Suchbegriffe und die meistempfohlenen Produkte. Die Rohdaten lassen sich als CSV exportieren und extern weiterverarbeiten.

Datenschutz und DSGVO

Übermittelt werden der Nachrichtentext des Kunden samt bisherigem Gesprächsverlauf sowie ein kompakter Auszug passender Katalogprodukte, also Name, Nummer, Preis und Eigenschaften. Bestell-, Konto- und Zahlungsdaten werden nicht übermittelt.

E-Mail-Adressen und Telefonnummern entfernt das Plugin automatisch, bevor etwas an den Anbieter geht. Zusätzlich lässt sich ein Zustimmungs-Gate aktivieren, das vor der ersten Nachricht eine Bestätigung verlangt.

Als Betreiber musst du selbst tätig werden: Ergänze deine Datenschutzerklärung um die Weitergabe an den gewählten KI-Anbieter, schließe bei Bedarf einen Auftragsverarbeitungsvertrag ab und prüfe die Bedingungen des Anbieters, insbesondere zum Drittlandtransfer.

Protokolle und Aufbewahrung

Ist das Logging aktiv, speichert das Plugin anonymisierte Anfragen ohne E-Mail und Telefonnummer. Die Aufbewahrungsdauer stellst du in Tagen ein, ein täglich laufender Task löscht ältere Einträge. Der Task benötigt einen aktiven Worker.

Problemlösung

Der Chat erscheint nicht

Prüfe, ob der Berater im betreffenden Sales-Channel aktiv ist - die Einstellungen gelten pro Kanal. Danach Cache leeren.

Keine Antwort oder Abbruch nach kurzer Zeit

Meist fehlt ein gültiger API-Key beim gewählten Anbieter oder das Modell ist für den Key nicht freigeschaltet. Die intelligente Suche bricht nach 10 Sekunden ab und fällt auf die lokale Suche zurück.

Empfehlungen wirken unpassend

Der Berater kann nur empfehlen, was die Katalogsuche findet. Prüfe Produktnamen und Eigenschaften, und schärfe die Persona.

Alte Protokolle werden nicht gelöscht

Der Aufräum-Task läuft nur bei aktivem Worker.

Support

Bei Fragen zur Einrichtung, zur Anbieterwahl oder zum Datenschutz helfen wir gern weiter. Schreib uns über die Kontaktseite oder an info@stoneandwater.online.

Über den Store oder direkt bei uns.

Zwei Wege, derselbe Funktionsumfang - such dir aus, was besser zu deinem Setup passt.

Direkt über Stone & Water

Ab sofort möglich

Monatlich9,99 €
Halbjährlich49,99 €17 % günstiger
Bester PreisJährlich89,99 €25 % günstiger

Alle Preise netto zzgl. USt.

Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.

Noch Fragen?

Zurück zum Produktberater.

Alle Funktionen im Überblick findest du auf der Produktseite. Für Einrichtung und Feintuning sind wir da.