Integrationen
Erste Schritte mit Shopify
Verbinden Sie Ihren Shopify-Shop, damit die KI und die Agenten von HelpStack Fragen zu Bestellungen, Sendungsverfolgung und Produkten beantworten und optional ein Live-Chat-Widget auf Ihrer Storefront anzeigen können.
Was Sie bekommen#
| Bestellabfragen | Die KI beantwortet „Wo ist meine Bestellung?" und „Wie lautet die Tracking-Nummer?" mit Live-Daten aus Shopify |
| Produktfragen | Kunden fragen nach Produkten; die KI ruft die Details direkt aus Ihrem Shop ab |
| Kundenverlauf | Agenten sehen Bestellsummen, Versandstatus und Ausgabenverlauf in der Konversations-Seitenleiste |
| Storefront-Widget | Eine optionale Chat-Blase in Ihrem Shop, damit Kunden Fragen stellen können, ohne die Seite zu verlassen |
Keine technischen Kenntnisse erforderlich. Die folgenden Schritte dauern etwa 10–15 Minuten und erfordern nichts weiter, als sich durch ein paar Einstellungsseiten zu klicken.
Schritt 1 — Ihren Shop verbinden#
- Gehen Sie in Ihrem HelpStack-Dashboard zu Einstellungen → Integrationen.
- Suchen Sie die Shopify-Karte und klicken Sie auf Shopify verbinden.
- Geben Sie die
.myshopify.com-Domain Ihres Shops ein, zum Beispielyour-store.myshopify.com, und klicken Sie auf Verbinden. - Sie werden zu Shopify weitergeleitet. Klicken Sie auf Install (oder Approve), um HelpStack lesenden Zugriff auf Ihre Bestellungen, Kunden und Produkte zu gewähren.
- Sie landen wieder in HelpStack mit einem grünen Verbunden-Status.
Das war's schon. Ab sofort sehen Agenten bei jeder Konversation ein Bestellungen-Panel in der Seitenleiste, und die KI kann Bestell- und Produktfragen beantworten.
Schritt 2 — Bestell- und Kundendaten freigeben (einmalig)#
Shopify verlangt eine separate Genehmigung, bevor eine App Bestell- und Kundendetails lesen darf. Bis das erledigt ist, antwortet die KI auf Bestellfragen mit „Zugriff eingeschränkt"; Produktfragen funktionieren auch ohne diese Genehmigung.
- Öffnen Sie das Shopify-Partner-Dashboard unter dev.shopify.com und melden Sie sich an.
- Klicken Sie in der linken Seitenleiste auf Apps und wählen Sie die HelpStack-App aus.
- Gehen Sie zu API access (oder App setup → API access).
- Suchen Sie Protected customer data access und klicken Sie, um es zu öffnen.
- Aktivieren Sie das Order-Objekt und markieren Sie Name, Email und Phone.
- Schreiben Sie als Grund:
customer service — agents look up order status for shoppers. - Klicken Sie auf Save und warten Sie auf die Genehmigung von Shopify (für neue Apps in der Entwicklung normalerweise sofort).
Das machen Sie nur einmal. Die Berechtigung gilt auf App-Ebene und bleibt über Updates hinweg bestehen.
Schritt 3 — Das Chat-Widget auf Ihrer Storefront anzeigen (optional)#
Dieser Schritt fügt eine Chat-Blase zu Ihrem Shopify-Shop hinzu, damit Kunden Fragen stellen können, ohne die Seite zu verlassen. Überspringen Sie diesen Schritt, wenn die KI nur Fragen beantworten soll, die über andere Kanäle eingehen (E-Mail, Instagram und so weiter).
3a — Das Widget in HelpStack aktivieren
- Gehen Sie zu Einstellungen → Integrationen und öffnen Sie den Bereich Storefront-Widget.
- Aktivieren Sie den Schalter Storefront-Widget aktivieren.
- Wählen Sie unter Standardkanal den Website-Chat-Kanal aus, den Sie verwenden möchten. (Legen Sie zuerst einen unter Einstellungen → Kanäle an, falls Sie das noch nicht getan haben.)
- Optional können Sie sprachspezifische Zeilen hinzufügen: Kunden, deren Browser auf diese Sprache eingestellt ist, werden zu einem anderen Kanal geleitet. Nicht zugeordnete Sprachen verwenden den Standardkanal.
- Klicken Sie auf Speichern.
3b — Das Widget zu Ihrem Theme hinzufügen
Wählen Sie eine der beiden folgenden Methoden:
Option A — App embed (empfohlen, kein Code)
Mit der Methode App embed können Sie das Widget mit einem einzigen Klick im Shopify-Theme-Editor ein- und ausschalten. Es sind keine Code-Änderungen nötig. Dies funktioniert mit allen Online Store 2.0-Themes.
-
Gehen Sie in Ihrem Shopify-Adminbereich zu Online Store → Themes.
-
Klicken Sie neben Ihrem aktiven Theme auf das Stift-Symbol (Edit) oder auf Customize.

Shopify-Adminbereich: Online Store → Edit theme -
Suchen Sie im sich öffnenden Theme-Editor in der linken Seitenleiste nach dem Bereich App embeds (Puzzle-Symbol, weiter unten).
-
Suchen Sie in der Liste HelpStack Chat und schalten Sie es auf ON.

HelpStack Chat App embed im Theme-Editor aktivieren -
Klicken Sie oben rechts im Theme-Editor auf Save.
Die Chat-Blase erscheint sofort auf Ihrer Storefront.
Option B — Manuelles Snippet
Verwenden Sie diese Methode, wenn Ihr Theme keine App embeds unterstützt (ältere Debut- oder Brooklyn-Themes).
-
Gehen Sie in HelpStack zu Einstellungen → Integrationen und kopieren Sie das Snippet, das im Bereich Storefront-Widget angezeigt wird. Es sieht so aus:
<script src="https://helpstack.eu/api/shopify/storefront-widget.js?shop=your-store.myshopify.com" async></script> -
Gehen Sie in Ihrem Shopify-Adminbereich zu Online Store → Themes → Edit code.
-
Öffnen Sie
theme.liquid(im Ordner Layout). -
Fügen Sie das Snippet direkt vor dem schließenden
</body>-Tag ein. -
Klicken Sie auf Save.
Problembehandlung#
| Problem | Was zu prüfen ist |
|---|---|
| Chat-Widget wird auf der Storefront nicht angezeigt | Haben Sie in HelpStack gespeichert (Schritt 3a)? Ist App embed im Theme-Editor auf ON geschaltet und gespeichert (Option A)? Oder ist das Snippet vor </body> eingefügt (Option B)? |
| KI antwortet bei Bestellfragen mit „Zugriff eingeschränkt" | Schließen Sie Schritt 2 ab: Die Protected-customer-data-Freigabe fehlt oder ist noch ausstehend |
| Kunden in einer bestimmten Sprache sehen den falschen Kanal | Fügen Sie unter Einstellungen → Integrationen → Storefront-Widget eine Zeile für diese Sprache hinzu |
| Widget lädt, zeigt aber die falsche Sprache | Die Locale-Zuordnung verwendet die Browsersprache des Kunden. Fügen Sie in den Storefront-Widget-Einstellungen eine Zeile für diesen Sprachcode hinzu |