Holy Grail KI Chatbot
by Holy Grail GmbH
Holy Grail Chatbot für Shopware
> KI-Chatbot mit Produktsuche und Echtzeit-Bestellstatus, direkt in Ihre Shopware-Storefront integriert.
Überblick
Mit dem Holy Grail Chatbot wird Ihr Shopware-Shop zum KI-Einkaufsassistenten, der rund um die Uhr erreichbar ist. Kunden chatten direkt auf der Storefront, finden Produkte, bekommen passende Empfehlungen und können ihren Bestellstatus prüfen, ohne die Seite zu verlassen. Per Webhook-Synchronisation wird die Wissensdatenbank automatisch aktualisiert, damit der Bot immer auf Basis Ihres aktuellen Katalogs antwortet.
Funktionen
1. KI-gestützter Einkaufsassistent
Ein Chat-Widget auf Ihrer Storefront, über das Kunden alles zu Ihrem Shop fragen können. Der Bot:
- Empfiehlt passende Produkte mit Bildern und Preisen.
- Zeigt anklickbare Produktkarten, die direkt zur Produktdetailseite führen.
- Passt sich an Ihre Brand Voice und Ihren Produktkatalog an.
2. Bestellstatusverfolgung über API
Kunden prüfen ihren Bestellstatus direkt im Chat:
- Der Bot fragt Bestellnummer und E-Mail-Adresse ab, um die Identität zu verifizieren.
- Der Echtzeitstatus wird aus der Shopware Order API abgerufen.
- Die Funktion lässt sich in den Plugin-Einstellungen mit einem Schalter aktivieren oder deaktivieren.
3. Automatische Wissensquellen-Synchronisation per Webhook
Die Wissensdatenbank des Chatbots bleibt automatisch mit Ihrem Shop synchron:
- Sobald ein Produkt oder eine Kategorie in Shopware aktualisiert wird, löst Shopware einen Webhook aus.
- Holy Grail crawlt den aktualisierten Inhalt und überträgt ihn in die Wissensquelle.
- Webhook-Endpunkt, Autorisierungstoken und die Webhook-Schalter konfigurieren Sie in den Plugin-Einstellungen.Der Bot fragt Bestellnummer und E-Mail-Adresse ab, um die Identität zu verifizieren.
Konfiguration
Nach der Aktivierung öffnen Sie die Plugin-Einstellungen:
Erweiterungen → Meine Erweiterungen → Holy Grail Chatbot → Konfigurieren
Dort können Sie folgende Optionen anpassen:
- Agent ID: Ihre Holy Grail Agent ID finden Sie auf der Installationsseite in der Holy Grail-App unter „AI Assistants".
- Serverumgebung: `Production` oder `Staging`. Legt fest, welcher Holy Grail-Server Webhooks empfängt und das Chatbot-Skript ausliefert.
- Webhook-Endpunkt: API-Pfad, den Shopware aufruft, wenn sich Produkt- oder Kategorieinhalte ändern. Vorausgefüllt mit Ihrer Holy Grail Webhook-URL.
- Autorisierungstoken: Token zur Autorisierung von Webhook-Aufrufen und Bestellstatus-API-Anfragen zwischen Shopware und Holy Grail.
- Produkt-Webhooks aktivieren: Webhook-Benachrichtigungen ein- oder ausschalten, wenn Produkte erstellt, aktualisiert oder gelöscht werden.
- Kategorie-Webhooks aktivieren: Webhook-Benachrichtigungen ein- oder ausschalten, wenn Kategorien erstellt, aktualisiert oder gelöscht werden.
- Bestellstatus-API aktivieren: Den Echtzeit-Bestellstatus-Endpunkt aktivieren oder deaktivieren, den der Chatbot nutzt.
Speichern Sie die Einstellungen, und der Chatbot erscheint automatisch auf Ihrer Storefront.
> Tipp: Im Holy Grail Dashboard verwalten Sie die Persona des Bots, trainieren individuelle Antworten und können Analysen einsehen.
Anforderungen
- Shopware 6.5 oder höher
- PHP 8.1 oder höher
- Aktives Holy Grail-Konto (https://my.holygrail.app)
- Ausgehende HTTPS-Verbindung von Ihrem Shopware-Server zur Holy Grail API
Support
- E-Mail: hello@holygrail.app
Über Holy Grail
Holy Grail ist eine KI-Agent-Plattform für Online-Händler. Sie hilft dabei, Kundenanfragen schneller zu beantworten und den Einkauf persönlicher zu gestalten. Mehr unter https://www.holygrail.app/.
Changelogs
1.1.0
Shopware version: 6.6, 6.717. August 2026 (vor 1 Monat)
Das vom Plugin platzierte Chatbot-Embed trägt jetzt das Attribut data-channel=shopware. Bisher war das Markup identisch mit dem manuell aus dem Holy Grail Backend kopierten Snippet, sodass die Plattform nicht erkennen konnte, woher eine Widget-Anfrage stammt, und das Abschalten des Shopware-Kanals keine Wirkung hatte. Es ist keine Konfigurationsänderung erforderlich.
1.0.1
Shopware version: 6.6, 6.78. Juli 2026 (vor 2 Monaten)
- Neu: Einstellung „Benutzerdefinierte URL-Parameter" — Chat-Button anpassbar (z. B. button_type=square&width=80&height=40&radius=10) über Parameter an der Chatbot-Skript-URL. Ungültige Eingaben werden sicher ignoriert; unbekannte Werte nutzen die Chatbot-Standardwerte.
- Behoben: Produkt- und Kategorie-Webhooks wurden unter Shopware 6.5 nicht gesendet
- Verbessert: Absicherung der Token-Prüfung der Bestellstatus-API
- Verbessert: Store-Metadaten und Kompatibilität (Beschreibungen, Plugin-Icon)
- Getestet mit Shopware 6.5, 6.6 und 6.7
0.4.4
Shopware version: 6.6, 6.712. Mai 2026 (vor 4 Monaten)
- Erste öffentlich verfügbare Version für den Coderizo Marketplace
