Shopify-Connector
Funktioniert mit Shopify
Verbinden Sie Shopify mit FreeScout, damit Gespräche passende Kundenbestellungen und Kaufs-Kontext anzeigen. Sie erstellen eine schreibgeschützte Custom App in Ihrem Shopify-Admin und fügen deren Access Token in FreeScout ein, sodass kein Partner-Konto und keine App-Überprüfung erforderlich sind. ReplyRabbit speist außerdem Produktbesitz-Kontext in die KI-Ebene ein, damit Entwürfe darauf verweisen können, was ein Kunde gekauft hat.
Suchen Sie die Übersicht?
Übersicht
Der Shopify-Connector fügt FreeScout-Gesprächen eine Bestell-Seitenleiste hinzu. Wenn ein Gespräch eine Kunden-E-Mail-Adresse hat, fragt der Connector die Shopify GraphQL Admin API Ihres Shops nach passenden Bestellungen ab und zeigt sie neben dem Gespräch an.
Die Seitenleiste zeigt ein Kundenpanel, den vollständigen Bestellverlauf, Positionen pro Bestellung mit Mengen und Preisen, Finanzsummen, Customer Lifetime Value (CLV), Average Order Value (AOV) und Produktbesitz-Berechtigungen, die in den ReplyRabbit-KI-Kontext fließen, für relevantere Entwürfe.
Es ist eine Komponente zu installieren: die FreeScout Shopify-Connector-Modul. Es liest die Shopify GraphQL Admin API über HTTPS mit einem Admin-API-Zugriffstoken aus einer benutzerdefinierten App und rendert dann die Bestell-Seitenleiste. Es hat eine eigene Einstellungsseite pro Postfach in FreeScout.
Die Bestell-Seitenleiste funktioniert eigenständig. Die Produktbesitz-Berechtigung, die in KI-Entwürfe einfließt, ist der Teil, der ReplyRabbit verwendet.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:
- Eine funktionierende FreeScout-Installation.
- Ein Shopify-Shop auf einem
your-store.myshopify.comDomain (oder eine benutzerdefinierte Domain, die auf eine verweist), mit Mitarbeiterberechtigungen zum Entwickeln von Apps. - ReplyRabbit installiert und aktiviert, wenn du Produktbesitz-Kontext in KI-Entwürfen möchtest.
- Eine Shopify Connector-Lizenz (18 EUR einmalig, für eine FreeScout-Installation) oder ein aktiver ReplyRabbit Pro- oder Team-Plan, der sie enthält.
Wenn ReplyRabbit noch nicht installiert ist, beginnen Sie mit So installieren Sie das ReplyRabbit-Modul, dann schließen Sie ab So richten Sie ReplyRabbit ein.
Eine Custom App in Shopify erstellen
Der Connector authentifiziert sich mit einem Admin API-Zugriffstoken aus einer benutzerdefinierten App, die in deinem eigenen Store läuft.
Apps entwickeln öffnen
Gehen Sie im Shopify-Admin zu Einstellungen, dann Apps und Verkaufskanäle, dann Apps entwickeln. Wenn Sie dazu aufgefordert werden, erlauben Sie die Entwicklung benutzerdefinierter Apps.Die App erstellen
Klicken Eine App erstellen, nennen Sie es "ReplyRabbit Connector" und erstellen Sie es.Legen Sie die Admin-API-Bereiche fest
Öffnen Admin-API-Bereiche konfigurieren und aktivieren Sieread_customers,read_orders, undread_products. Aktivieren Sieread_all_ordersebenfalls, wenn Sie Bestellhistorie älter als 60 Tage wünschen. Speichern.Installieren und Token kopieren
Klicken App installieren, dann Token einmal anzeigen und kopieren Sie den Admin-API-Zugriffstoken (es beginnt mitshpat_). Shopify zeigt es nur einmal an, daher sollten Sie es sicher aufbewahren.
Schreibgeschützter Zugriff
Installiere das FreeScout-Connector-Modul
Connector-Modul herunterladen
Laden Sie das FreeScout-Connector-Modul als ZIP herunter von der ReplyRabbit-Dashboard. Der Download erscheint, sobald Sie den Connector gekauft haben oder einen aktiven ReplyRabbit Pro- oder Team-Plan besitzen.In FreeScout hochladen
Gehen Sie in FreeScout zu Module, klicken Sie auf die Upload-Schaltfläche, wählen Sie die ZIP-Datei und installieren Sie sie.Aktivieren Sie das Modul
Aktivieren Sie das Shopify-Integration Modul aus der Modulliste.
Pro Postfach konfigurieren
Öffnen Sie die Connector-Einstellungen
Öffnen Sie in FreeScout das Postfach, das Shopify-Bestelldaten anzeigen soll, öffnen Sie das Postfach-Einstellungsmenü und wählen Sie Store-Connector. Dies ist die Einstellungsseite des Shopify-Connectors, kein Abschnitt innerhalb der ReplyRabbit-Einstellungen.Geben Sie die Store-Domain und das Zugriffstoken ein
Geben Sie Ihre Store-Domain ein, zum Beispielyour-store.myshopify.com, und fügen Sie das Admin-API-Zugriffstoken ein. Speichern. Der Connector prüft das Token und die Berechtigungsbereiche gegen Ihren Shop, bevor er sie speichert; das Token wird verschlüsselt gespeichert und nie wieder angezeigt.Fügen Sie Ihren Connector-Lizenzschlüssel hinzu
Wenn Sie den Connector gekauft haben, legen Sie festSHOPIFYINTEGRATION_LICENSE_KEYin Ihrem FreeScout.envauf ihren Lizenzschlüssel. Überspringen Sie diesen Schritt, wenn ein aktiver ReplyRabbit Pro- oder Team-Plan die Installation abdeckt.Test
Öffnen Sie eine FreeScout-Konversation, bei der die Kunden-E-Mail mit einer Shopify-Bestellung übereinstimmt, und bestätigen Sie, dass die Bestell-Seitenleiste erscheint.
Jedes FreeScout-Postfach speichert seine eigene Store-Domain und seinen Access Token, sodass Sie verschiedene Postfächer mit verschiedenen Stores verbinden können.
Was der Connector zeigt
- Ein Kundenpanel für die Person in der Konversation.
- Vollständiger Bestellverlauf mit Bestellnummer, Datum, Status und Gesamtsumme.
- Positionen pro Bestellung mit Mengen und Preisen.
- Finanzielle Summen (Zwischensumme, Rabatt, Versand, Steuer, Erstattungen).
- Customer Lifetime Value (CLV) und durchschnittlicher Bestellwert (AOV).
- Produkteigentums-Berechtigung für KI-Entwürfe.
So erhalten Sie den Connector
Der Shopify-Connector ist ein kostenpflichtiges Modul. Sie können ihn auf zwei Arten erhalten:
- Kaufen Sie den Shopify Connector für 18 EUR als Einmallizenz für eine FreeScout-Installation und legen Sie dann seinen Lizenzschlüssel als fest
SHOPIFYINTEGRATION_LICENSE_KEYin der FreeScout.env. - Verwenden Sie einen aktiven ReplyRabbit Pro- oder Team-Plan, der den Connector ohne zusätzliche Kosten enthält.
Kaufen Sie die Lizenz oder laden Sie den Connector aus Ihrem ReplyRabbit-Dashboard. Besuchen Sie die Preisseite für ReplyRabbit-Planoptionen. Wenn ein aktiver ReplyRabbit Pro- oder Team-Plan die Installation abdeckt, funktioniert der Connector nach der Konfiguration ohne separaten Lizenzschlüssel.
Fehlerbehebung
| Symptom | Was zu prüfen ist |
|---|---|
| "Shopify hat die Verbindung abgelehnt" beim Speichern | Das Token wurde falsch eingegeben, widerrufen oder gehört zu einem anderen Store. Blenden Sie ein neues Token durch Neuinstallation der Custom App ein und fügen Sie es erneut ein. |
| "Diese Admin-API-Berechtigungsbereiche fehlen" beim Speichern | Öffnen Sie die benutzerdefinierte App und fügen Sie die fehlenden Scopes unter Admin-API-Bereiche konfigurieren, speichern Sie und installieren Sie die App neu. Eine Neuinstallation stellt ein neues Token aus. |
| Store-Domain wird abgelehnt | Verwenden Sie die your-store.myshopify.com Domain oder eine benutzerdefinierte Domain, die darauf verweist. Private Hosts und IP-Adressen werden abgelehnt. |
| Bestell-Seitenleiste erscheint nicht | Bestätigen, dass das Postfach-Panel aktiviert ist und die Verbindung auf der Einstellungsseite als verbunden angezeigt wird. |
| Bestellungen sind für einen bekannten Kunden leer | Bestätigen, dass die Kunden-E-Mail in der FreeScout-Konversation mit der E-Mail in ihren Shopify-Bestellungen übereinstimmt. |
| Nur die Bestellungen der letzten 60 Tage werden angezeigt | Fügen Sie das read_all_orders Umfang auf die Custom App, installieren Sie sie neu und fügen Sie das neue Token ein. |
| Positionen, Finanzdaten oder CLV werden nicht angezeigt | Bestätigen, dass der Lizenzschlüssel des Connectors gespeichert ist oder dass ein aktiver ReplyRabbit Pro- oder Team-Tarif die Installation abdeckt. |
| Produkteigentums-Kontext erscheint nicht in Entwürfen | Bestätigen, dass der Connector lizenziert ist, ReplyRabbit installiert ist, der Connector Bestellungen zurückgibt und die KI-Kontextfunktion für das Postfach aktiviert ist. |
Für umfassendere Probleme siehe Fehlerbehebung bei ReplyRabbit.
Datenschutz und Datenverarbeitung
Wenn der Connector Shopify abfragt, sendet er die Kunden-E-Mail-Adresse über HTTPS mit dem Token Ihrer benutzerdefinierten App an die Shopify GraphQL Admin API. Die von Ihrem Shop zurückgegebenen Bestelldaten füllen die FreeScout-Seitenleiste und bauen mit ReplyRabbit den KI-Kontext für Entwürfe auf.
Die benutzerdefinierte App hat nur Lese-Scopes, sodass der Connector niemals in deinen Store schreibt. Das Zugriffstoken wird verschlüsselt in FreeScout gespeichert, und ausgehende Anfragen verifizieren TLS und folgen keinen Weiterleitungen.
Es werden keine Shopify-Bestelldaten an Dritte gesendet, außer über den für das Postfach ausgewählten KI-Anbieter und nur, wenn die KI-Kontextfunktion sie verwendet. Wenn Ihre Richtlinie verlangt, dass Bestelldaten vollständig auf Ihren eigenen Servern bleiben, verwenden Sie einen lokalen KI-Anbieter (z. B. Ollama) für das Postfach.
Nächste Schritte
- Fertigstellen So richten Sie ReplyRabbit ein wenn die Mailbox noch Anbieter-, Kontext- oder Stileinstellungen benötigt.
- Auch auf WooCommerce oder Magento? Siehe die WooCommerce-Connector und Magento-Connector Anleitungen.
FAQ
Wie verbindet sich der Shopify-Connector mit meinem Shop?
Mit einer benutzerdefinierten App, die Sie im Shopify-Admin erstellen (Einstellungen, Apps und Vertriebskanäle, Apps entwickeln). Geben Sie ihr die Bereiche read_customers, read_orders und read_products, installieren Sie sie und fügen Sie ihr Admin-API-Zugriffstoken zusammen mit Ihrer Shop-Domain in die FreeScout-Connector-Einstellungen ein. Der Connector überprüft das Token gegen Ihren Shop, bevor er es speichert.
Brauche ich ein Shopify-Partnerkonto oder einen App-Store-Eintrag?
Nein. Eine benutzerdefinierte App wird im Admin-Bereich Ihres eigenen Stores erstellt und benötigt kein Partnerkonto, keine App-Prüfung und keinen öffentlichen Eintrag.
Wie viel kostet der Shopify Connector?
Der Shopify-Connector ist in einem aktiven ReplyRabbit Pro- oder Team-Plan enthalten. Andernfalls kostet er 18 EUR als einmalige Lizenz für eine FreeScout-Installation. Wenn Sie ihn kaufen, setzen Sie seinen Lizenzschlüssel als SHOPIFYINTEGRATION_LICENSE_KEY in Ihrer FreeScout-.env.
Warum sehe ich nur Bestellungen der letzten 60 Tage?
Shopify begrenzt Apps auf 60 Tage Bestellhistorie, es sei denn, die App hat den Bereich read_all_orders. Aktivieren Sie read_all_orders bei der Konfiguration der benutzerdefinierten App, um die vollständige Historie zu sehen.
Kann jedes FreeScout-Postfach mit einem anderen Shopify-Shop verbunden werden?
Ja. Jedes Postfach speichert seine eigene Store-Domain und sein Zugriffstoken in den Connector-Einstellungen, sodass verschiedene Stores mit verschiedenen Postfächern verbunden werden können.