Magento-Connector
Funktioniert mit Magento
Verbinden Sie Magento 2 oder Adobe Commerce mit FreeScout, damit Gespräche passende Kundenbestellungen und Kaufs-Kontext anzeigen. Ein kleines schreibgeschütztes Magento-Modul stellt eine Support-Zusammenfassung über die Magento REST API bereit, und der FreeScout-Connector zeigt sie in der Gesprächs-Seitenleiste an. 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 Magento-Connector fügt FreeScout-Gesprächen eine Bestell-Seitenleiste hinzu. Wenn ein Gespräch eine Kunden-E-Mail-Adresse hat, ruft der Connector die moo-support/summary Endpunkt in Ihrem Magento-Shop zum Abgleichen von Bestellungen und zeigt sie neben der Konversation 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 sind zwei Komponenten zu installieren:
- Die ReplyRabbit Connector-Modul für Magento 2. Es fügt zwei schreibgeschützte REST-Endpunkte hinzu (
/rest/V1/moo-support/summaryund/rest/V1/moo-support/purchased-products) hinter einer dedizierten Admin-Berechtigung namens ReplyRabbit Connector API. Es ändert weder den Storefront noch den Checkout. - Die FreeScout Magento-Connector-Modul. Es ruft diese Endpunkte über HTTPS mit einem Magento-Integration-Zugriffstoken auf und rendert 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 Magento 2.4 oder neuer Shop (Magento Open Source oder Adobe Commerce), erreichbar über HTTPS, mit SSH-Zugriff zum Ausführen von Magento CLI-Befehlen.
- Magento-Admin-Zugriff zum Erstellen einer Integration.
- ReplyRabbit installiert und aktiviert, wenn du Produktbesitz-Kontext in KI-Entwürfen möchtest.
- Eine Magento 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.
Installiere das Magento-Modul
Magento-Modul herunterladen
Anmelden unter app.replyrabbit.app und laden Sie das Magento-Modul-ZIP von der Magento-Connector-Karte herunter.Entpacken Sie es nach app/code
Laden Sie die ZIP in Ihr Magento-Stammverzeichnis hoch und entpacken Sie sie. Sie erstelltapp/code/Moogento/SupportData.Das Modul aktivieren
Führen Sie im Magento-Stammverzeichnis aus:Führen Sie in einem Store im Produktionsmodus außerdem ausbashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploywie bei jeder Modulinstallation.
Composer-Installationen
moogento/m2-supportdata aus dem Moogento-Paket-Repository. Die ZIP-Installation oben benötigt keine Composer-Anmeldedaten.Ein Magento-Integration-Token erstellen
Der Connector authentifiziert sich mit einem Zugriffstoken aus einer Magento-Integration. Erstelle eine, die auf die schreibgeschützte Berechtigung des Moduls beschränkt ist.
Integrationen öffnen
Gehen Sie im Magento-Admin zu System, dann Erweiterungen, dann Integrationen, und klicken Sie auf Neue Integration hinzufügen.Benennen Sie ihn und legen Sie den API-Bereich fest
Geben Sie einen Namen wie "ReplyRabbit Connector" und Ihr Admin-Passwort ein. Auf der API Tab, setzen Sie Ressourcenzugriff zu Benutzerdefiniert und aktivieren Sie nur ReplyRabbit Connector API (unter dem übergeordneten Admin-Baum). Speichern.Aktivieren und das Zugriffstoken kopieren
Klicken Aktivieren neben der neuen Integration und dann Zulassen. Kopieren Sie die Zugriffstoken. Magento zeigt das Token in den Integrationsdetails an, sodass Sie später darauf zurückgreifen können.
Schreibgeschützter Zugriff
Installiere das FreeScout-Connector-Modul
Das FreeScout-Magento-Connector-Modul ruft die Magento-Endpunkte auf und rendert die Bestell-Seitenleiste in Gesprächen. Es ist ein eigenes Modul mit eigenen Einstellungen, getrennt von ReplyRabbit.
Connector-Modul herunterladen
Anmelden unter app.replyrabbit.app um das FreeScout-Connector-Modul-ZIP herunterzuladen. Beide Downloads erscheinen, 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 Magento-Integration Modul aus der Modulliste.
Pro Postfach konfigurieren
Nachdem das Modul installiert ist, verbinden Sie es in der eigenen Mailbox-Einstellungsseite des Connectors mit Ihrem Shop.
Öffnen Sie die Connector-Einstellungen
Öffnen Sie in FreeScout das Postfach, das Magento-Bestelldaten anzeigen soll, öffnen Sie das Postfach-Einstellungsmenü und wählen Sie Store-Connector. Dies ist die Einstellungsseite des Magento-Connectors, kein Abschnitt innerhalb der ReplyRabbit-Einstellungen.Geben Sie die Magento-Basis-URL ein
Fügen Sie die Basis-URL Ihres Magento-Shops über HTTPS ein, zum Beispielhttps://your-store.com. Ein abschließender Schrägstrich ist nicht erforderlich.Geben Sie das Zugriffstoken ein
Fügen Sie den ein Zugriffstoken aus der Magento-Integration. Es wird verschlüsselt gespeichert, und nach dem Speichern wird nur eine maskierte Vorschau angezeigt.Legen Sie die Store-ID fest (optional)
Leer lassen, um Bestellungen über alle Shops hinweg zuzuordnen. Gib eine Magento-Shop-ID ein, um die Seitenleiste auf einen Shop oder eine Shop-Ansicht zu beschränken.Fügen Sie Ihren Connector-Lizenzschlüssel hinzu
Wenn Sie den Connector gekauft haben, geben Sie seinen Lizenzschlüssel ein. Überspringen Sie diesen Schritt, wenn ein aktiver ReplyRabbit Pro- oder Team-Plan die Installation abdeckt.Speichern und testen
Speichere die Einstellungen. Öffne eine FreeScout-Konversation, bei der die Kunden-E-Mail zu einer Magento-Bestellung passt, und bestätige, dass die Bestell-Seitenleiste erscheint.
Jedes FreeScout-Postfach speichert seine eigene Basis-URL, seinen Access Token und seine Store-ID, sodass Sie verschiedene Postfächer mit verschiedenen Magento-Stores oder Store Views 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 Magento-Connector ist ein kostenpflichtiges Modul. Sie können ihn auf zwei Arten erhalten:
- Kaufen Sie den Magento Connector für 18 EUR als Einmallizenz für eine FreeScout-Installation und fügen Sie dann seinen Lizenzschlüssel in die Connector-Einstellungen ein.
- 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 |
|---|---|
| Bestell-Seitenleiste erscheint nicht | Bestätigen, dass die Basis-URL und das Zugriffstoken in den Connector-Einstellungen korrekt sind und dass das Postfach-Panel aktiviert ist. |
| HTTP 404 vom Shop | Das ReplyRabbit-Connector-Modul ist nicht installiert oder aktiviert. Führen Sie erneut aus bin/magento module:enable Moogento_SupportData und bin/magento setup:upgrade, dann leeren Sie den Cache. |
| HTTP 401 oder 403 vom Shop | Die Integration ist nicht aktiviert, das Token wurde neu generiert, oder der Integration fehlt das ReplyRabbit Connector API Ressource. Aktivieren Sie die Integration erneut und fügen Sie das aktuelle Token ein. |
| "Verbindung abgelehnt" oder Zeitüberschreitungsfehler | Prüfen, ob der FreeScout-Server Ihre Shop-URL über HTTPS erreichen kann. Firewalls, IP-Allowlists oder der Wartungsmodus können die Anfrage blockieren. |
| Basis-URL wird abgelehnt | Der Store muss über HTTPS bereitgestellt werden. Ein einfaches http:// URL oder ein nicht erreichbarer Host wird abgelehnt. |
| 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 Magento-Bestellungen übereinstimmt und dass die Shop-ID (falls gesetzt) mit dem Shop übereinstimmt, in dem sie bestellt haben. |
| 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 Magento abfragt, sendet er die Kunden-E-Mail-Adresse über HTTPS an Ihren eigenen Magento-Shop. Die von Ihrem Shop zurückgegebenen Bestelldaten füllen die FreeScout-Seitenleiste und bauen mit ReplyRabbit den KI-Kontext für Entwürfe auf.
Das Integrationstoken benötigt nur das schreibgeschützte ReplyRabbit Connector API Ressource, sodass der Connector nie in Ihren Store schreibt. Das Token wird verschlüsselt in FreeScout gespeichert, und ausgehende Anfragen verifizieren TLS und folgen keinen Weiterleitungen.
Es werden keine Magento-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? Siehe die WooCommerce-Connector Anleitung.
FAQ
Brauche ich ein Magento-Modul für den Connector?
Ja. Der Connector liest einen Support-Summary-Endpunkt, den das ReplyRabbit Connector-Modul zur Magento 2 REST API hinzufügt. Es gibt zwei Downloads, das Magento-Modul und das FreeScout Magento-Connector-Modul, beide in Ihrem ReplyRabbit-Konto verfügbar.
Welche Magento-Versionen werden unterstützt?
Magento 2.4 und höher, einschließlich Magento Open Source und Adobe Commerce, auf PHP 8.0 bis 8.4. Magento 1 wird nicht unterstützt.
Wie viel kostet der Magento Connector?
Der Magento-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, fügen Sie seinen Lizenzschlüssel in die Connector-Einstellungen ein.
Welche Berechtigung benötigt das Zugriffstoken?
Nur die ReplyRabbit Connector API-Ressource, die schreibgeschützt ist. Der Connector schreibt nie in Ihren Store, daher benötigt die Integration keine weiteren Admin-Berechtigungen.
Kann jedes FreeScout-Postfach mit einem anderen Magento-Shop verbunden werden?
Ja. Jedes Postfach speichert seine eigene Basis-URL, sein Zugriffstoken und eine optionale Store-ID in den Connector-Einstellungen, sodass verschiedene Stores oder Store-Views mit verschiedenen Postfächern verbunden werden können.