
Connecteur Stripe pour FreeScout
Fonctionne avec Stripe
Le connecteur Stripe place le contexte de paiement et d'abonnement du client à côté d'une conversation FreeScout. Il utilise une clé API Stripe restreinte en lecture seule, afin de pouvoir rechercher des informations sans rien modifier dans Stripe.
Vous cherchez la vue d'ensemble ?
Ce que le connecteur affiche
Lorsqu'une conversation FreeScout comporte une adresse e-mail client, le connecteur recherche dans Stripe les enregistrements de client et de paiements récents correspondants. Selon ce qu'il trouve, la barre latérale peut afficher :
- L'identité du client, avec le nom lié au client Stripe, ainsi que l'e-mail et la date de première commande.
- Abonnements affichant une icône de lien qui ouvre l'abonnement dans Stripe, la période, un point d'état coloré, le prix unitaire du premier article avec son intervalle de facturation tel que
€49/mou€120/y, et le nom du produit (en revenant au surnom du prix, puis à un libellé générique). Des colonnes telles que Annulations, Fin d'essai ou Remise n'apparaissent que lorsqu'un forfait les comporte. - Paiements dans un tableau de style commande : une icône de lien qui ouvre le paiement dans Stripe, la date, un point de statut avec les icônes de risque Radar et de vérification de carte, le total, et une liste réduite des articles achetés.
- Les remboursements et litiges sont affichés comme détails sur la ligne de paiement à laquelle ils appartiennent. La colonne Détails n'apparaît que lorsqu'au moins une ligne a quelque chose à afficher.
- Paiements échoués avec un motif de refus disponible, affichés dans la même colonne Détails.
- Montants avec un symbole monétaire lorsqu'il existe, par exemple
€61ou$12.50, sinon le code de devise ; les dates s'affichent de façon compacte, commeSep 24 '26. - Totaux Capturé, Remboursements et Net pour les paiements chargés.
- Liaison email : lorsqu'un client écrit depuis une adresse différente de celle dans Stripe, liez un email Stripe au fil et le panneau affiche les paiements de ce client.
- La marque, les quatre derniers chiffres et la date d'expiration d'un moyen de paiement enregistré.
Lorsque le connecteur ne peut voir qu'une partie de l'historique des paiements, une seule note sous les totaux indique que les totaux ne couvrent que les paiements chargés. Elle ne se répète pas sur chaque total.
Le connecteur limite chaque recherche et ne vérifie que les enregistrements liés à ce client. Il ne parcourt pas l'ensemble du compte Stripe pour les litiges ou l'historique des paiements. Un résultat vide ou partiel ne prouve pas qu'aucun autre enregistrement n'existe dans Stripe.
Prérequis
Avant de commencer, assurez-vous de disposer de :
- Une installation FreeScout fonctionnelle.
- Accès au tableau de bord Stripe qui vous permet de créer une clé API restreinte.
- Une licence ReplyRabbit Pro ou Team active, ou une licence autonome Stripe Connector. La licence autonome coûte 18 EUR en achat unique par installation FreeScout.
- ReplyRabbit installé uniquement si vous souhaitez le contexte de commerce IA facultatif et explicitement activé pour les brouillons.
Connectez-vous à votre tableau de bord ReplyRabbit. Une offre ReplyRabbit Pro ou Team active inclut le téléchargement du connecteur. Si vous n'avez ni l'une ni l'autre, achetez la licence autonome à cet endroit, puis téléchargez le connecteur et conservez sa clé de licence dans le tableau de bord.
Créer une clé API Stripe restreinte
Le connecteur nécessite un Stripe clé restreinte, pas une clé secrète. Créez une nouvelle clé restreinte dans le tableau de bord Stripe. Définissez Clients, Abonnements, Factures, Frais, PaymentIntents, PaymentMethods, et Litiges à Lire, et définissez Produits à Lire pour afficher les noms des forfaits d'abonnement. Sans la lecture des produits, les abonnements reviennent au surnom du prix ou à un libellé générique. Laissez chaque ensemble d'autorisations sans rapport sur Aucun.
Ne collez pas de clé secrète
Copiez la clé restreinte lorsque Stripe l'affiche. Traitez-la comme un mot de passe. Le connecteur la chiffre lors de l'enregistrement et n'affiche plus jamais la valeur complète.
Installez le connecteur
Télécharger le connecteur Stripe
Connectez-vous à app.replyrabbit.app. Téléchargez le connecteur via votre offre ReplyRabbit Pro ou Team active, ou achetez d'abord la licence autonome Stripe Connector.Téléversez-le dans FreeScout
Dans FreeScout, ouvrez Modules, utilisez le contrôle de téléversement pour sélectionner le ZIP et installez-le.Activez le module
Activer Connecteur Stripe depuis la liste des modules FreeScout.
Configurer une boîte aux lettres
Ouvrir les paramètres du connecteur Stripe
Ouvrez la boîte aux lettres FreeScout qui doit afficher le contexte de paiement Stripe, puis choisissez Connecteur Stripe depuis son menu de paramètres.Collez la clé restreinte
Activez le connecteur et collez la clé Stripe restreinte en lecture seule. Si vous avez acheté la licence du connecteur autonome, collez également sa clé de licence depuis votre compte ReplyRabbit. Une licence ReplyRabbit Pro ou Team installée débloque automatiquement le connecteur Stripe. Enregistrez les paramètres.Tester la clé enregistrée
Utiliser Tester la clé enregistrée pour confirmer que Stripe accepte la clé et son autorisation de lecture des clients.Vérifier une conversation correspondante
Ouvrez une conversation dont l'e-mail du client existe dans Stripe et confirmez que le panneau Stripe apparaît dans la barre latérale.
Chaque boîte aux lettres FreeScout stocke sa propre clé Stripe chiffrée. Vous pouvez connecter différents comptes Stripe à différentes boîtes aux lettres.
Faire correspondre un client qui écrit depuis un autre email
Stripe effectue la correspondance sur l'adresse e-mail de la conversation. Lorsqu'un collègue écrit, ou que le client utilise une adresse différente de celle de son client Stripe, associez le bon e-mail au fil :
Trouvez le panneau Stripe
Ouvrez la conversation et trouvez le panneau Stripe dans la barre latérale.Lier un autre email
Choisir Lier un autre email, puis choisissez une adresse dans le fil ou saisissez l'adresse de facturation utilisée dans Stripe.Vérifier le panneau
Le panneau affiche désormais les paiements de ce client, note les Lié à l'adresse, et propose Supprimer le lien. Les paramètres du connecteur listent chaque lien enregistré avec un Supprimer action par adresse.
La liaison associe chaque adresse non-boîte aux lettres du fil, l'expéditeur, À et Cc, à l'email Stripe que vous choisissez. Ces liens sont stockés pour la boîte aux lettres, de sorte que les futures conversations de l'une de ces adresses aboutissent au même client Stripe. Le connecteur ne lit toujours que les données Stripe.
Contexte de brouillon ReplyRabbit facultatif
La barre latérale fonctionne sans ReplyRabbit. ReplyRabbit n'est nécessaire que si vous voulez que les détails Stripe récents soient disponibles lors de la génération de brouillons IA.
Pour vous inscrire, définissez STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true dans l'environnement FreeScout, puis activez le connecteur pour la boîte aux lettres. Pour le côté ReplyRabbit, définissez soit REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true pour chaque boîte aux lettres, ou choisissez Activé pour une boîte aux lettres sous Paramètres de la boîte aux lettres, Produits, Données de boutique dans les brouillons. Cette ligne apparaît dans la vue Essentiels une fois qu'un connecteur de boutique est disponible pour la boîte aux lettres ; avant cela, passez à Tous les paramètres pour la trouver. Seul un administrateur FreeScout peut la modifier. Le choix de la boîte aux lettres remplace le paramètre du serveur ; "Utiliser le paramètre par défaut" (par défaut) le suit. Les deux paramètres sont désactivés par défaut. Après avoir modifié les valeurs d'environnement, exécutez php artisan config:clear depuis le répertoire FreeScout afin que FreeScout prenne les nouvelles valeurs au lieu d'une configuration en cache.
Stripe doit être le seul fournisseur de contexte complet actif pour cette boîte aux lettres. Si Shopify fournit également un contexte commercial complet, ReplyRabbit exclut les données commerciales des brouillons jusqu'à ce qu'un seul reste activé. Les recherches de droits Magento et WooCommerce n'entrent pas en conflit. La barre latérale Stripe reste disponible pour l'agent d'assistance.
Traitement des données et limites
Le connecteur envoie l'e-mail de la conversation à Stripe via HTTPS pour trouver les enregistrements correspondants propres au client. Il stocke la clé restreinte chiffrée. Il ne met pas en cache les numéros de carte complets, les charges utiles Stripe brutes, les adresses de facturation, les métadonnées, les secrets d'intention de paiement ni les URL de reçus.
Les requêtes Stripe utilisent la version épinglée 2026-02-25.clover Version de l'API. Lorsqu'aucun enregistrement Client ne correspond, le connecteur n'inspecte pas plus de 200 paiements récents des 90 derniers jours et fait une correspondance exacte de l'e-mail localement. Ce repli pour les paiements invités est volontairement incomplet.
La recherche limitée garde la barre latérale réactive et réduit les accès inutiles aux données. Une note sous les totaux explique quand ils ne couvrent que les paiements chargés par le connecteur. Pour un audit complet de tout le compte, utilisez le tableau de bord Stripe.
Dépannage
| Symptôme | Ce qu'il faut vérifier |
|---|---|
| Stripe rejette la clé | Créez une nouvelle clé restreinte avec les autorisations de lecture requises. N'utilisez pas de clé secrète complète. |
| La barre latérale est vide pour un acheteur connu | Confirmez que l'e-mail de la conversation FreeScout correspond exactement à l'e-mail Stripe de l'acheteur. Les paiements invités ne sont vérifiés que dans le repli limité à 90 jours et 200 frais. |
| Un remboursement ou un litige est manquant | Le connecteur ne vérifie qu'un ensemble limité d'enregistrements récents pour ce client. Consultez le tableau de bord Stripe pour l'historique complet du compte. |
| Les brouillons ReplyRabbit n'incluent pas de contexte de paiement | Confirmez que les deux indicateurs d'environnement du contexte e-commerce sont true, le connecteur Stripe est disponible pour la boîte aux lettres et aucun autre fournisseur de commerce n'est actif. |
| Certains détails de paiement sont indisponibles | Pour un achat autonome, confirmez que la clé de licence du connecteur Stripe est enregistrée dans les paramètres du connecteur et active pour le domaine FreeScout prévu. Pour un accès groupé, confirmez qu'une licence ReplyRabbit Pro ou Team active est installée sur le même site FreeScout. |
Étapes suivantes
- Lire Comment configurer ReplyRabbit si la boîte aux lettres a encore besoin des paramètres de fournisseur d'IA ou de brouillon.
- Voir la Connecteur Shopify, Connecteur WooCommerce, ou Connecteur Magento guides pour d'autres plateformes de commerce.
FAQ
Le connecteur Stripe écrit-il dans Stripe ?
Non. Le connecteur utilise une clé API restreinte Stripe avec uniquement les permissions de lecture documentées. Il ne crée pas de remboursements, n'annule pas d'abonnements, ne relance pas de paiements et ne modifie pas les données Stripe.
Si aucun remboursement ni litige n'est affiché, cela signifie-t-il qu'il n'en existe aucun dans Stripe ?
Non. Le connecteur vérifie un ensemble limité d'enregistrements récents pour ce client. Un panneau vide ne décrit que ces enregistrements, pas l'historique complet du compte Stripe.
Les données Stripe peuvent-elles être utilisées dans les brouillons ReplyRabbit ?
Oui, après avoir activé à la fois le contexte commercial de ReplyRabbit et du connecteur Stripe et que Stripe est le seul fournisseur de contexte complet actif de la boîte aux lettres. Si Shopify fournit aussi un contexte commercial complet, ReplyRabbit exclut les données commerciales des brouillons jusqu'à ce qu'un seul reste activé. Les vérifications de droits Magento et WooCommerce n'entrent pas en conflit.
Combien coûte le connecteur Stripe ?
Le Stripe Connector est inclus avec un plan ReplyRabbit Pro ou Team actif. Sinon, il coûte 18 EUR en licence unique pour une installation FreeScout.
Puis-je faire correspondre un client qui écrit depuis un autre e-mail ?
Oui. Ouvrez la conversation, choisissez Link another email dans le panneau Stripe, puis sélectionnez une adresse dans le fil ou saisissez-en une. Les liens sont mémorisés pour la boîte aux lettres, de sorte que les futures conversations depuis n'importe quelle adresse liée affichent le même client Stripe. Le panneau affiche alors Manually connected, et vous pouvez dissocier depuis là.