Chat-Widget in Shopify einbinden
Bring die intoCHAT-Chat-Bubble in deinen Shopify-Shop: ein Script-Tag in theme.liquid einfügen und den Shop verbinden, damit der Agent Produkte durchsucht.
In Shopify fügt die intoCHAT-App die Chat-Bubble als App-Einbettung hinzu: Du schaltest sie im Theme-Editor ein und musst keinen Theme-Code anfassen. Die Bubble und die Produktsuche funktionieren auch ohne App, mit den öffentlichen Daten deines Shops und ganz ohne API-Key; dann fügst du stattdessen ein einziges Script-Tag in dein Theme ein. Damit der Agent Bestellungen abfragen kann, installiere die Shopify-App.
Mit der Shopify-App einschalten (ohne Code)
Wenn du die Shopify-App installierst, musst du dein Theme nicht bearbeiten:
- Klicke im Tab Share deines Agenten unter Website auf der Karte Your Shopify store auf Turn on in your theme (derselbe Button ist auf der Karte Orders im Tab Actions). Shopify öffnet den Theme-Editor, und unter App-Einbettungen ist intoCHAT Chat-Bubble eingeschaltet.
- Klicke auf Speichern. Die Bubble erscheint auf jeder Seite deines Shops.
Du findest sie auch selbst unter Onlineshop → Themes → Anpassen → App-Einbettungen. Die Einbettung zeigt den Agenten, auf dem du die App installiert hast; für einen anderen Agenten fügst du seine ID in der Einstellung Agenten-ID ein. Sie bleibt bei einem Theme-Update erhalten und verschwindet, wenn du die App deinstallierst.
Ohne die App fügst du stattdessen das Snippet ein, wie unten beschrieben.
Snippet kopieren
Öffne den Tab Share deines Agenten. Klicke auf der Karte Shopify auf Copy Code. Es ist dasselbe Script wie auf der Karte Bubble Chat, deine Agenten-ID ist bereits enthalten:
<script src="https://www.intochat.ai/api/embed.js" data-chatbot-id="YOUR_AGENT_ID"></script>
Ins Theme einfügen
- Gehe im Shopify-Admin zu Onlineshop → Themes.
- Klicke neben deinem aktuellen Theme auf ⋯ und wähle Code bearbeiten.
- Öffne im Ordner Layout die Datei
theme.liquid. - Füge das Snippet direkt über
</body>ein und klicke auf Speichern. - Öffne deinen Shop. Die Chat-Bubble erscheint unten in der Ecke jeder Seite, die dieses Layout nutzt, mit den Farben und der Position aus dem Tab Appearance.
Direkt über </body> ist der empfohlene Platz, das Snippet funktioniert aber auch im <head>-Bereich von theme.liquid. Steht es zweimal im Theme, erscheint trotzdem nur eine Bubble.
Produkte durchsuchen lassen
- Öffne den Tab Actions (Aktionen) und wähle Connect your website.
- Füge die Adresse deines Shops ein. intoCHAT erkennt Shopify und legt zwei Aktionen an: Search products mit bis zu fünf Treffern pro Suche und Get product details mit Varianten, Preisen und Lagerbestand.
- Teste im Playground: Frag nach einem Produkt, einem Preis oder ob etwas vorrätig ist. Die Antworten zeigen Produktkarten mit Bild, Preis und Link zur Produktseite.
Die Produkte werden live gesucht, während Besucher chatten. Neue Produkte und Preisänderungen erscheinen also ohne neues Training. Diese Verbindung liest nur öffentliche Produktdaten. Bestellungen, Warenkörbe und Kundendaten sieht sie nicht, und der Agent kann nicht im Chat zur Kasse gehen; stattdessen verweist er auf die passende Seite. Für Bestellabfragen brauchst du die Shopify-App.
Ist dein Shop passwortgeschützt, sieht der Agent keine Produkte. Entferne das Passwort unter Onlineshop → Präferenzen und verbinde den Shop erneut. Details unter Shop verbinden.
Shopify-App installieren
Die intoCHAT-Shopify-App gibt deinem Agenten Lesezugriff auf die Bestellungen deines Shops, damit er Fragen wie „Wo ist meine Bestellung?“ beantworten kann. Sie ist unabhängig von der Chat-Bubble und der Produktsuche oben, die auch ohne sie weiter funktionieren.
- Öffne den Tab Actions deines Agenten und such die Karte Orders.
- Gib die Shopify-Adresse deines Shops ein:
your-storeoderyour-store.myshopify.com. Du findest sie im Shopify-Admin unter Einstellungen → Domains. Deine eigene Domain, etwayourstore.com, funktioniert hier nicht. - Klicke auf Install on Shopify. Shopify öffnet den Admin deines Shops und listet die Zugriffe auf, die intoCHAT anfragt.
- Bestätige die Installation. Shopify schickt dich zurück zum Tab Actions, der anzeigt, ob es geklappt hat.
Nur der Kontoinhaber und Admins können die App installieren, weil sie den Zugriff auf deinen Shop speichert. In Shopify brauchst du die Berechtigung, Apps zu installieren. Jeder Agent verbindet sich mit einem Shop; installierst du die App in einem anderen Shop, ersetzt das die bisherige Shop-Verbindung des Agenten.
In der Karte Orders legst du fest, was der Agent mit Bestellungen tut, etwa Rücksendeanfragen annehmen.
Welche Zugriffe die App anfragt
- Bestellungen lesen (
read_orders): um Status, Artikel, Versand und Sendungsverfolgung einer Bestellung abzufragen, wenn ein Kunde im Chat danach fragt.
Das ist alles. Die App kann keine Bestellungen anlegen, ändern, stornieren oder erstatten, und sie fragt nicht nach deinen Produkten, deiner Kundenliste, Zahlungen oder Shop-Einstellungen. Shopify lässt Apps mit diesem Zugriff die Bestellungen der letzten 60 Tage lesen, ältere kann der Agent also nicht abfragen.
intoCHAT über Shopify bezahlen
Sobald die App in deinem Konto installiert ist, wird dein Tarif über Shopify abgerechnet statt per Karte. Wähle unter Settings → Billing Starter oder Pro, monatlich oder jährlich: Shopify öffnet den Admin deines Shops, du bestätigst die Gebühr, und sie erscheint auf deiner Shopify-Rechnung. Die 7-tägige Testphase von Starter funktioniert genauso. Für einen Tarifwechsel wählst du einen anderen Tarif und bestätigst ihn in Shopify; um nicht mehr zu zahlen, wähle Free. Die Preise sind in US-Dollar, Shopify rechnet sie in die Abrechnungswährung deines Shops um. Ein Tarif, den du schon per Karte zahlst, bleibt auf deiner Karte.
Du kannst auch in Shopify beginnen: Öffnest du intoCHAT aus dem Shopify-Admin, meldest du dich an (oder legst ein Konto an), und die App wird auf deinem zuletzt bearbeiteten Agenten installiert, oder auf einem neuen Agenten für deinen Shop, wenn du noch keinen hast.
App deinstallieren
Gehe im Shopify-Admin zu Einstellungen → Apps, öffne intoCHAT und wähle Deinstallieren. Shopify informiert intoCHAT sofort, und intoCHAT löscht die Shop-Verbindung und die Rücksendeanfragen, die aus Chats mit diesem Shop gespeichert wurden. Chat-Bubble und Produktsuche sind davon nicht betroffen. Um wieder zu verbinden, installiere die App über die Karte Orders.
intoCHAT erneuert den Zugriff der App selbst, solange der Agent sie nutzt. Fragt der Agent 90 Tage lang keine Bestellung ab, beendet Shopify diesen Zugriff, und die Karte Orders bittet dich, die App erneut zu installieren.
Wie intoCHAT mit den Daten deines Shops umgeht
- Gespeichert: die Adresse deines Shops, die Zugriffe, die du bestätigt hast, und die Zugriffstokens der App, verschlüsselt.
- Nicht gespeichert: Bestellungen und Kundendatensätze. Der Agent liest eine Bestellung bei Shopify, während er im Chat antwortet, und behält keine Kopie.
- Rücksendeanfragen: Lässt du den Agenten welche annehmen, wird jede Anfrage mit der E-Mail-Adresse und der Bestellnummer des Kunden gespeichert und an dich geschickt.
- Chat-Verläufe: Was Kunden schreiben, wird mit deinen anderen Gesprächen im Tab Activity aufbewahrt, wo du ein Gespräch löschen kannst.
Shopify gibt Datenschutzanfragen an die Apps weiter, die in deinem Shop installiert sind, und intoCHAT behandelt sie so:
- Ein Kunde fragt nach seinen Daten: intoCHAT schickt dir, dem Kontoinhaber, per E-Mail, was es über ihn gespeichert hat, damit du antworten kannst. Shopify erwartet deine Antwort innerhalb von 30 Tagen.
- Ein Kunde möchte gelöscht werden: intoCHAT löscht seine Rücksendeanfragen für deinen Shop.
- Die Daten deines Shops werden gelöscht (Shopify fragt 48 Stunden nach der Deinstallation an): intoCHAT löscht alles, was zu dem Shop noch übrig ist.
Mit den Inhalten deines Shops trainieren
Gib im Tab Knowledge (Wissen) die Adresse deines Shops ein und wähle deine Versand-, Rückgabe- und FAQ-Seiten aus. Lade Größentabellen oder Richtlinien als Dateien hoch und lege Q&A-Paare für Antworten an, die genau so formuliert sein müssen.
Fehlerbehebung
- Keine Bubble im Shop. Prüfe, ob du das veröffentlichte Theme bearbeitet hast und nicht eine Kopie, und ob das Snippet in
theme.liquidüber</body>steht. - „Chatbot not found.“ in der Browserkonsole. Die Agenten-ID im Snippet stimmt nicht. Kopiere sie erneut aus dem Tab Share.
- „Connect your website“ schlägt fehl. Prüfe, ob die Adresse deine öffentliche Storefront ist und der Shop nicht passwortgeschützt ist.
- „Install on Shopify“ meldet, die Adresse sei ungültig. Nutze die
.myshopify.com-Adresse aus Einstellungen → Domains, nicht deine eigene Domain. - „Shopify app wasn't installed“. Die Meldung nennt den Grund. Hat die Installation länger als 10 Minuten gedauert oder hast du zwischendurch das intoCHAT-Konto gewechselt, starte erneut über die Karte Orders.
Weitere Fälle findest du unter Fehlerbehebung. Was der Agent in einem Shopify-Shop kann, zeigt die Shopify-Integrationsseite.