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.
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.
Im Admin unter Erweiterungen, Meine Erweiterungen, Hochladen installieren - oder den Plugin-Ordner nach custom/plugins/StawKiProductAdvisor legen und über die Konsole installieren:
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.
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.
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.
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.
Oben im Modul wählst du Verkaufskanal und Sprache. Jede Einstellung gilt zunächst für alle Kanäle; wählst du einen aus, bekommt dieser eigene Werte.
Die Einstellungen sind in aufklappbare Bereiche gegliedert und starten zugeklappt. Im Kopf jedes Bereichs steht links der Titel, rechts der Pfeil; die Erläuterung steckt im i hinter dem Titel.
Neu sortiert: Verhalten & Persönlichkeit enthält nur noch Rolle, Masterprompt, Suche und Antwortverhalten. Alles, was der Kunde im Chatfenster sieht, steht in Chat-Oberfläche. Der Datenschutzhinweis hat einen eigenen Bereich.
Der Berater berücksichtigt die in Shopware gepflegten Cross-Selling-Zuordnungen: Zu den besten Treffern werden die hinterlegten Partnerprodukte aktiv in die Empfehlung aufgenommen und mit dem Hinweis „Passt gut zu" gekennzeichnet.
Empfehlungen und Produktkarten sortiert der Berater nach Passgenauigkeit zur Anfrage und gibt zusammengehörige Produkte gemeinsam aus, statt sie über die Antwort zu verteilen.
Gepflegte Zusatzfelder (Custom Fields) fließen mit ihren sprachrichtigen Bezeichnungen in den Zusammenhang ein, den die KI erhält. Über eine Mehrfachauswahl in den Einstellungen bestimmst du, welche Felder mitgegeben werden - ohne Auswahl sind es alle.
Im Detailfenster des Chats erscheinen die Angaben als eigener Abschnitt „Weitere Details". Enthalten die Felder Links oder eingebettete Videos, lassen sich diese direkt anklicken und öffnen in einem eigenen Fenster.
Neben den Produktdaten kann der Berater auch Inhalte deiner Shopseiten einlesen. Wie viel Text je Seite berücksichtigt wird, legst du im Feld „Zeichenlimit pro Shopseite" fest.
Der Wert null bedeutet unbegrenzt. Empfohlen sind 4.000 bis 8.000 Zeichen je Seite - genug für den Inhalt einer typischen Ratgeberseite, ohne den Zusammenhang mit Randtexten zu überladen.
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.
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.
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.
Die Statistik im Admin zeigt die häufigsten Suchbegriffe und die meistempfohlenen Produkte. Die Rohdaten lassen sich als CSV exportieren und extern weiterverarbeiten.
Ü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.
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.
Prüfe, ob der Berater im betreffenden Sales-Channel aktiv ist - die Einstellungen gelten pro Kanal. Danach Cache leeren.
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.
Der Berater kann nur empfehlen, was die Katalogsuche findet. Prüfe Produktnamen und Eigenschaften, und schärfe die Persona.
Der Aufräum-Task läuft nur bei aktivem Worker.
Bei Fragen zur Einrichtung, zur Anbieterwahl oder zum Datenschutz helfen wir gern weiter. Schreib uns über die Kontaktseite oder an info@stoneandwater.online.
Jede Einstellung des Plugins mit Standardwert und Erklärung, in derselben Reihenfolge wie im Administrationsbereich. Die Texte stammen direkt aus dem Plugin (Version 1.8.25).
Lizenz für die Direktverkauf-Edition dieses Plugins.
Der Lizenzschlüssel aus deinem Kundenkonto bei Stone & Water. Ohne gültige Lizenz bleibt der Berater gesperrt.
Schaltet den Berater im Shop ein oder aus.
Der Dienst, der die Antworten schreibt: OpenAI, Anthropic, Mistral oder Google. Für den gewählten Anbieter wird ein eigener API-Schlüssel hinterlegt.
Zugangsschlüssel des gewählten Anbieters. Jeder Anbieter hat sein eigenes Feld.
Das Sprachmodell des gewählten Anbieters. Ohne Auswahl nutzt der Berater das Standardmodell des Anbieters.
Nur nötig, wenn der API-Schlüssel nicht auf einen Workspace beschränkt ist - die Anthropic-API verlangt dann die Workspace-ID (wrkspc_...). Alternativ in der Anthropic-Konsole einen Schlüssel mit Workspace-Zuordnung erstellen.
Name, Avatar und Auftreten des Beraters.
Tonalität, Fachgebiet, Cross-Selling-Hinweise. Wird dem System-Prompt hinzugefügt.
Eigene Grundregeln für Ton, Vorgehen und Gesprächsführung. Gilt zusätzlich zur Rolle oben und wirkt in jedem Gespräch. Die Sicherheitsregeln des Plugins (nur vorhandene Produkte empfehlen, keine erfundenen Angaben) bleiben davon unberührt.
Wie viele passende Produkte der KI je Antwort als Grundlage mitgegeben werden.
Höchstlänge einer Kundennachricht in Zeichen. Längere Nachrichten werden auf diese Länge gekürzt.
Empfiehlt nur Produkte, die derzeit verfügbar sind.
Bevorzugt bei gleicher Relevanz gut verkaufte Produkte gegenüber Ladenhütern (leichter Bestseller-Bonus im Ranking).
Direkt empfehlen: schon die erste Antwort enthält passende Produktkarten (plus optionale Rückfrage). Beratungs-Funnel: bei allgemeinen Anfragen stellt der Berater erst 1-2 gezielte Rückfragen und empfiehlt danach.
Extrahiert per schnellem Vorab-Call Suchbegriffe aus der Kundenfrage und sucht damit gezielter im Katalog (mit lokalem Fallback). Aus: die rohe Frage wird direkt gesucht.
Nennt der Kunde ein Merkmal (z. B. Farbe, Material, Größe) und kein Produkt erfüllt es genau, wird nichts gezeigt. Aus: es werden nahe Alternativen gezeigt, und der Berater weist ehrlich darauf hin.
Gibt dem Berater das Zubehör des aktuell angesehenen Produkts mit, damit er passende Ergänzungen vorschlagen kann. Zusätzlich werden Cross-Selling-Verknüpfungen der gefundenen Produkte aktiv einbezogen und zusammengehörige Produkte gemeinsam ausgegeben.
Zeigt nach jeder Antwort antippbare Antwort-Optionen aus Kundensicht, mit denen der Kunde ohne Tippen weitermacht (von der KI passend zur Antwort erzeugt).
Optionale feste Antwort-Optionen aus Kundensicht (eine pro Zeile, max. 4). Werden nur genutzt, wenn die KI keine eigenen erzeugt. Leer = ausschließlich KI-Vorschläge.
Name, Avatar, Begrüßung, Schnellstart und alles, was der Kunde im Chatfenster sieht.
Name, unter dem der Berater im Chat auftritt.
Erste Nachricht des Beraters, wenn der Chat geöffnet wird.
Anklickbare Vorschläge beim Öffnen des Chats - eine pro Zeile (max. 4). Leer = keine.
Grauer Text im Eingabefeld des Chats. Leer = sprachabhängiger Standardtext.
Antwort erscheint gleichmäßig Zeichen für Zeichen statt schubweise.
Wie schnell der Tippeffekt Antworten erscheinen lässt: langsam, normal oder schnell.
Zeigt unter jeder Empfehlung (und im Detail-Modal) einen Link zur Kategorie, damit Kunden weiterstöbern können.
Zeigt im Detail-Modal die Varianten-Auswahl (z. B. Farbe, Größe) als gestyltes Dropdown. Aus: das Modal verlinkt zur Produktseite zur Variantenwahl.
Schließt das Detail-Modal automatisch, sobald ein Produkt erfolgreich in den Warenkorb gelegt wurde. Die Bestätigung bleibt im Chat sichtbar.
Zeigt direkt auf jeder Empfehlungskarte einen Warenkorb-Button (nur Produkte ohne Varianten). Varianten-Produkte führen weiterhin über das Detail-Modal.
Zeigt nach dem Hinzufügen zum Warenkorb passende Zubehör-Karten aus den Cross-Selling-Zuordnungen des Produkts direkt im Chat.
Zeigt nach jeder Antwort einen Daumen hoch/runter. Die Bewertung erscheint anonym in der Statistik (Zufriedenheit).
An: Klick auf eine Empfehlung öffnet ein Detail-Modal im Chat. Aus: die Karte verlinkt direkt zur Produktseite.
Hinweis vor der ersten Nachricht.
Blockiert die Eingabe, bis der Kunde dem Hinweis zustimmt.
Datenschutz-Hinweis im Chat. Leer = der eingebaute Standard-Hinweis wird automatisch (DE/EN) angezeigt; eigener Text überschreibt ihn. Bei aktiver Zustimmungspflicht muss der Kunde vor der ersten Nachricht zustimmen.
Antworten zu Versand, Zahlung, Rückgabe oder Aktionen - frei eingeben oder Kategorien einbeziehen.
Freitext, den der Berater für Fragen zu Versand, Zahlung, Rückgabe oder Rabatten nutzt.
Maximale Zeichen, die pro Shopseite eingelesen werden. 0 = unbegrenzt (Standard). Empfehlung: 4.000 - 8.000 Zeichen pro Seite sind für den Produktberater in der Regel sinnvoll - das deckt die Inhalte ab und hält Tokenverbrauch und Antwortzeit niedrig. Bei sehr vielen Seiten eher 2.000 - 4.000 wählen.
Nur angehakte Felder werden an die KI übergeben und im Chat angezeigt. Felder, die du nicht pflegst, einfach abhaken.
Gibt der KI das Produktbild der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI den Hersteller der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI den Preis samt Streichpreis der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI die Eigenschaften der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI die Varianten-Optionen der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI die Kategorien der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI die Tags der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI die Bewertung der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI EAN und Herstellernummer der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI Inhalt und Einheit der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI Maße und Gewicht der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI die Beschreibung der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Gibt der KI die Zusatzfelder der Produkte mit und zeigt es auf den Karten und in der Detailansicht des Chats. Ausgeschaltet bleibt es an beiden Stellen weg.
Platzierung des Widgets inkl. Pixel-Abstand zur Standardposition.
Wo der Berater im Shop erscheint: auf allen Seiten oder nur auf Produktseiten.
Blendet den Berater auf den Checkout-Seiten (Anmeldung, Bestellübersicht, Abschluss) aus.
Ecke oder Rand des Bildschirms, an dem der Chat-Button sitzt: unten, mittig oder oben, jeweils links, mittig oder rechts.
Legt fest, wo das geöffnete Chatfenster steht - unabhängig von der Sprechblase. Leer = an der Sprechblase ausgerichtet wie bisher.
Abstand zur linken/rechten Bildschirmkante.
Abstand zur Ober-/Unterkante. Erhöhen, um Back-to-Top-Buttons nicht zu überdecken.
Eigene Ecke für Smartphones. "wie Desktop" übernimmt die Desktop-Position.
Abstand zum linken oder rechten Rand auf Smartphones. Leer übernimmt den Desktop-Wert.
Abstand zur Ober- oder Unterkante auf Smartphones. Leer übernimmt den Desktop-Wert.
Farbe für Button, Sprechblasen und Hervorhebungen im Chat.
Öffnet den Chat automatisch nach einigen Sekunden (einmal pro Sitzung), um Besucher aktiv anzusprechen.
Wartezeit bis zum automatischen Öffnen.
Beim automatischen Öffnen auf Produkt- und Kategorieseiten begrüßt der Berater mit einer passenden Frage zum gerade angesehenen Produkt bzw. zur Kategorie.
Lässt den Chat-Button dezent pulsieren, bis er zum ersten Mal geöffnet wird.
Ausgeschaltet erscheint statt des Logos ein Text in der Sprechblase.
Wird angezeigt, wenn das Logo ausgeblendet ist. Leer = sprachabhängiger Standardtext (Produktberatung).
Hintergrund der Sprechblase. Leer = Weiß.
Leer = Akzentfarbe.
Wie viele Nachrichten ein Besucher innerhalb des Zeitfensters senden darf. Gezählt wird je Besuchersitzung; danach muss er warten.
Länge des Zeitfensters für das Rate-Limit in Sekunden.
Anonymisierte Auswertung der Beratungsanfragen.
Logs älter als diese Tage werden automatisch gelöscht. 0 = unbegrenzt.
Zwei Wege, derselbe Funktionsumfang - such dir aus, was besser zu deinem Setup passt.
Alle Preise netto zzgl. USt.
Lade die kostenlose Plugin Suite herunter und spiele sie im Admin ein, ganz ohne SSH. Darüber installierst und aktualisierst du das Plugin mit einem Klick. Die Lizenz kaufst du direkt bei uns, mit Rechnung von uns und Support direkt vom Entwickler.
Im offiziellen Shopware Community Store gelistet. Installation und Updates laufen über den Plugin Manager, die Abrechnung über deinen Shopware-Account. Die Store-Konditionen weichen von unseren ab.
Alle Funktionen im Überblick findest du auf der Produktseite. Für Einrichtung und Feintuning sind wir da.