Shopware 5 anbinden

API-Benutzer mit Leserechten, Plugin hochladen, Caches leeren – getestet mit Shopware 5.7.

Getestet mit: Shopware 5.7.19. Das Plugin ist für 5.2 bis 5.7 freigegeben und braucht PHP 7.0 oder neuer.

Shopware 5 hat keine öffentliche Shop-Schnittstelle wie Shopware 6. Der Assistent liest deshalb alles über die REST-API mit einem eigenen Benutzer.

1. API-Benutzer anlegen

  1. Backend › Einstellungen › Benutzerverwaltung › Reiter Rollen › neue Rolle „KI-Assistent“ mit Leserechten (read) auf: Artikel, Kategorien, Medien, Bestellungen. Keine Schreibrechte.
  2. Reiter Benutzer › Benutzer hinzufügen: Benutzername z.B. shoplyra, Rolle „KI-Assistent“.
  3. Haken bei API-Zugang aktiviert setzen. Der API-Schlüssel erscheint – kopieren.
  4. Im Konto unter Einstellungen › Verbindungen Benutzername und API-Schlüssel eintragen, Verbindung testen.

Wichtig: Die Shop-Adresse muss mit https:// eingetragen sein. Über HTTP würden Zugangsdaten unverschlüsselt übertragen.

2. Script einbinden

Selbst einfügen – im eigenen Theme in frontend/index/index.tpl:

{extends file="parent:frontend/index/index.tpl"}
{block name="frontend_index_after_body"}
    {$smarty.block.parent}
    <script src="https://…/widget.js" data-site="DEINE-BOT-ID" defer></script>
{/block}

Mit unserem Plugin – setzt nur diese Zeile, sonst nichts.

Plugin herunterladen (ZIP, nach Anmeldung)

  1. Backend › Einstellungen › Plugin-Manager › Installiert › Plugin hochladen › ZIP wählen.
  2. Plugin „ShopLyra.de – KI-Chatbot für Onlineshops“ installieren und aktivieren.
  3. Konfiguration (pro Shop möglich): bei Einbindungscode die Zeile aus deinem Konto einfügen.
  4. Einstellungen › Caches/Performance › alle Caches leeren und Theme kompilieren.
  5. Im Konto Einbindung prüfen.

Besonderheiten bei Shopware 5

  • Inhaltsseiten (Versand, AGB, FAQ) liest der Assistent über die Sitemap (/sitemap.xml) und aus den Kategorie-Texten. Stelle sicher, dass die Sitemap erreichbar ist.
  • Produkte einer Kategorie sucht der Assistent über den Kategorienamen, weil die Shopware-5-API nicht nach Kategorie filtern kann. Die Produktsuche selbst ist davon nicht betroffen.
  • Preise werden aus dem Netto-Preis der Kundengruppe EK plus Steuersatz berechnet.
  • Bestellauskunft funktioniert auch für Gastbestellungen, weil der Kunde Bestellnummer und E-Mail-Adresse nennt.

Mehr dazu im Ratgeber