Shopware 6 anbinden
Am einfachsten mit der ShopLyra-App (alles automatisch), sonst Verkaufskanal-Schlüssel, Integration mit Leserechten und Script-Zeile.
Getestet mit: Shopware 6.4, 6.5, 6.6 und 6.7 (Katalog, Inhaltsseiten, Bestellauskunft). Shopware 6.8 ist noch nicht erschienen; die genutzten Schnittstellen sind seit 6.4 stabil.
Empfohlen: die ShopLyra-App
Mit der App entfallen alle Schritte unten – kein Schlüssel kopieren, keine Integration und keine Rollen anlegen, kein Code im Theme.
- Im Konto im Schritt Einbinden auf ShopLyra-App herunterladen klicken. Die ZIP-Datei gilt nur für dein Konto.
- In Shopware unter Erweiterungen › Meine Erweiterungen › Erweiterung hochladen die Datei hochladen.
- Installieren, die angezeigten Berechtigungen bestätigen und aktivieren.
Shopware legt dabei selbst eine Integration an, mit genau den Rechten, die ShopLyra braucht: nur Lesen von Bestellungen, Verkaufskanälen und Domains – Schreibrechte in deinem Shop braucht die App nicht. ShopLyra findet den Verkaufskanal, dessen Domain zu deiner Shop-Adresse passt, holt dessen Zugangsschlüssel, aktiviert die Bestellauskunft und setzt die Script-Zeile ins Theme – auch für weitere Verkaufskanäle desselben Shopware-Shops. Mit derselben App-ZIP lassen sich auch mehrere Shopware-Instanzen eines Kontos verbinden – jede bekommt eigene Zugänge. Nutzt du „Chat erst nach Cookie-Einwilligung laden“, lädt der Chat erst, wenn deine Seite die Einwilligung an ShopLyra meldet. Der Cookie-Banner von Shopware tut das noch nicht von selbst – lass die Option mit der App vorerst aus oder schreib uns, dann richten wir die Meldung ein. Entfernst du die App, trennt ShopLyra die Verbindung sofort.
Shopware Cloud: Ob sich eigene Apps hochladen lassen, hängt vom Cloud-Tarif ab. Klappt der Upload nicht, nutze die Schritte unten oder schreib uns.
Ohne App geht es so:
1. API-Zugangsschlüssel des Verkaufskanals (Pflicht)
Damit liest der Assistent Produkte, Preise, Kategorien und Erlebniswelten – genau so, wie sie im Shop sichtbar sind.
- Administration › Verkaufskanäle › deinen Storefront-Kanal öffnen.
- Bereich API-Zugang › API-Zugangsschlüssel kopieren (beginnt mit
SWSC). - Im ShopLyra-Konto unter Einstellungen › Verbindungen bei API-Zugangsschlüssel des Verkaufskanals einfügen.
Dieser Schlüssel ist ohnehin öffentlich (er steckt in jeder Seite deines Shops) und erlaubt nur das Lesen sichtbarer Inhalte.
2. Integration für die Bestellauskunft (optional)
Nur nötig, wenn der Assistent Fragen wie „Wo ist meine Bestellung?“ beantworten soll.
- Administration › Einstellungen › System › Benutzer & Rechte › Reiter Rollen › Rolle anlegen, Name z.B. „ShopLyra lesen“.
- Rechte: nur Bestellungen › Ansehen. Alles andere aus.
- Einstellungen › System › Integrationen › Integration hinzufügen:
- Name: „ShopLyra“
- Administrator: aus
- Rolle: „ShopLyra lesen“
- Zugangs-ID und Sicherheitsschlüssel kopieren. Der Sicherheitsschlüssel wird nur einmal angezeigt.
- Beides im Konto unter Einstellungen › Verbindungen eintragen und Verbindung testen.
Zeigt der Test „Integration hat keine Leserechte für Bestellungen“, fehlt der Rolle das Recht aus Schritt 2.
3. Script einbinden
Ohne App muss die Zeile aus deinem Konto (Einbindung) vor </body> in jede Seite:
Selbst einfügen – im eigenen Theme in base.html.twig:
{% sw_extends '@Storefront/storefront/base.html.twig' %}
{% block base_body_script %}
{{ parent() }}
<script src="https://…/widget.js" data-site="DEINE-BOT-ID" defer></script>
{% endblock %}
Oder per Google Tag Manager als Tag Benutzerdefiniertes HTML auf allen Seiten.
Mehrere Sprachen oder Verkaufskanäle: Sprachversionen unter derselben Adresse (z. B. /en) bedient ein Assistent automatisch mit und antwortet in der Sprache der Seite. Verkaufskanäle mit eigener Domain bekommen je einen eigenen Assistenten – mit der ShopLyra-App wird jeder automatisch dem passenden Verkaufskanal zugeordnet.