Shopware-Chatbot: Kyros in Shopware 6 einbauen

Kyros lässt sich in Shopware 6 einbauen, aber nicht per Klick. Es gibt weder ein Kyros-Plugin noch eine Kyros-App, und Shopware hat in der Administration kein Feld für eigene Scripts. Für die schwebende Chat-Blase auf allen Seiten braucht ein selbst gehosteter Shop deshalb eine kleine Twig-Template-Erweiterung in seinem Theme oder in einem Plugin – eine Aufgabe für Ihren Entwickler. Shopware-Cloud-Shops können keine Plugins nutzen; dort wäre dafür eine App nötig. Ohne Entwicklung lässt sich der Inline-Frame platzieren, über das HTML-Element in den Erlebniswelten (englisch: Shopping Experiences). Ob der HTML-Sanitizer den Code dort unverändert lässt und ob das in der Shopware Cloud genauso klappt, ist nicht eindeutig dokumentiert: Bitte testen Sie das vor dem Livegang. Unter den Plattformen in unseren Einbau-Anleitungen ist Shopware damit die aufwendigste.

Was der Chatbot in Ihrem Shop beantwortet

Was der Assistent weiß, legen Sie in Kyros fest. Sie fügen die URLs der Shop-Seiten ein, die er kennen soll, eine pro Zeile: Versand, Zahlung, Retouren, FAQ, auf Wunsch auch einzelne Produktseiten. Dazu kommen Goldene Antworten, die Sie selbst formulieren, etwa zu Lieferzeiten. Stützt sich eine Antwort auf Ihre Seiten, stehen darunter nummerierte Quellenlinks unter „Weiterführende Links“. Findet sich in Ihren Inhalten keine Antwort, ist der Assistent angewiesen, das zu sagen.

Kyros ist dabei nicht mit Shopware verbunden. Der Chatbot sieht keine Bestellungen, keine Kundenkonten und keinen Produktkatalog, nur die Seiten, die Sie auflisten. „Wo ist meine Bestellung?“ kann er deshalb nicht selbst beantworten. Dafür bräuchten Sie eine eigene Schnittstelle, die eine Interaktive Card (Beta) per Aktion aufruft.

Shopware KI: Copilot oder Chatbot?

Wer nach „Shopware KI“ sucht, landet oft beim Shopware Copilot. Laut Shopware-Dokumentation ist er ein chatbasierter KI-Assistent, der Ihnen hilft, Ihren Shop zu verwalten. Er läuft nur in der Administration (Shopware 6.7), mit einem begrenzten kostenlosen Monatskontingent; wer mehr braucht, nutzt Shopware Intelligence+. Mit Ihrer Kundschaft chattet der Copilot nicht, und einen Chatbot für die Storefront beschreibt die Dokumentation nicht (Stand: 1. Oktober 2026). Chatbots für Shopbesucher gibt es als Erweiterungen von Drittanbietern im Shopware Store – oder als eingebettete Lösung wie Kyros.

Wenn Sie den Chatbot per Klick aus dem Shopware Store installieren möchten, ist eine Store-Erweiterung der einfachere Weg. Und wenn er Bestellungen ohne eigene Entwicklung nachschlagen soll, ist Kyros nicht die richtige Wahl.

1. Code in Kyros kopieren

1. Öffnen Sie bei Ihrem Assistenten „Bereitstellen“ und klicken Sie auf „Widget installieren“.
2. Wählen Sie „Schwebende Blase“ für den Chat auf allen Seiten oder „Inline-Frame“ für einen Chat an einer festen Stelle. Eine eigene Shopware-Anleitung hat Kyros nicht; nehmen Sie den HTML-Code.
3. Unter „Website-Zugriff“ legen Sie fest, auf welchen Domains sich der Chat öffnen lässt; tragen Sie dort die Domain Ihres Shops ein, für Tests vorübergehend auch die Domain Ihrer Testumgebung. Auf anderen Domains erscheint zwar der Chat-Button, das Chatfenster lädt dort aber nicht.
4. Unter „Code-Ablauf“ können Sie festlegen, ob und wann der signierte Code abläuft.

Der Code für die schwebende Blase hat diese Form; Ihre Werte für id und sig stehen in Kyros:

<script src="https://kyros.omniratio.de/api/widget?id=…&sig=…&type=chatbot"></script>

2a. Chat-Blase per Twig-Template (selbst gehosteter Shop)

Shopware beschreibt im Entwickler-Leitfaden „Add JavaScript as Script Tag“, wie ein externes Script über ein Template in die Storefront kommt. Ihr Entwickler erweitert dafür in Ihrem Theme oder Plugin das Template meta.html.twig und ergänzt im Block layout_head_javascript_hmr_mode nach {{ parent() }} das Kyros-Script:

{% sw_extends '@Storefront/storefront/layout/meta.html.twig' %}

{% block layout_head_javascript_hmr_mode %}
    {{ parent() }}
    <script src="https://kyros.omniratio.de/api/widget?id=…&sig=…&type=chatbot"></script>
{% endblock %}

Als Alternative nennt der Leitfaden den Block base_body_script in storefront/base.html.twig für Scripts im Body, ausdrücklich nur, wenn das technisch nötig ist. Voraussetzung ist laut Shopware ein laufendes Plugin und voller Dateizugriff. Leeren Sie danach den Cache, in der Administration unter Settings › System › Caches & Indexes (englische Oberfläche) oder per php bin/console cache:clear, und prüfen Sie die Blase zuerst auf einer Testumgebung.

2b. Inline-Frame über Erlebniswelten (ohne Entwicklung)

1. Öffnen Sie in der Administration die „Erlebniswelten“ und dort das Layout der Seite, auf der der Chat erscheinen soll, zum Beispiel Ihre Hilfe- oder Kontaktseite.
2. Fügen Sie ein Element aus der Blockkategorie „HTML“ ein und setzen Sie den Inline-Frame-Code hinein.
3. Speichern Sie und prüfen Sie die Seite im Shop: Erscheint der Chat vollständig?

Der Inline-Frame-Code hat diese Form; kopieren Sie den vollständigen Code aus Kyros:

<iframe src="https://kyros.omniratio.de/embed/widget/…?sig=…" width="100%" height="600px" allow="microphone; camera; autoplay" style="border: none; border-radius: 16px;"></iframe>

Bitte testen: Seit Shopware 6.5 entfernt ein HTML-Sanitizer als unsicher eingestuften HTML-Code. Die Shopware-Dokumentation zu den Erlebniswelten rät, den Sanitizer entsprechend zu konfigurieren oder zu deaktivieren, sonst können Tags oder Attribute verloren gehen. Laut den Release Notes zu 6.6.1.0 soll das neue HTML-Element dagegen nicht mit der Bereinigung kollidieren. Auch bei der Version widersprechen sich die Quellen: Die Release Notes nennen 6.6.1.0, die Nutzer-Dokumentation 6.4.0.0. Im selbst gehosteten Shop konfiguriert Ihr Entwickler den Sanitizer in config/packages/z-shopware.yaml; ihn ganz abzuschalten, rät Shopware dringend ab. In Cloud-Shops lässt er sich derzeit nicht anpassen. Ein <script> im HTML-Element ersetzt die Chat-Blase nicht: Ob es auf der Storefront ausgeführt wird, ist nicht dokumentiert.

2c. Shopware Cloud

Laut Shopware-Entwicklerdokumentation sind Plugins mit Cloud-Shops nicht kompatibel; dort erweitern Sie den Shop mit einer App. Apps können die Storefront anpassen, also Templates ändern und eigenes JavaScript ergänzen. Eine Kyros-App gibt es nicht. Für die Chat-Blase müsste ein Entwickler deshalb eine eigene App für Ihren Shop bauen. Für den Inline-Frame gilt: Prüfen Sie, ob das HTML-Element der Erlebniswelten in Ihrem Cloud-Shop verfügbar ist und den Code durchlässt.

Vor dem Livegang prüfen

• Cookie-Einwilligung: Der Cookie-Manager von Shopware blockiert Scripts nicht von selbst. Einen Cookie dort zu registrieren, zeigt ihn laut Shopware vor allem im Manager an. Soll Kyros erst nach Einwilligung laden, muss Ihr Entwickler das umsetzen.
• Content-Security-Policy: Shopware stellt Standard-Richtlinien über den Container-Parameter shopware.security.csp_templates ein. Sendet Ihre Website eine Content-Security-Policy, muss sie Inhalte von kyros.omniratio.de zulassen, sonst blockiert der Browser das Widget. Was blockiert wird, zeigt die Konsole der Entwicklertools.
• Test auf allen Geräten: Prüfen Sie Blase oder Inline-Frame auf dem Smartphone und am Desktop, auch zusammen mit Ihrem Cookie-Banner.