JTL-Shop anbinden

ShopLyra-Plugin für JTL-Shop 5 hochladen, Shop-Kennung eintragen, Zugriffsschlüssel kopieren – Artikel, Bestand und Bestellstatus live. Alternativ über die Exportdatei.

Stand: Das ShopLyra-Plugin läuft mit JTL-Shop 5.2 bis 5.8 und PHP 8.1 oder neuer. Es setzt den Chat in alle Shopseiten und gibt dem Assistenten Live-Zugriff auf deinen Shop: Artikel mit Varianten, Preisen und Bestand, Kategorien, Inhaltsseiten und – wenn du es erlaubst – den Bestellstatus mit Sendungsverfolgung. Die Anbindung ist neu: Melde dich gern im Support, falls in deinem Shop etwas nicht passt.

Die JTL-Wawi gleicht Bestand, Preise und Bestellstatus wie gewohnt mit dem Shop ab. Der Assistent fragt den Shop direkt, er braucht also keinen eigenen Zugang zur Wawi und sieht immer den Stand des letzten Abgleichs.

1. Plugin installieren

Plugin herunterladen (ZIP, nach Anmeldung)

  1. JTL-Shop-Admin › Plugins › Plugin-Manager › Reiter Upload: die ZIP-Datei auswählen und hochladen (nicht entpacken).
  2. Reiter Vorhanden: „ShopLyra.de – KI-Chatbot für Onlineshops“ anhaken und Installieren.
  3. Das Plugin erscheint unter Aktiviert. Mit einem Klick auf den Namen öffnest du es.

Ohne Upload-Recht: Den Ordner shoplyra_chat aus der ZIP per FTP nach plugins/ kopieren, dann im Plugin-Manager unter Vorhanden installieren.

2. Shop-Kennung eintragen (Chat einblenden)

  1. Im ShopLyra-Konto unter Einbindung die Shop-Kennung kopieren (z. B. b1a2b3c4d5e6).
  2. Im Plugin den Reiter Einstellungen öffnen, bei ShopLyra Shop-Kennung einfügen, Chat einblenden auf Ja lassen und speichern.
  3. Optional Chat erst nach Cookie-Einwilligung laden auf Ja stellen – dann wartet der Chat auf dein Consent-Tool (Anleitung im Konto unter Einbindung).
  4. Template-Cache leeren (System › Cache) und im Konto Einbindung prüfen.

Das Plugin setzt vor </body> diese Zeile – sonst nichts:

<script src="https://shoplyra.de/widget.js" data-site="DEINE-SHOP-KENNUNG" defer></script>

3. Zugriffsschlüssel ins ShopLyra-Konto kopieren (Live-Daten)

  1. Im Plugin den Reiter Status und Zugang öffnen. Der Zugriffsschlüssel (beginnt mit slk_) wird beim Installieren automatisch erzeugt.
  2. Kopieren klicken und im ShopLyra-Konto unter Einstellungen › Verbindungen bei Zugriffsschlüssel aus dem ShopLyra-Plugin einfügen.
  3. Verbindung testen. Du siehst die Zahl der Kategorien, einige Artikel mit Bild und ob die Bestellauskunft verbunden ist.

Mit Schnittstelle testen im Plugin prüfst du direkt im JTL-Backend, ob alles erreichbar ist. Läuft dein Shop unter einer anderen Adresse als im Konto angegeben (z. B. in einem Unterordner), trägst du sie unter Shop-Adresse ein.

Neuer Schlüssel: Wurde der Schlüssel versehentlich weitergegeben, erzeugst du im Reiter Status und Zugang einen neuen. Der alte gilt dann sofort nicht mehr – den neuen im Konto eintragen.

Was der Assistent sieht

  • Artikel mit Name, Kurzbeschreibung, Artikelnummer, EAN, Hersteller, Preis inkl. MwSt. für die Standard-Kundengruppe (auch Sonderpreise), Lieferstatus, Bild, Kategorien und Merkmalen.
  • Varianten: Vaterartikel mit allen Kindartikeln (z. B. Farbe/Größe) samt eigenem Preis und Bestand. Fragt ein Kunde nach „Blau in L“, verlinkt der Assistent genau diese Variante.
  • Kategorien, die für Endkunden sichtbar sind.
  • Inhaltsseiten: eigene Seiten, Versandinformationen mit Versandarten und Lieferzeiten, Zahlungsarten, Kontakt, Impressum, ein Auszug aus AGB und Widerrufsbelehrung – auch Texte aus dem OnPage Composer.
  • Große Kataloge: Gesucht wird live in der Shop-Datenbank, es wird nichts vorab kopiert. Das funktioniert auch mit 75.000 Artikeln und mehr.

Ausgeblendete Artikel und Kategorien, Seiten nur für Händler oder nach Login sowie Kundendaten bleiben außen vor. Die Schnittstelle kann nur lesen.

Bestellstatus

Kunden fragen im Chat „Wo ist meine Bestellung?“ und nennen dafür ihre Bestellnummer und E-Mail-Adresse (oder die PLZ). Ohne Bestellnummer geht es mit E-Mail, PLZ und Straße. Unser Server prüft die Angaben – nicht die KI. Nach drei Fehlversuchen ist die Auskunft für das Gespräch gesperrt.

Der Assistent nennt dann:

  • Status: Offen, In Bearbeitung, Bezahlt, Versendet, Teilweise versendet oder Storniert – so, wie die Wawi ihn an den Shop gemeldet hat.
  • Bestelldatum, Summe, Versandart und die bestellten Artikel mit Menge.
  • Sendungsnummern aus den Lieferscheinen und – wenn bei der Versandart in der Wawi eine Tracking-URL hinterlegt ist – den Link zur Sendungsverfolgung.

Namen und Adressen gibt der Assistent nie aus. Zum Prüfen liest ShopLyra nur E-Mail, PLZ und Straße; diese Daten gehen nicht an die KI. Die Bestellauskunft gibt es ab Tarif Starter. Im Plugin kannst du sie unter Einstellungen › Bestellauskunft erlauben jederzeit abschalten.

Alternative ohne Plugin: Exportdatei „Google Shopping“

Wenn du kein Plugin installieren möchtest, liest der Assistent den Katalog aus einem Exportformat:

  1. JTL-Shop-Admin › Exportformate: Vorlage Google Shopping anlegen, Sprache und Kundengruppe wie im Shop, Varianten exportieren aktivieren.
  2. Im Aufgabenplaner täglich oder stündlich exportieren lassen.
  3. Die Adresse der Datei (z. B. https://dein-shop.de/export/google.xml) im Konto unter Einstellungen › Verbindungen bei Exportdatei eintragen und Verbindung testen.
  4. Den Chat selbst einbinden: im Child-Template in layout/footer.tpl die Zeile aus Einbindung vor </body> einfügen, dann den Template-Cache leeren.

Preise und Bestand sind dann so aktuell wie der letzte Export. Inhaltsseiten kommen über die Startseite und Sitemap, eine Bestellauskunft gibt es auf diesem Weg nicht. Sobald ein Zugriffsschlüssel eingetragen ist, nutzt der Assistent das Plugin statt der Exportdatei.

Wenn etwas nicht klappt

  • „Zugriffsschlüssel ist falsch“: Schlüssel im Plugin neu kopieren, auf Leerzeichen am Anfang oder Ende achten. Nach 20 falschen Versuchen sperrt das Plugin die Schnittstelle 15 Minuten.
  • „ShopLyra-Plugin nicht erreichbar“: Ist das Plugin aktiviert? Läuft JTL-Shop 5.2 oder neuer? Die Schnittstelle liegt unter https://dein-shop.de/shoplyra-api/ und braucht dieselbe Weiterleitung auf index.php wie die SEO-Links des Shops.
  • Chat erscheint nicht: Shop-Kennung prüfen, Chat einblenden auf Ja, Template-Cache leeren. Im Reiter Status und Zugang siehst du die Zeile, die das Plugin ausgibt.
  • Wartungsmodus: Solange der Shop im Wartungsmodus ist, antwortet auch die Schnittstelle nicht.

Mehr dazu im Ratgeber