embent

Installationsanleitungen / Shopify

Embent auf Shopify installieren

Ein Script-Tag in deinem Theme-Code, keine App zu installieren. Wenn du den Theme-Editor öffnen kannst, bist du in wenigen Minuten fertig.

Bevor du startest

  • Bearbeitungszugriff auf den Theme-Code deines Shops (du kannst den Code eines Themes erst bearbeiten, nachdem es gekauft/deinem Shop hinzugefügt wurde).
  • Das Widget erscheint nicht auf den Checkout-, Danke- oder Bestellstatus-Seiten von Shopify — Shopify blockiert dort benutzerdefinierte Skripte für Shops, die nicht auf Shopify Plus sind.

Schritte

1

Kopier deinen Embed-Schnipsel

In deinem Embent-Dashboard öffne die Übersicht deines Bots und kopier den Embed-Schnipsel. Er sieht so aus:

<script src="https://api.embent.com/widget.js" data-bot="YOUR_BOT_ID" async></script>
2

Deinen Theme-Code öffnen

Geh in deinem Shopify-Admin zu Online-Shop → Themes. Klick bei deinem aktuellen Theme auf das ⋯-Menü und wähl Code bearbeiten. Shopify empfiehlt, dein Theme zuerst zu duplizieren, da Code-Änderungen, die mit einem späteren Theme-Update nicht kompatibel sind, automatisch entfernt werden.

3

In theme.liquid vor </body> einfügen

Öffne im Layout-Ordner theme.liquid, scroll zum schließenden </body>-Tag am Ende der Datei, und füg den Schnipsel direkt darüber ein. Klick auf Speichern.

Überprüfen, ob es funktioniert hat

Lad deinen Shop (nicht den Checkout) in einem neuen Browser-Tab neu: Die Chat-Blase erscheint in der Ecke. Stell ihr eine Frage zu deinen eigenen Seiten, und sie sollte mit einer Quellenangabe antworten.

Wenn es nicht funktioniert

Ausprobiert, und das Widget zeigt sich nicht? Das hier löst fast jeden Fall.

Ich habe den Embed-Code hinzugefügt, aber das Widget erscheint nicht — keine Chat-Blase, kein Launcher, gar nichts zeigt sich auf meiner WebsiteVier Prüfungen lösen fast jeden Fall von „Widget wird nicht angezeigt“. Erstens: Öffne deine Live-Website, sieh dir den Seitenquelltext an (Rechtsklick → Seitenquelltext anzeigen) und such nach „embent“ — steht das Skript nicht dort, wurde der Code nicht auf einer veröffentlichten Seite gespeichert. Zweitens: Stell sicher, dass die data-bot-ID in deinem Snippet mit der in deinem Dashboard unter Einstellungen angezeigten übereinstimmt. Drittens: Leer den Seiten-Cache deiner Website und jeden CDN-Cache — eine gecachte Seite liefert weiter die alte Version ohne Widget. Viertens: Prüf, ob der Bot im Dashboard nicht pausiert ist: Ein pausierter Bot zeigt Besuchern absichtlich nichts an.
Die Chat-Blase erscheint nicht, und ich nutze eine Speed-Optimierungs-App (Booster, Hyperspeed oder Ähnliches)Speed-Apps, die „JavaScript bis zur Interaktion verzögern“, können das Embent-Skript umschreiben oder aufschieben. Das Widget ist darauf ausgelegt, das zu überstehen, aber falls es weiterhin nicht erscheint, füg „embent“ zur Ausschlussliste der App hinzu — jede dieser Apps hat eine — und lad dann den Shop neu.

Häufige Fragen

Zeigt sich das Widget beim Checkout?Nein. Shopify schränkt benutzerdefinierten Code auf Checkout-Seiten für Shops ein, die nicht auf Shopify Plus sind, daher erscheint das Widget auf deinen Shop-Seiten, aber nicht beim Checkout, Bestellstatus oder auf Danke-Seiten.
Entfernt ein Theme-Update den Schnipsel?Das kann passieren — Shopify entfernt Code-Änderungen, die mit einem Update nicht kompatibel sind, wenn das Theme aktualisiert wird. Duplizier dein Theme, bevor du es anpasst, und prüf den Schnipsel nach jedem Theme-Update erneut.
Brauche ich einen Entwickler oder eine App?Nein. Einen Script-Tag einzufügen reicht — keine App-Installation, und keine Liquid-Kenntnisse über das Finden des schließenden body-Tags hinaus.
Richte Embent jetzt auf deine Website aus.Ein KI-Agent, der lieber „Ich weiß es nicht“ sagt, als sich etwas auszudenken. Kostenloser Plan, keine Kreditkarte nötig — die meisten Websites antworten innerhalb von zwei Minuten.

Die Chat-Blase in der Ecke ist Embent selbst, live auf dieser Seite — frag sie alles über uns.