
Stripe-Connector für FreeScout
Funktioniert mit Stripe
Der Stripe-Connector stellt Kunden-Zahlungs- und Abonnementkontext neben ein FreeScout-Gespräch. Er verwendet einen eingeschränkten, schreibgeschützten Stripe-API-Schlüssel, sodass er Informationen nachschlagen kann, ohne etwas in Stripe zu ändern.
Suchen Sie die Übersicht?
Was der Connector zeigt
Wenn ein FreeScout-Gespräch eine Kunden-E-Mail-Adresse hat, sucht der Connector in Stripe nach passenden Kunden- und aktuellen Zahlungsdatensätzen. Je nachdem, was er findet, kann die Seitenleiste Folgendes anzeigen:
- Kundenidentität, mit dem Namen verknüpft mit dem Stripe-Kunden, plus E-Mail und Kunde-seit-Datum.
- Abonnements mit einem Link-Symbol, das das Abonnement in Stripe öffnet, dem Zeitraum, einem farbigen Statuspunkt, dem Stückpreis des ersten Artikels mit seinem Abrechnungsintervall wie
€49/moder€120/y, und den Produktnamen (mit Rückgriff auf den Preis-Spitznamen, dann eine allgemeine Bezeichnung). Spalten wie Stornierungen, Testende oder Rabatt erscheinen nur, wenn ein Plan sie hat. - Zahlungen in einer Tabelle im Bestellstil: ein Link-Symbol, das die Zahlung in Stripe öffnet, das Datum, ein Statuspunkt mit etwaigem Radar-Risiko und Kartenprüf-Symbolen, der Gesamtbetrag und eine gekürzte Liste der gekauften Artikel.
- Rückerstattungen und Streitfälle werden als Details in der Zahlungszeile angezeigt, zu der sie gehören. Die Spalte Details erscheint nur, wenn mindestens eine Zeile etwas anzuzeigen hat.
- Fehlgeschlagene Zahlungen mit verfügbarem Ablehnungsgrund, angezeigt in derselben Details-Spalte.
- Beträge mit einem Währungssymbol, wo eines existiert, zum Beispiel
€61oder$12.50, andernfalls den Währungscode; Datumsangaben werden kompakt dargestellt, wieSep 24 '26. - Erfasst, Erstattungen und Netto-Summen für die geladenen Zahlungen.
- E-Mail-Verknüpfung: Wenn ein Kunde von einer anderen Adresse schreibt als der in Stripe, verknüpfen Sie eine Stripe-E-Mail mit dem Thread, und das Panel zeigt die Zahlungen dieses Kunden.
- Marke, letzte vier Ziffern und Ablaufdatum einer gespeicherten Zahlungsmethode.
Wenn der Connector nur einen Teil des Zahlungsverlaufs sehen kann, sagt ein einzelner Hinweis unter den Summen, dass die Summen nur geladene Zahlungen abdecken. Er wird nicht bei jeder Summe wiederholt.
Der Connector begrenzt jede Abfrage und prüft nur Datensätze, die mit diesem Kunden verbunden sind. Er durchsucht nicht das gesamte Stripe-Konto nach Streitfällen oder Zahlungshistorie. Ein leeres oder teilweises Ergebnis beweist nicht, dass kein anderer Datensatz in Stripe existiert.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:
- Eine funktionierende FreeScout-Installation.
- Stripe-Dashboard-Zugriff, der es Ihnen ermöglicht, einen eingeschränkten API-Schlüssel zu erstellen.
- Eine aktive ReplyRabbit Pro- oder Team-Lizenz oder eine eigenständige Stripe-Connector-Lizenz. Die eigenständige Lizenz kostet 18 EUR als Einmalkauf pro FreeScout-Installation.
- ReplyRabbit nur installiert, wenn du den optionalen, ausdrücklich aktivierten KI-Commerce-Kontext für Entwürfe möchtest.
Anmelden bei Ihr ReplyRabbit-Dashboard. Ein aktiver ReplyRabbit Pro- oder Team-Plan enthält den Connector-Download. Wenn Sie keinen der beiden Pläne haben, kaufen Sie dort die Standalone-Lizenz, laden Sie dann den Connector herunter und bewahren Sie dessen Lizenzschlüssel im Dashboard auf.
Einen eingeschränkten Stripe-API-Schlüssel erstellen
Der Connector benötigt einen Stripe eingeschränkter Schlüssel, kein geheimer Schlüssel. Erstellen Sie einen neuen eingeschränkten Schlüssel im Stripe-Dashboard. Legen Sie fest Kunden, Abonnements, Rechnungen, Belastungen, PaymentIntents, PaymentMethods, und Streitfälle zu Lesen, und legen Sie fest Produkte zu Lesen um Abonnementplannamen anzuzeigen. Ohne Produktleseberechtigung fallen Abonnements auf den Preis-Spitznamen oder eine generische Bezeichnung zurück. Lassen Sie jeden nicht zugehörigen Berechtigungssatz auf Keine.
Fügen Sie keinen geheimen Schlüssel ein
Kopieren Sie den eingeschränkten Schlüssel, wenn Stripe ihn anzeigt. Behandeln Sie ihn wie ein Passwort. Der Connector verschlüsselt ihn beim Speichern und zeigt den vollständigen Wert nie wieder an.
Installiere den Connector
Stripe Connector herunterladen
Anmelden unter app.replyrabbit.app. Laden Sie den Connector über Ihren aktiven ReplyRabbit Pro- oder Team-Plan herunter oder kaufen Sie zuerst die Standalone-Stripe-Connector-Lizenz.Laden Sie es in FreeScout hoch
Öffnen Sie in FreeScout Module, verwenden Sie das Upload-Steuerelement, um die ZIP-Datei auszuwählen, und installieren Sie sie.Aktivieren Sie das Modul
Aktivieren Stripe-Connector aus der FreeScout-Modulliste.
Ein Postfach konfigurieren
Stripe Connector-Einstellungen öffnen
Öffnen Sie das FreeScout-Postfach, das Stripe-Zahlungskontext anzeigen soll, und wählen Sie Stripe-Connector aus seinem Einstellungsmenü.Fügen Sie den eingeschränkten Schlüssel ein
Den Connector aktivieren und den eingeschränkten schreibgeschützten Stripe-Schlüssel einfügen. Wenn Sie die Standalone-Connector-Lizenz gekauft haben, fügen Sie außerdem den Lizenzschlüssel aus Ihrem ReplyRabbit-Konto ein. Eine installierte ReplyRabbit Pro- oder Team-Lizenz schaltet den Stripe Connector automatisch frei. Speichern Sie die Einstellungen.Den gespeicherten Schlüssel testen
Verwenden Gespeicherten Schlüssel testen um zu bestätigen, dass Stripe den Schlüssel und seine Kundenleseberechtigung akzeptiert.Eine passende Konversation prüfen
Öffnen Sie eine Konversation, deren Kunden-E-Mail in Stripe existiert, und bestätigen Sie, dass das Stripe-Panel in der Seitenleiste erscheint.
Jedes FreeScout-Postfach speichert seinen eigenen verschlüsselten Stripe-Schlüssel. Sie können verschiedene Stripe-Konten mit verschiedenen Postfächern verbinden.
Einen Kunden abgleichen, der von einer anderen E-Mail schreibt
Stripe gleicht über die E-Mail-Adresse des Gesprächs ab. Wenn ein Kollege schreibt oder der Kunde eine andere Adresse als die seines Stripe-Kunden verwendet, verknüpfen Sie die richtige E-Mail mit dem Thread:
Das Stripe-Panel finden
Öffnen Sie die Konversation und suchen Sie das Stripe-Panel in der Seitenleiste.Weitere E-Mail verknüpfen
Auswählen Weitere E-Mail verknüpfen, wählen Sie dann eine Adresse aus dem Thread oder geben Sie die in Stripe verwendete Rechnungsadresse ein.Das Panel prüfen
Das Panel zeigt jetzt die Zahlungen dieses Kunden an, vermerkt die Verknüpft mit Adresse und bietet Link entfernen. Die Connector-Einstellungen listen jeden gespeicherten Link mit einem Entfernen action pro Adresse.
Durch die Verknüpfung wird jede Nicht-Postfach-Adresse im Thread, der Absender, An und Cc, dem von Ihnen gewählten Stripe-E-Mail-Konto zugeordnet. Diese Verknüpfungen werden für das Postfach gespeichert, sodass zukünftige Konversationen von jeder dieser Adressen demselben Stripe-Kunden zugeordnet werden. Der Connector liest weiterhin nur Stripe-Daten.
Optionaler ReplyRabbit-Entwurfskontext
Die Seitenleiste funktioniert ohne ReplyRabbit. ReplyRabbit wird nur benötigt, wenn Sie aktuelle Stripe-Details beim Erzeugen von KI-Entwürfen verfügbar haben möchten.
Zum Aktivieren setzen Sie STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true in der FreeScout-Umgebung und aktivieren Sie dann den Connector für die Mailbox. Auf der ReplyRabbit-Seite legen Sie entweder REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true für jede Mailbox, oder wählen Sie An für eine Mailbox unter Mailbox-Einstellungen, Produkte, Shop-Daten in Entwürfen. Diese Zeile erscheint in der Essentials-Ansicht, sobald ein Shop-Connector für die Mailbox verfügbar ist; wechseln Sie vorher zu Alle Einstellungen, um sie zu finden. Nur ein FreeScout-Admin kann sie ändern. Die Mailbox-Auswahl überschreibt die Servereinstellung; "Standardeinstellung verwenden" (der Standard) folgt ihr. Beide Einstellungen sind standardmäßig aus. Nach dem Ändern von Umgebungswerten führen Sie php artisan config:clear aus dem FreeScout-Verzeichnis, damit FreeScout die neuen Werte statt einer zwischengespeicherten Konfiguration übernimmt.
Stripe muss der einzige aktive Vollkontext-Anbieter für dieses Postfach sein. Wenn Shopify ebenfalls vollständigen Commerce-Kontext liefert, lässt ReplyRabbit Commerce-Daten aus Entwürfen heraus, bis nur noch einer aktiviert ist. Magento- und WooCommerce-Berechtigungsabfragen stehen nicht im Konflikt. Die Stripe-Seitenleiste bleibt für den Support-Agenten verfügbar.
Datenverarbeitung und Limits
Der Connector sendet die Konversations-E-Mail über HTTPS an Stripe, um passende kundenspezifische Datensätze zu finden. Er speichert den eingeschränkten Schlüssel verschlüsselt. Er speichert keine vollständigen Kartennummern, rohen Stripe-Payloads, Rechnungsadressen, Metadaten, Payment-Intent-Secrets oder Beleg-URLs im Cache.
Stripe-Anfragen verwenden den angehefteten 2026-02-25.clover API-Version. Wenn kein Customer-Datensatz übereinstimmt, prüft der Connector nicht mehr als 200 aktuelle Charges aus den letzten 90 Tagen und gleicht die E-Mail lokal exakt ab. Dieser Gastzahlungs-Fallback ist absichtlich unvollständig.
Die begrenzte Abfrage hält die Seitenleiste reaktionsfähig und reduziert unnötigen Datenzugriff. Ein einzelner Hinweis unter den Summen erklärt, wann sie nur die Zahlungen abdecken, die der Connector geladen hat. Für ein vollständiges kontoübergreifendes Audit verwende das Stripe-Dashboard.
Fehlerbehebung
| Symptom | Was zu prüfen ist |
|---|---|
| Stripe lehnt den Schlüssel ab | Erstellen Sie einen neuen eingeschränkten Schlüssel mit den erforderlichen Leseberechtigungen. Verwenden Sie keinen vollständigen Secret Key. |
| Die Seitenleiste ist für einen bekannten Käufer leer | Bestätigen, dass die FreeScout-Konversations-E-Mail genau mit der Stripe-E-Mail des Käufers übereinstimmt. Gastzahlungen werden nur innerhalb des begrenzten 90-Tage-, 200-Zahlungen-Fallbacks geprüft. |
| Eine Rückerstattung oder ein Streitfall fehlt | Der Connector prüft nur eine begrenzte Auswahl aktueller Datensätze für diesen Kunden. Prüfe das Stripe-Dashboard für die vollständige Kontohistorie. |
| ReplyRabbit-Entwürfe enthalten keinen Zahlungskontext | Bestätigen, dass beide Commerce-Kontext-Umgebungsflags gesetzt sind auf true, ist der Stripe-Connector für das Postfach verfügbar und kein anderer Commerce-Anbieter aktiv. |
| Einige Zahlungsdetails sind nicht verfügbar | Bei einem Standalone-Kauf bestätigen Sie, dass der Lizenzschlüssel des Stripe Connector in den Connector-Einstellungen gespeichert und für die vorgesehene FreeScout-Domain aktiv ist. Bei gebündeltem Zugriff bestätigen Sie, dass eine aktive ReplyRabbit Pro- oder Team-Lizenz auf derselben FreeScout-Site installiert ist. |
Nächste Schritte
- Lesen So richten Sie ReplyRabbit ein wenn die Mailbox noch KI-Anbieter- oder Entwurfseinstellungen benötigt.
- Siehe die Shopify-Connector, WooCommerce-Connector, oder Magento-Connector Anleitungen für andere Commerce-Plattformen.
FAQ
Schreibt der Stripe Connector in Stripe?
Nein. Der Connector verwendet einen eingeschränkten Stripe-API-Schlüssel mit nur den dokumentierten Leseberechtigungen. Er erstellt keine Rückerstattungen, kündigt keine Abonnements, wiederholt keine Abbuchungen und ändert keine Stripe-Daten.
Wenn keine Rückerstattung oder Streitigkeit angezeigt wird, bedeutet das, dass keine in Stripe existiert?
Nein. Der Connector prüft eine begrenzte Auswahl aktueller Datensätze für diesen Kunden. Ein leeres Panel beschreibt nur diese Datensätze, nicht die vollständige Stripe-Kontohistorie.
Können Stripe-Daten in ReplyRabbit-Entwürfen verwendet werden?
Ja, nachdem Sie sowohl den Commerce-Kontext von ReplyRabbit als auch des Stripe Connector aktiviert haben und Stripe der einzige aktive Anbieter mit vollem Kontext des Postfachs ist. Wenn Shopify ebenfalls vollen Commerce-Kontext liefert, lässt ReplyRabbit Commerce-Daten aus Entwürfen heraus, bis nur noch einer aktiviert ist. Berechtigungsabfragen für Magento und WooCommerce stehen sich nicht im Weg.
Wie viel kostet der Stripe Connector?
Der Stripe-Connector ist in einem aktiven ReplyRabbit Pro- oder Team-Plan enthalten. Andernfalls kostet er 18 EUR als einmalige Lizenz für eine FreeScout-Installation.
Kann ich einen Kunden abgleichen, der von einer anderen E-Mail-Adresse schreibt?
Ja. Öffnen Sie die Konversation, wählen Sie Link another email im Stripe-Panel und wählen Sie eine Adresse aus dem Thread oder geben Sie eine ein. Verknüpfungen werden für das Postfach gespeichert, sodass zukünftige Konversationen von jeder verknüpften Adresse denselben Stripe-Kunden anzeigen. Das Panel zeigt dann Manually connected an, und Sie können die Verknüpfung von dort aus aufheben.