Shopify Integration

Die Lymbe AI Shopify App: Installation, Theme Extension und Bot-Konfiguration.

Übersicht

Die Lymbe AI Shopify App integriert das Chat-Widget nahtlos in deinen Shopify-Store. Die App nutzt Shopify Theme Extensions und erfordert keine manuellen Code-Änderungen.

Anforderungen

  • Shopify Basic Plan oder höher
  • Ein Online Store 2.0 Theme (empfohlen)
  • Ein aktives Lymbe AI Konto

Installation

  1. Besuche den Shopify App Store und suche nach „Lymbe AI"
  2. Klicke auf „App hinzufügen" und bestätige die Berechtigungen
  3. Melde dich mit deinem Lymbe AI Konto an, wenn du dazu aufgefordert wirst
  4. Die App verbindet sich automatisch mit deinem Lymbe AI Tenant

Theme Extension aktivieren

Nach der Installation musst du die Theme Extension in deinem Shopify Theme aktivieren:

  1. Gehe zu Online Store → Themes → Aktuelles Theme → Anpassen
  2. Klicke auf „App-Blöcke" in der Seitenleiste
  3. Aktiviere den „Lymbe AI Chat" Block
  4. Konfiguriere die Einstellungen (Bot, Farbe, Position)
  5. Klicke auf „Speichern"
Ältere ThemesFalls du ein älteres Theme (Vintage) verwendest, das keine App-Blöcke unterstützt, musst du das Widget-Script manuell in die theme.liquid Datei einfügen. Eine Anleitung findest du in den App-Einstellungen.

Bot konfigurieren

In den App-Einstellungen (Apps → Lymbe AI → Einstellungen) kannst du folgendes konfigurieren:

EinstellungBeschreibung
Bot auswählenWähle den Bot für deinen Store
PositionBottom-Right oder Bottom-Left
FarbePrimärfarbe des Widgets
Auf Checkout-Seite anzeigenWidget auch im Checkout anzeigen (Shopify Plus)
Produktdaten sendenAktuelle Produktinfos automatisch an den Bot übergeben
Warenkorb-Daten sendenWarenkorbinhalte für kontextbezogene Antworten bereitstellen

Produktdaten-Integration

Wenn „Produktdaten senden" aktiviert ist, übergibt die App automatisch die aktuellen Produktinformationen an den Bot. So kann der Bot Fragen wie „Ist dieses Produkt auf Lager?" oder „Welche Größen gibt es?" beantworten.

product-context.jsonjson
{
  "currentProduct": {
    "title": "Premium T-Shirt",
    "price": "29.99",
    "currency": "EUR",
    "available": true,
    "variants": ["S", "M", "L", "XL"],
    "url": "/products/premium-t-shirt"
  }
}

Manuelle Einbindung (Legacy)

Falls du das Widget ohne die App einbinden möchtest, füge den folgenden Code in deine theme.liquid Datei ein:

theme.liquidhtml
{% comment %} Lymbe AI Chat Widget {% endcomment %}
<script
  src="https://app.lymbe.ai/widget.js"
  data-bot-id="DEINE_BOT_ID"
  data-position="bottom-right"
  data-color="#09CC78"
></script>

Troubleshooting

  • Widget nicht sichtbar? Prüfe, ob die Theme Extension aktiviert ist
  • Falsche Daten? Leere den Shopify Theme-Cache unter Online Store → Themes → Aktionen → Cache leeren
  • App-Block nicht verfügbar? Stelle sicher, dass du ein Online Store 2.0 Theme verwendest
  • Checkout-Widget (Plus): Erfordert Shopify Plus und muss separat unter Einstellungen → Checkout aktiviert werden