
Stripe-connector voor FreeScout
Werkt met Stripe
Stripe-connector plaatst klantbetalings- en abonnementscontext naast een FreeScout-gesprek. Het gebruikt een beperkte, alleen-lezen Stripe API-sleutel, zodat het informatie kan opzoeken zonder iets in Stripe te wijzigen.
Op zoek naar het overzicht?
Wat de connector toont
Wanneer een FreeScout-gesprek een e-mailadres van een klant heeft, zoekt de connector in Stripe naar overeenkomende klant- en recente betalingsgegevens. Afhankelijk van wat hij vindt, kan de zijbalk het volgende tonen:
- Klantidentiteit, met de naam gekoppeld aan de Stripe-klant, plus het e-mailadres en de klant-sinds-datum.
- Abonnementen met een linkpictogram dat het abonnement in Stripe opent, de periode, een gekleurde statusstip, de eenheidsprijs van het eerste item met het factureringsinterval zoals
€49/mof€120/y, en de productnaam (met terugval op de prijsbijnaam, dan een generiek label). Kolommen zoals Opzeggingen, Proefperiode-einde of Korting verschijnen alleen wanneer een abonnement ze heeft. - Betalingen in een tabel in bestelstijl: een linkpictogram dat de betaling in Stripe opent, de datum, een statusstip met eventuele Radar-risico- en kaartcontrolepictogrammen, het totaal en een ingekorte lijst van de gekochte items.
- Terugbetalingen en geschillen worden getoond als details op de betalingsrij waar ze bij horen. De kolom Details verschijnt alleen wanneer ten minste één rij iets te tonen heeft.
- Mislukte betalingen met een beschikbare reden voor weigering, getoond in dezelfde Details-kolom.
- Bedragen met een valutasymbool waar dat bestaat, bijvoorbeeld
€61of$12.50, anders de valutacode; datums worden compact weergegeven, zoalsSep 24 '26. - Vastgelegd, Terugbetalingen en Netto totalen voor de geladen betalingen.
- E-mailkoppeling: wanneer een klant vanaf een ander adres schrijft dan het adres in Stripe, koppel dan een Stripe-e-mail aan de thread en het paneel toont de betalingen van die klant.
- Het merk, de laatste vier cijfers en de vervaldatum van een opgeslagen betaalmethode.
Wanneer de connector slechts een deel van de betalingsgeschiedenis kan zien, zegt één notitie onder de totalen dat de totalen alleen geladen betalingen omvatten. Die wordt niet bij elk totaal herhaald.
De connector beperkt elke opzoeking en controleert alleen records die aan die klant zijn gekoppeld. Het scant niet het hele Stripe-account op geschillen of betalingsgeschiedenis. Een leeg of gedeeltelijk resultaat bewijst niet dat er geen ander record in Stripe bestaat.
Vereisten
Voordat je begint, zorg dat je het volgende hebt:
- Een werkende FreeScout-installatie.
- Toegang tot het Stripe-dashboard waarmee je een beperkte API-sleutel kunt maken.
- Een actieve ReplyRabbit Pro- of Team-licentie, of een losse Stripe Connector-licentie. De losse licentie kost 18 EUR als eenmalige aankoop per FreeScout-installatie.
- ReplyRabbit alleen geïnstalleerd als je de optionele, expliciet ingeschakelde AI-commercecontext voor concepten wilt.
Meld je aan bij je ReplyRabbit-dashboard. Een actief ReplyRabbit Pro- of Team-abonnement bevat de connectordownload. Heb je geen van beide abonnementen, koop dan de losse licentie daar, download dan de connector en bewaar de licentiesleutel in het dashboard.
Een beperkte Stripe API-sleutel aanmaken
De connector heeft een Stripe nodig beperkte sleutel, geen geheime sleutel. Maak een nieuwe beperkte sleutel aan in het Stripe-dashboard. Stel Klanten, Abonnementen, Facturen, Kosten, PaymentIntents, PaymentMethods, en Geschillen naar Lezen, en stel Producten naar Lezen om abonnementsplannamen te tonen. Zonder Products read vallen abonnementen terug op de prijsbijnaam of een generiek label. Laat elke ongerelateerde machtiging op Geen.
Plak geen geheime sleutel
Kopieer de beperkte sleutel wanneer Stripe deze toont. Behandel het als een wachtwoord. De connector versleutelt het bij opslaan en toont de volledige waarde nooit meer.
Installeer de connector
Stripe Connector downloaden
Meld je aan bij app.replyrabbit.app. Download de connector via je actieve ReplyRabbit Pro- of Team-abonnement, of koop eerst de losse Stripe Connector-licentie.Upload het naar FreeScout
Open in FreeScout Modules, gebruik het uploadbesturingselement om de ZIP te selecteren en installeer deze.Activeer de module
Activeren Stripe-connector uit de FreeScout-modulelijst.
Een mailbox configureren
Stripe Connector-instellingen openen
Open de FreeScout-mailbox die Stripe-betalingscontext moet tonen en kies Stripe-connector uit het instellingenmenu.Plak de beperkte sleutel
Schakel de connector in en plak de beperkte read-only Stripe-sleutel. Als je de losse connectorlicentie hebt gekocht, plak dan ook de licentiesleutel uit je ReplyRabbit-account. Een geïnstalleerde ReplyRabbit Pro- of Team-licentie ontgrendelt de Stripe Connector automatisch. Sla de instellingen op.Test de opgeslagen sleutel
Gebruik Opgeslagen sleutel testen om te bevestigen dat Stripe de sleutel en de leesmachtiging voor klanten accepteert.Controleer een overeenkomstig gesprek
Open een gesprek waarvan het klant-e-mailadres in Stripe bestaat en bevestig dat het Stripe-paneel in de zijbalk verschijnt.
Elke FreeScout-mailbox slaat zijn eigen versleutelde Stripe-sleutel op. U kunt verschillende Stripe-accounts aan verschillende mailboxen koppelen.
Een klant matchen die vanaf een ander e-mailadres schrijft
Stripe koppelt op het e-mailadres van het gesprek. Wanneer een collega schrijft, of de klant een ander adres gebruikt dan dat van hun Stripe-klant, koppel je het juiste e-mailadres aan de thread:
Vind het Stripe-paneel
Open het gesprek en zoek het Stripe-paneel in de zijbalk.Nog een e-mailadres koppelen
Kiezen Nog een e-mailadres koppelen, kies dan een adres uit de thread of typ het factuuradres dat in Stripe is gebruikt.Controleer het paneel
Het paneel toont nu de betalingen van die klant, vermeldt de Gekoppeld aan adres, en biedt Link verwijderen. De connectorinstellingen tonen elke opgeslagen koppeling met een Verwijderen actie per adres.
Bij koppelen wordt elk niet-mailboxadres in de thread, de afzender, Aan en Cc, gekoppeld aan het Stripe-e-mailadres dat je kiest. Die koppelingen worden per mailbox opgeslagen, zodat toekomstige gesprekken van elk van deze adressen naar dezelfde Stripe-klant verwijzen. De connector leest nog steeds alleen Stripe-gegevens.
Optionele ReplyRabbit-conceptcontext
De zijbalk werkt zonder ReplyRabbit. ReplyRabbit is alleen nodig als je recente Stripe-gegevens beschikbaar wilt hebben bij het genereren van AI-concepten.
Om je aan te melden, stel STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true in de FreeScout-omgeving en schakel vervolgens de connector in voor de mailbox. Stel aan de ReplyRabbit-kant ofwel REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true voor elke mailbox, of kies Aan voor één mailbox onder Mailboxinstellingen, Producten, Winkelgegevens in concepten. Die rij verschijnt in de Essentials-weergave zodra een winkelconnector beschikbaar is voor de mailbox; schakel daarvoor over naar Alle instellingen om deze te vinden. Alleen een FreeScout-admin kan dit wijzigen. De mailboxkeuze overschrijft de serverinstelling; "De standaardinstelling gebruiken" (de standaard) volgt deze. Beide instellingen staan standaard uit. Voer na het wijzigen van omgevingswaarden php artisan config:clear uit de FreeScout-map zodat FreeScout de nieuwe waarden oppikt in plaats van een gecachte configuratie.
Stripe moet de enige actieve provider voor volledige context voor die mailbox zijn. Als Shopify ook volledige commercecontext levert, laat ReplyRabbit commercegegevens buiten concepten totdat er nog maar één is ingeschakeld. Opvragingen van Magento- en WooCommerce-rechten conflicteren niet. De Stripe-zijbalk blijft beschikbaar voor de supportagent.
Gegevensverwerking en limieten
De connector stuurt het gesprek-e-mailadres via HTTPS naar Stripe om bijpassende klantgebonden records te vinden. Het slaat de beperkte sleutel versleuteld op. Het cachet geen volledige kaartnummers, ruwe Stripe-payloads, factuuradressen, metadata, payment intent secrets of ontvangst-URL's.
Stripe-verzoeken gebruiken de vastgezette 2026-02-25.clover API-versie. Wanneer geen Customer-record overeenkomt, inspecteert de connector niet meer dan 200 recente betalingen uit de laatste 90 dagen en vergelijkt het e-mailadres lokaal exact. Deze fallback voor gastbetalingen is bewust onvolledig.
De beperkte opzoeking houdt de zijbalk responsief en vermindert onnodige gegevenstoegang. Een enkele notitie onder de totalen legt uit wanneer ze alleen de betalingen dekken die de connector heeft geladen. Voor een volledige accountbrede audit gebruik je het Stripe-dashboard.
Probleemoplossing
| Symptoom | Wat te controleren |
|---|---|
| Stripe weigert de sleutel | Maak een nieuwe beperkte sleutel aan met de vereiste leesrechten. Gebruik geen volledige geheime sleutel. |
| De zijbalk is leeg voor een bekende koper | Bevestig dat het e-mailadres van het FreeScout-gesprek exact overeenkomt met het Stripe-e-mailadres van de koper. Gastbetalingen worden alleen gecontroleerd binnen de begrensde fallback van 90 dagen en 200 betalingen. |
| Een terugbetaling of geschil ontbreekt | De connector controleert slechts een beperkte set recente records voor die klant. Controleer het Stripe-dashboard voor de volledige accountgeschiedenis. |
| ReplyRabbit-concepten bevatten geen betalingscontext | Bevestig dat beide commerce-context-omgevingsvlaggen true, de Stripe-connector beschikbaar is voor de mailbox, en er geen andere commerce-provider actief is. |
| Sommige betalingsgegevens zijn niet beschikbaar | Voor een losse aankoop: bevestig dat de licentiesleutel van de Stripe Connector is opgeslagen in de connectorinstellingen en actief is voor het beoogde FreeScout-domein. Voor gebundelde toegang: bevestig dat een actieve ReplyRabbit Pro- of Team-licentie is geïnstalleerd op dezelfde FreeScout-site. |
Volgende stappen
- Lezen Hoe je ReplyRabbit instelt als de mailbox nog AI-provider- of conceptinstellingen nodig heeft.
- Bekijk de Shopify-connector, WooCommerce-connector, of Magento-connector handleidingen voor andere commerceplatforms.
FAQ
Schrijft de Stripe Connector naar Stripe?
Nee. De connector gebruikt een beperkte Stripe API-sleutel met alleen de gedocumenteerde leesrechten. Het maakt geen terugbetalingen, annuleert geen abonnementen, probeert kosten niet opnieuw en wijzigt geen Stripe-gegevens.
Als er geen terugbetaling of geschil wordt getoond, betekent dat dan dat er geen in Stripe zijn?
Nee. De connector controleert een beperkte set recente records voor die klant. Een leeg paneel beschrijft alleen die records, niet de volledige Stripe-accounthistorie.
Kan Stripe-data worden gebruikt in ReplyRabbit-concepten?
Ja, nadat je zowel ReplyRabbit als Stripe Connector commercecontext hebt ingeschakeld en Stripe de enige actieve full-contextprovider van de mailbox is. Als Shopify ook volledige commercecontext levert, laat ReplyRabbit commercegegevens buiten concepten tot er nog maar één is ingeschakeld. Opvragingen van Magento- en WooCommerce-rechten conflicteren niet.
Hoeveel kost de Stripe Connector?
De Stripe Connector is inbegrepen bij een actief ReplyRabbit Pro- of Team-abonnement. Anders kost het 18 EUR als eenmalige licentie voor één FreeScout-installatie.
Kan ik een klant matchen die vanaf een ander e-mailadres schrijft?
Ja. Open het gesprek, kies Link another email in het Stripe-paneel en kies een adres uit de thread of typ er een. Koppelingen worden onthouden voor het mailbox, zodat toekomstige gesprekken van elk gekoppeld adres dezelfde Stripe-klant tonen. Het paneel toont dan Manually connected en je kunt daar de koppeling verbreken.