Zum Inhalt
Docs
API-Referenz Zum Dashboard
DocsShopify

Shopify-Integration

Installiere Alpheris aus dem Shopify App Store. Die App läuft direkt in deinem Shopify-Admin, liest deinen Shop automatisch ein, und den Chat schaltest du mit einem Klick im Theme-Editor ein.

Was die Shopify-App leistet

Direkt im Shopify-Admin
Die App öffnet sich eingebettet in deinem Shopify-Admin. Ein Passwort brauchst du dafür nicht.
Shop automatisch eingelesen
Produkte, Kollektionen, Seiten, Richtlinien, Versand und aktive Rabatte landen ohne Zutun in der Wissensbasis.
Chat per App-Embed
Den Chat schaltest du im Theme-Editor über das App-Embed Alpheris AI Widget ein – ohne Code.

Einrichtung in 4 Schritten

1
App installieren
Füge die Alpheris-App im Shopify App Store zu deinem Shop hinzu. Shopify zeigt dir, welche Berechtigungen die App braucht (siehe Berechtigungen). Mit Installieren bestätigst du sie.
2
Konto anlegen oder anmelden
Die App öffnet sich direkt in deinem Shopify-Admin. Neu bei Alpheris? Klick auf Kostenlos starten. Hast du schon ein Konto, wähle Schon ein Konto? Anmelden: Du bekommst einen Code per E-Mail, ein Passwort brauchst du nicht.
3
Einrichtung im Admin
Während du die Einrichtung durchgehst, liest Alpheris deinen Shop ein: Produkte samt Varianten und Preisen, Kollektionen, Seiten, Richtlinien, Versand (über deine Märkte) und aktive Rabatte. Du musst dafür nichts hochladen.
4
Chat im Shop einschalten
Auf der Startseite der App steht, solange der Chat noch nicht läuft, Chat im Shop ist noch aus mit dem Link Einschalten. Er öffnet den Theme-Editor mit dem App-Embed Alpheris AI Widget. Schalte es ein und klick auf Speichern – fertig.
Kein Code nötig: Bei Shopify fügst du den Widget-Code nicht von Hand ins Theme ein. Mach das auch nicht zusätzlich zum App-Embed, sonst kann der Chat doppelt erscheinen. Die Domains deines Shops schaltet Alpheris automatisch frei.

Dein Shop bleibt aktuell

Nach dem ersten Einlesen hält Alpheris die Wissensbasis über Shopify-Webhooks aktuell. Einen automatischen Abgleich lösen aus:

  • Produkte: erstellt, geändert oder gelöscht.
  • Kollektionen: erstellt, geändert oder gelöscht.
  • Lagerbestände: geändert.
  • Shop-Daten: etwa eine neue Shop-Domain.
Eingehende Shopify-Webhooks werden per X-Shopify-Hmac-Sha256 geprüft – nur echte, signierte Shopify-Ereignisse lösen etwas aus. Mehr dazu unter Webhooks.

Was der Chat mit deinen Shopify-Daten kann

  • Bestellstatus & Sendungsverfolgung: „Wo ist meine Bestellung?“ beantwortet der Chat mit Bestellnummer und E-Mail-Adresse – inklusive Zahlungs- und Erstattungsstand und Tracking-Link, sobald einer vorliegt.
  • Verfügbarkeit: Der Chat prüft den Bestand live im Shop.
  • Aktionen: Lieferadresse ändern, Bestellung stornieren, Geld erstatten und Rücksendungen – jeweils so, wie du es eingestellt hast.

Für jede Aktion legst du im Dashboard unter KI-Assistent → Shopify im Chat fest, wie weit der Chat gehen darf. Voreingestellt ist überall, dass dein Team entscheidet:

AktionStufen
Lieferadresse ändernAus · Nur als Ticket (Standard, ein Mitarbeiter bestätigt) · Automatisch
Bestellung stornierenAus · Nur als Ticket (Standard) · Automatisch – nur für noch nicht versendete Bestellungen
Geld erstattenAus · Nur als Vorgang (Standard) · Automatisch – nur innerhalb deiner Grenzen (Höchstbetrag, Alter der Bestellung, wahlweise nur unversendete Bestellungen); alles darüber wird ein Vorgang für dein Team
RücksendungAus · Vorgang anlegen (Standard) · Portal-Link sofort · In Shopify anlegen – als Anfrage, freigeben kann nur dein Team in der Inbox
Bevor der Chat etwas an einer Bestellung ändert, bestätigt dein Kunde per Einmalcode, der an die E-Mail-Adresse der Bestellung geht. Welche Daten der Chat dabei nutzt, steht unter Datenquellen & Wissensbasis.

Berechtigungen

Bei der Installation fragt die App diese Berechtigungen (Scopes) an. Shopify zeigt dir die Liste, bevor du bestätigst:

ScopeWofür
read_productsProdukte, Varianten, Preise und Beschreibungen für die Wissensbasis lesen.
read_inventoryLagerbestände lesen, damit der Chat Verfügbarkeiten kennt.
read_ordersBestellstatus, Sendungsverfolgung sowie Zahlungs- und Erstattungsstand abfragen.
write_ordersLieferadresse ändern, stornieren und erstatten – nur, wenn du die jeweilige Aktion einschaltest.
read_customersBestellungen der richtigen Person zuordnen.
read_shippingVersandzonen, Versandarten und Kosten lesen.
read_marketsVersand und Währungen je Markt lesen.
read_contentShop-Inhalte wie Seiten und Blogbeiträge lesen.
read_legal_policiesDie Richtlinien deines Shops lesen (Versand, Rückgabe, AGB, Datenschutz), damit der Chat dazu richtig antwortet.
read_metaobjectsMetaobjekte lesen, etwa zusätzliche Produktangaben.
read_discountsAktive Rabatte lesen, damit der Chat sie korrekt nennt.
read_returnsRücksendungen und rückgabefähige Positionen lesen.
write_returnsEine Rücksendung als Anfrage in Shopify anlegen – nur in der Stufe „In Shopify anlegen“.

Abrechnung über Shopify

Installierst du Alpheris über Shopify, rechnest du auch über Shopify ab:

  • Testphase: 14 Tage voller Zugang, gezählt ab der ersten Installation in deinem Shop. Die Testphase gibt es einmal je Shop – eine erneute Installation startet sie nicht neu. Hattest du schon eine Alpheris-Testphase, kommen keine weiteren Testtage dazu.
  • Tarif wählen: Den Tarif wählst du in der App. Shopify zeigt dir danach eine Bestätigungsseite; erst wenn du dort zustimmst, ist das Abo aktiv. Abgerechnet wird über deine Shopify-Rechnung.
  • Preise: Die aktuellen Tarife und Preise findest du auf der Preisseite.
  • Verwalten & kündigen: jederzeit im Shopify-Admin unter Einstellungen → Apps und Vertriebskanäle.

Zahlst du Alpheris bereits über unsere Website, läuft die Abrechnung dort weiter – Shopify berechnet dann nichts zusätzlich. Mehr zu Tarifen und Rechnungen unter Abrechnung.

Deinstallation: was mit deinen Daten passiert

Deinstallierst du die App in deinem Shopify-Admin, meldet Shopify das an Alpheris:

1
Sofort
Der Zugang zu deinem Shop wird gelöscht, die Shop-Domains werden entfernt und der Chat im Shop antwortet nicht mehr. Shopify beendet dein Abo. Läuft dein Workspace über die Shopify-Abrechnung, wird er deaktiviert; zahlst du über unsere Website, bleiben Chatbot und Inbox bestehen.
2
Mit Shopifys Löschaufforderung
Shopify schickt 48 Stunden nach der Deinstallation eine Löschaufforderung. Dann löschen wir die übrigen Daten deines Shops: Gespräche, Inbox, Kontakte, Wissensbasis und verbundene Postfächer samt gespeicherter E-Mails.

Löschaufforderungen für einzelne Kundinnen und Kunden setzen wir sofort um. Die Einzelheiten stehen in unserer Datenschutzerklärung; zur Auftragsverarbeitung siehe Sicherheit & Datenschutz und den Auftragsverarbeitungsvertrag (AVV).

Häufige Fragen zur Einrichtung

Der Chat erscheint nicht im Shop

  • App-Embed prüfen: Öffne die App. Steht auf der Startseite „Chat im Shop ist noch aus“, klick auf Einschalten, aktiviere Alpheris AI Widget und speichere.
  • Shop neu laden: Lade deine Shop-Seite mit geleertem Cache neu (Strg/Cmd+Shift+R).

Der Chat kennt meine Produkte noch nicht

Das Einlesen läuft im Hintergrund. Bei großen Sortimenten kann es einige Minuten dauern. Weitere Schritte findest du unter Fehlerbehebung.