Shopify-Aktionen

Verbinden Sie einen Shopify-Shop mit Ihrem Agenten, und er kann Produktfragen aus Ihrem Live-Katalog beantworten und während einer Unterhaltung den Status einer Bestellung nachschlagen. Das ist etwas anderes als das Einbetten des Chat-Widgets in Ihre Storefront – siehe Shopify-Einbettung dafür.

Zuerst Ihren Shop verbinden

Beide Aktionen benötigen einen verbundenen Shop.

1. Gehen Sie zum Tab Aktionen Ihres Agenten
2. Öffnen Sie Integrationen und suchen Sie die Karte Shopify
3. Geben Sie Ihre Shop-Domain im Format store-name.myshopify.com ein
4. Schließen Sie den Zustimmungsbildschirm von Shopify ab

Die Karte zeigt anschließend den Verbindungsstatus und bietet Erneut verbinden oder Trennen. Wenn die Verbindung Aufmerksamkeit braucht, erscheint ein gelber Hinweisbanner mit einer Aufforderung zum erneuten Verbinden.

Die Verbindung gilt pro Agent. Jeder Agent verbindet seinen eigenen Shop – ein Agent, der für einen anderen Shop antworten soll, erhält also eine eigene Verbindung, statt sich eine zu teilen.

Welcher Zugriff angefordert wird

Auf dem Zustimmungsbildschirm fordert Agentkit genau zwei Lese-Scopes an:

Es werden keine Schreib-Scopes angefordert. Die Verbindung verwendet außerdem Shopifys standardmäßiges Offline-Token – die Anfrage lässt die Option für eine nutzergebundene Berechtigung bewusst aus –, sodass der Agent weiterarbeitet, nachdem sich die Person, die den Shop verbunden hat, abgemeldet hat.

Dies sind die Scopes, die die aktuelle Implementierung anfordert. Shopify entscheidet separat, welche Daten eine App empfangen darf: Manche Kunden- und Bestellfelder sind geschützt, und die Erteilung von read_orders garantiert für sich genommen nicht, dass jedes Feld zurückgegeben wird.

Die beiden Aktionen

Jede Aktion wird einzeln unter Aktionen hinzugefügt und konfiguriert.

Produkte durchsuchen

Lässt den Agenten den Katalog des verbundenen Shops durchsuchen, wenn ein Besucher nach Produkten, Preisen oder Verfügbarkeit fragt. Die Ergebnisse können nach Suchbegriff, einem optionalen Höchstpreis und einer Ergebnisanzahl eingegrenzt werden.

Die Suchergebnisse enthalten nur aktive Produkte, die in Ihrem Onlineshop veröffentlicht sind. Die Verfügbarkeit basiert auf dem produktweiten Bestand in Shopify und berücksichtigt auch Produkte ohne Bestandsverfolgung.

Die Standardanweisung „Wann verwenden“ lautet „Use when the user wants to find products, compare prices, or check whether an item is available.“ Passen Sie sie an, wie Ihre Besucher es tatsächlich formulieren.

Bestellstatus abrufen

Sucht eine einzelne Bestellung. Der Besucher muss sowohl die Bestellnummer als auch die Checkout-E-Mail-Adresse angeben, und beide müssen zur selben Bestellung passen, bevor etwas zurückgegeben wird.

Diese Kombination ist eine Datenschutzmaßnahme: Eine Bestellnummer allein lässt sich leicht erraten oder mitlesen, daher reicht sie nie allein aus. Existiert die Bestellung nicht oder stimmt die E-Mail-Adresse nicht mit der Bestellung überein, erhält der Agent dieselbe allgemeine Antwort „We could not find an order matching those details.“ – er kann nicht erkennen, welcher der beiden Werte falsch war, und der Besucher auch nicht.

Ältere Bestellungen können dieselbe „Nicht gefunden“-Antwort auslösen, selbst wenn Nummer und E-Mail-Adresse korrekt sind: Agentkit fordert Shopifys Standard-Scope read_orders an, der die aktuellen Bestellungen des Shops abdeckt (in etwa die letzten 60 Tage), nicht den separat genehmigten vollständigen Bestellverlauf. Wenn ältere Bestellungen für Ihren Shop relevant sind, rechnen Sie damit, Besucher mit älteren Bestellungen stattdessen an Ihren Support zu verweisen.

Die Standardanweisung „Wann verwenden“ lautet „Use when the user asks for an order status or tracking details and can provide the order number and checkout email.“

Zwei Voraussetzungen, um eine Aktion zu aktivieren

Beides muss zutreffen, bevor eine Aktion eingeschaltet werden kann:

1. Ein verbundener Shop – ohne einen zeigt der Aktivierungsschalter einen Inline-Hinweis mit Link zu Aktionen → Integrationen
2. Ein kostenpflichtiger Plan – dieselbe Voraussetzung wie bei Benutzerdefinierte API, Websuche, Dokumentlinks lesen und den Buchungsaktionen

Sie können beide Aktionen weiterhin erstellen, bearbeiten und speichern, während sie deaktiviert sind und keine der beiden Voraussetzungen erfüllt ist. Die Voraussetzungen gelten nur für das Einschalten.

Fehlerbehebung

OAuth abgeschlossen, aber Bestellabfragen liefern nichts. Prüfen Sie das Bestellnummernformat Ihres Shops und stellen Sie sicher, dass die zum Testen verwendete E-Mail-Adresse die Checkout-E-Mail-Adresse dieser Bestellung ist. Prüfen Sie anschließend die Berechtigung der App für geschützte Kunden- und Bestelldaten in diesem Shop – der Zugriff auf diese Daten muss für die App erforderlich sein und kann von Shopify eingeschränkt werden. Das Anfordern breiterer Scopes ändert daran nichts, und ein erneutes Verbinden garantiert keine Genehmigung.

Der Agent antwortet aus Trainingsinhalten statt aus dem Katalog. Schärfen Sie die Anweisung „Wann verwenden“, damit Fragen zu Produkten, Preisen und Verfügbarkeit eindeutig zur Suchaktion geleitet werden.

Die Karte zeigt eine Warnung zum erneuten Verbinden. Die gespeicherte Autorisierung ist nicht mehr nutzbar. Klicken Sie auf Erneut verbinden und schließen Sie den Zustimmungsbildschirm erneut ab. Ein erneutes Verbinden stellt die Verbindung wieder her, aber nicht die Aktionen: Wenn die gespeicherte Autorisierung fehlschlägt, werden beide Shopify-Aktionen automatisch ausgeschaltet, und der Zustimmungsbildschirm schaltet sie nicht wieder ein. Kehren Sie nach dem erneuten Verbinden zu Aktionen zurück und aktivieren Sie jede Aktion erneut, die aktiv sein soll.

Nächste Schritte

• Chat-Widget zu Ihrer Storefront hinzufügen
• Alle Aktionen entdecken