Shopify-Integration einrichten
Mit der Shopify-Integration liest dein KI-Agent Live-Daten aus deinem Shopify-Store. Kunden, die fragen "Wo ist meine Bestellung?", "Habt ihr das noch auf Lager?" oder "Ist meine Retoure genehmigt?", bekommen sofort eine Antwort, in natürlicher Sprache, 24/7.
Kurz gefasst
Heyloha verbindet sich über eine Custom App mit deinem Shopify-Store. Du richtest es selbst in 5 Minuten aus dem Heyloha-Dashboard ein. Nur-Lesen, verschlüsselt gespeichert, ohne Code.
Was dein Agent jetzt kann
- Bestellstatus abfragen. Der Agent sucht eine Bestellung über die Nummer und antwortet mit Versand- und Tracking-Details.
- Produkte suchen. Der Agent durchsucht deinen Katalog nach Stichwort, Marke oder Typ und liefert bis zu 10 Treffer mit Preis und Verfügbarkeit.
- Bestand prüfen. Der Agent holt Live-Bestände pro Variante ab. Bei niedrigem Bestand sagt er "nur noch wenige da" statt einer exakten Zahl.
- Retourenstatus melden. Der Agent sucht Retouren zu einer Bestellung und meldet den Status in natürlicher Sprache.
Alle vier Funktionen sind nur-lesend. Der Agent kann keine Bestellungen ändern, stornieren oder Bestand anpassen.
Was brauchst du?
- Ein Heyloha-Konto mit mindestens einem angelegten KI-Agenten.
- Admin-Zugang zu deinem Shopify-Store, speziell die Berechtigung, Custom Apps zu erstellen.
- Etwa 5 Minuten.
Du brauchst keinen Entwickler, kein Shopify-Partner-Konto und keinen Code. Der Custom-App-Flow funktioniert auf jedem Shopify-Plan.
Shopify verbinden
Shopify-Einstellungen in Heyloha öffnen
Klicke im Heyloha-Dashboard links auf Einstellungen. Unter Externe Systeme klickst du auf Shopify. Du siehst eine Karte pro Website. Klicke bei der Website, die du anbinden möchtest, auf "Shopify verbinden".
Custom-App-Entwicklung erlauben (nur neue Stores)
Stores ab 2026 haben Custom-App-Entwicklung standardmäßig deaktiviert. Gehe im Shopify-Admin zu Einstellungen → Apps und Vertriebskanäle → Apps entwickeln. Siehst du eine Schaltfläche "Custom-App-Entwicklung erlauben", klicke sie und bestätige.
Custom App in Shopify anlegen
Gehe zu Einstellungen → Apps und Vertriebskanäle → Apps entwickeln und klicke auf "App erstellen". Gib der App einen sinnvollen Namen, zum Beispiel "Heyloha".
Admin-API-Scopes konfigurieren
Klicke auf den Tab Konfiguration und dann auf Konfigurieren neben Admin-API-Integration. Aktiviere genau diese vier Scopes: read_orders, read_products, read_inventory und read_returns. Speichern.
App installieren und Token kopieren
Wechsle zum Tab API-Zugangsdaten und klicke oben auf "App installieren". Danach erscheint der Admin-API-Token (beginnt mit shpat_ und 32 Zeichen). Kopiere ihn sofort: Shopify zeigt den Token nur einmal an.
Shop-Domain und Token in Heyloha einfügen
Füge im Heyloha-Fenster deine Shop-Domain (endet immer auf .myshopify.com, auch bei Custom-Domain) und den Admin-API-Token ein. Klicke auf Verbinden. Die Karte wechselt in den Status Verbunden mit Shop-Domain und Datum.
Token vergessen zu kopieren? Shopify zeigt ihn nur einmal. Du musst die App deinstallieren und neu installieren, um einen neuen Token zu bekommen.
Funktioniert es?
So prüfst du die Verbindung:
- Öffne das Heyloha-Chat-Widget auf deiner Website (oder einen anderen Kanal).
- Stelle eine Frage wie "Verkauft ihr [bekanntes Produkt]?". Der Agent sollte Produkte mit Preis und Verfügbarkeit zurückgeben.
- Frage nach einer eigenen Bestellung (zum Beispiel "Wo ist Bestellung #1001?"). Der Agent antwortet oder fragt zuerst nach der Kunden-E-Mail, je nach Verifizierungs-Einstellung.
Sagt der Agent nach dem Verbinden immer noch "Jemand meldet sich bei dir"? Dann fehlt wahrscheinlich ein Scope oder der Token ist falsch. Siehe Fehlerbehebung weiter unten.
Anbindung verwalten
Pausieren
Schalte den Aktiv-Schalter auf der Karte aus. Der Agent ruft Shopify für diese Website sofort nicht mehr auf. Keine Bestellabfragen, keine Produktsuche. Wieder einschalten ist ein Klick, keine neue Verbindung nötig.
Token rotieren
Auf der verbundenen Karte klickst du auf das Drei-Punkte-Menü und wählst "Token rotieren". Erstelle einen neuen Admin-API-Token in Shopify (gleiche App, Tab API-Zugangsdaten) und füge ihn ein. Der neue Token ersetzt den alten ohne Unterbrechung.
Mach das, wenn der alte Token versehentlich geteilt wurde, ein Teammitglied die App neu installiert hat oder ein Security-Audit regelmäßige Rotation verlangt.
Verbindung trennen
Wähle im Drei-Punkte-Menü Trennen. Heyloha fragt um Bestätigung und zeigt, was der Agent verliert: Bestellstatus, Produktsuche, Bestandsprüfung, Retourenstatus. Nach Bestätigung wird der Token endgültig gelöscht.
Sicherheit
- Der Admin-API-Token wird verschlüsselt gespeichert (AES-256). Der Schlüssel liegt außerhalb der Datenbank.
- Der Token erscheint nie in API-Responses, Logs oder Fehlermeldungen. Bei 401 loggt Heyloha "Auth fehlgeschlagen für Integration X", nicht den Token.
- Der Agent kann nur lesen: keine Änderungen an Bestellungen, Bestand oder Produkten.
- Pro Website isoliert. Ein Agent für Store A kann Store B nicht sehen. Das wird bei jedem Aufruf geprüft.
Fehlerbehebung
"Custom-App-Entwicklung erlauben" fehlt in Shopify
Deine Shopify-Rolle hat keine "Apps entwickeln"-Berechtigung. Der Store-Inhaber (oder ein Admin mit vollen Rechten) muss die Option einmal aktivieren oder deinem Konto die Berechtigung geben.
"Shop-Domain muss auf .myshopify.com enden"
Du hast eine Custom-Domain eingefügt (z. B. www.acme.com) statt der internen Shopify-Domain (acme.myshopify.com). Die interne Domain findest du in Shopify admin → Einstellungen → Domains unter "Shopify-verwaltet".
"Das sieht nicht nach einem gültigen Shopify-Token aus"
Der Token muss mit shpat_ beginnen und 32 hexadezimale Zeichen enthalten. Häufige Fehler: API Key oder API Secret statt Admin-API-Token kopiert, Leerzeichen mitkopiert oder einen Storefront-API-Token verwendet.
Agent sagt immer noch "Jemand meldet sich bei dir"
Mögliche Ursachen: Die Anbindung ist deaktiviert (prüfe die Karte), ein Scope fehlt (siehe Banner) oder der Token wurde in Shopify widerrufen. Installiere die App neu, kopiere den neuen Token und nutze "Token rotieren" in Heyloha.
Häufige Fragen
Funktioniert das auf jedem Shopify-Plan?
Ja. Der Custom-App-Flow ist auf jedem Shopify-Plan verfügbar, inklusive Basic, Advanced, Plus und kostenlosen Trials.
Kann der Agent Bestellungen ändern?
Noch nicht. Alle vier Funktionen sind nur-lesend. Schreibaktionen wie Stornierung oder Rückerstattung sind bewusst noch nicht ausgerollt: sie brauchen stärkere Kundenverifizierung.
Sehen meine Kunden "Shopify" im Chat?
Nein. Der Agent antwortet in natürlicher Sprache ohne das dahinterliegende System zu nennen. Er sagt "deine Bestellung wurde mit DHL verschickt", nicht "laut Shopify ist deine Bestellung...".
CRM- und Webhook-Integrationen einrichtenHubSpot-Integration einrichten