
FreeScout向けStripeコネクター
対応: Stripe
Stripeコネクターは、顧客の支払いとサブスクリプションのコンテキストをFreeScoutの会話の横に表示します。制限付きの読み取り専用Stripe APIキーを使用するため、Stripe内の何も変更せずに情報を検索できます。
概要をお探しですか?
コネクタが表示するもの
FreeScoutの会話に顧客のメールアドレスがある場合、コネクタはStripeで一致する顧客と最近の支払い記録を検索します。見つかった内容に応じて、サイドバーには次のものが表示されます:
- 顧客の身元 (名前は Stripe 顧客にリンク)、およびメールと顧客開始日。
- サブスクリプションは、Stripeでサブスクリプションを開くリンクアイコン、期間、色付きのステータスドット、最初の項目の単価とその請求間隔(例:
€49/mまたは€120/y)、および製品名(価格のニックネーム、次に汎用ラベルにフォールバック)。キャンセル、トライアル終了、割引などの列は、プランにそれらがある場合にのみ表示されます。 - 注文形式の表での支払い: Stripeで支払いを開くリンクアイコン、日付、Radarリスクとカードチェックアイコン付きのステータスドット、合計、および購入したアイテムのトリミングされたリスト。
- 返金と紛争は、それらが属する支払い行の詳細として表示されます。詳細列は、少なくとも1つの行に表示する内容がある場合にのみ表示されます。
- 利用可能な拒否理由がある失敗した支払いを、同じDetails列に表示します。
- 存在する場合は通貨記号付きの金額、例えば
€61または$12.50)、それ以外の場合は通貨コード。日付はコンパクトに表示されます(例:Sep 24 '26. - 読み込まれた支払いのキャプチャ済み、返金、純額の合計。
- メールリンク: 顧客がStripeのアドレスとは異なるアドレスから書き込んだ場合、Stripeのメールをスレッドにリンクすると、パネルにその顧客の支払いが表示されます。
- 保存された支払い方法のブランド、下4桁、有効期限。
コネクタが支払い履歴の一部しか表示できない場合、合計の下に1つの注記で、合計は読み込まれた支払いのみを対象としていることが示されます。各合計で繰り返されることはありません。
connectorは各検索を制限し、その顧客に関連するレコードのみを確認します。紛争や支払い履歴のためにStripeアカウント全体をスキャンすることはありません。空または部分的な結果は、Stripeに他のレコードが存在しないことを証明するものではありません。
前提条件
始める前に、次を確認してください:
- 動作するFreeScoutインストール。
- 制限付きAPIキーを作成できるStripeダッシュボードへのアクセス。
- 有効な ReplyRabbit Pro または Team ライセンス、または単体の Stripe Connector ライセンス。単体ライセンスは FreeScout インストールごとに 18 EUR の買い切りです。
- 下書きにオプションで明示的に有効化するAIコマースコンテキストが必要な場合のみ、ReplyRabbitをインストールしてください。
サインイン先 ReplyRabbit ダッシュボード)。有効なReplyRabbit ProまたはTeamプランにはコネクタのダウンロードが含まれます。どちらのプランもない場合は、そこでスタンドアロンライセンスを購入し、コネクタをダウンロードしてライセンスキーをダッシュボードに保管してください。
制限付き Stripe API キーを作成
connectorにはStripeが必要です 制限付きキー)、シークレットキーではありません。Stripeダッシュボードで新しい制限付きキーを作成します。設定します 顧客, サブスクリプション, 請求書, 請求, PaymentIntents, PaymentMethods)、および 紛争 に 読み取り)、および設定します 製品 に 読み取り サブスクリプションプラン名を表示します。Products の読み取りがない場合、サブスクリプションは価格のニックネームまたは汎用ラベルにフォールバックします。無関係なすべての権限セットは なし.
シークレットキーを貼り付けないでください
Stripe が表示したときに制限付きキーをコピーします。パスワードのように扱ってください。コネクタは保存時に暗号化し、完全な値を再度表示することはありません。
コネクタをインストールする
Stripe Connectorをダウンロード
サインイン先 app.replyrabbit.app)。有効なReplyRabbit ProまたはTeamプランを通じてコネクタをダウンロードするか、先にスタンドアロンのStripe Connectorライセンスを購入してください。FreeScoutにアップロード
FreeScoutで次を開いてください モジュール)、アップロードコントロールを使用してZIPを選択し、インストールします。モジュールを有効化
有効化 Stripeコネクター FreeScoutモジュール一覧から。
メールボックスを設定
Stripe Connector 設定を開く
Stripeの支払いコンテキストを表示するFreeScoutメールボックスを開き、次を選択します Stripeコネクター その設定メニューから。制限付きキーを貼り付けます
コネクターを有効化し、制限付きの読み取り専用Stripeキーを貼り付けます。スタンドアロンコネクターライセンスを購入した場合は、ReplyRabbitアカウントのライセンスキーも貼り付けてください。ReplyRabbit ProまたはTeamライセンスがインストールされていると、Stripe Connectorが自動的にアンロックされます。設定を保存します。保存されたキーをテストする
使用 保存されたキーをテスト Stripe がキーとその顧客読み取り権限を受け入れることを確認します。一致する会話を確認する
顧客のメールアドレスがStripeに存在する会話を開き、Stripeパネルがサイドバーに表示されることを確認します。
各FreeScoutメールボックスは独自の暗号化されたStripeキーを保存します。異なるStripeアカウントを異なるメールボックスに接続できます。
別のメールから書いてくる顧客を照合する
Stripeは会話のメールアドレスで照合します。同僚が書き込んだ場合や、顧客がStripe顧客のアドレスと異なるアドレスを使用している場合は、正しいメールをスレッドにリンクしてください:
Stripeパネルを検索
会話を開き、サイドバーのStripeパネルを見つけます。別のメールをリンク
選択 別のメールをリンク)、次にスレッドからアドレスを選択するか、Stripeで使用した請求先住所を入力します。パネルを確認してください
パネルにはその顧客の支払いが表示され、次のことに注意します リンク先 アドレス、および提供 リンクを削除)。コネクタ設定には、保存されたすべてのリンクが以下とともに一覧表示されます 削除 アドレスごとのアクション。
リンクすると、スレッド内のメールボックス以外のすべてのアドレス、送信者、To、Ccが、選択したStripeメールにマッピングされます。これらのリンクはメールボックスごとに保存されるため、それらのいずれかからの今後の会話は同じStripe顧客に解決されます。コネクタは引き続きStripeデータのみを読み取ります。
オプションのReplyRabbit下書きコンテキスト
サイドバーはReplyRabbitなしで動作します。ReplyRabbitは、AI下書きを生成する際に最近のStripe詳細を利用可能にしたい場合にのみ必要です。
オプトインするには、次を設定します STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true FreeScout環境で、メールボックスのコネクタを有効にします。ReplyRabbit側では、以下を設定するか REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true すべてのメールボックスに対して、またはメールボックス設定、製品、下書きのストアデータで1つのメールボックスに対してオンを選択します。その行は、メールボックスにストアコネクタが利用可能になるとEssentialsビューに表示されます。それまでは、すべての設定に切り替えて見つけてください。FreeScout管理者のみが変更できます。メールボックスの選択はサーバー設定を上書きします。「デフォルト設定を使用」(デフォルト)はそれに従います。両方の設定はデフォルトでオフです。環境値を変更した後、以下を実行します php artisan config:clear FreeScoutディレクトリから、FreeScoutがキャッシュされた設定ではなく新しい値を取得するようにします。
Stripeはそのメールボックスで唯一のアクティブなフルコンテキストプロバイダーである必要があります。Shopifyも完全なコマースコンテキストを提供している場合、ReplyRabbitは1つだけが有効になるまでコマースデータを下書きから除外します。MagentoとWooCommerceのエンタイトルメント検索は競合しません。Stripeサイドバーはサポートエージェントが引き続き利用できます。
データ処理と制限
connectorは、一致する顧客スコープのレコードを見つけるために、HTTPS経由で会話のメールをStripeに送信します。制限されたキーは暗号化して保存されます。完全なカード番号、生のStripeペイロード、請求先住所、メタデータ、Payment Intentシークレット、レシートURLはキャッシュしません。
Stripeリクエストは固定されたものを使用します 2026-02-25.clover APIバージョン。Customerレコードが一致しない場合、コネクタは過去90日間の最大200件の最近の請求を検査し、メールをローカルで完全一致させます。このゲスト支払いのフォールバックは意図的に不完全です。
限られた検索はサイドバーの応答性を維持し、不要なデータアクセスを減らします。合計の下にある1つの注記で、connectorが読み込んだ支払いのみをカバーする場合を説明します。アカウント全体の完全な監査には、Stripeダッシュボードを使用してください。
トラブルシューティング
| 症状 | 確認すべきこと |
|---|---|
| Stripeがキーを拒否します | 必要な読み取り権限を持つ新しい制限付きキーを作成します。完全なシークレットキーは使用しないでください。 |
| 既知の購入者に対してサイドバーが空です | FreeScoutの会話メールが購入者のStripeメールと正確に一致することを確認してください。ゲスト支払いは、上限付きの90日間、200件の請求のフォールバック内でのみ確認されます。 |
| 返金または異議申し立てがありません | connectorは、その顧客の限られた最近のレコードのみを確認します。完全なアカウント履歴はStripeダッシュボードで確認してください。 |
| ReplyRabbitの下書きには支払いコンテキストが含まれません | 両方のコマースコンテキスト環境フラグが次であることを確認してください true)、Stripeコネクタがメールボックスで利用可能で、他のコマースプロバイダーが有効になっていないこと。 |
| 一部の支払い詳細は利用できません | スタンドアロン購入の場合、Stripe Connectorライセンスキーがコネクター設定に保存され、対象のFreeScoutドメインで有効であることを確認してください。バンドルアクセスの場合、有効なReplyRabbit ProまたはTeamライセンスが同じFreeScoutサイトにインストールされていることを確認してください。 |
次のステップ
- 読み取り ReplyRabbitのセットアップ方法 メールボックスにまだAIプロバイダーまたは下書き設定が必要な場合。
- 参照 Shopifyコネクター, WooCommerceコネクタ)、または Magentoコネクタ 他のコマースプラットフォーム向けガイド。
FAQ
Stripe ConnectorはStripeに書き込みますか?
いいえ。コネクタは文書化された読み取り権限のみを持つ Stripe 制限付き API キーを使用します。返金の作成、サブスクリプションのキャンセル、請求の再試行、Stripe データの変更は行いません。
返金や紛争が表示されない場合、Stripeに存在しないということですか?
いいえ。コネクタはその顧客の最近の限られたレコードをチェックします。空のパネルはそれらのレコードのみを表し、Stripe アカウントの完全な履歴ではありません。
StripeのデータをReplyRabbitの下書きで使用できますか?
はい、ReplyRabbitとStripe Connectorのコマースコンテキストの両方を有効にし、Stripeがメールボックスの唯一のアクティブなフルコンテキストプロバイダーである場合に可能です。Shopifyもフルコマースコンテキストを提供している場合、ReplyRabbitは1つだけが有効になるまでコマースデータを下書きから除外します。MagentoとWooCommerceの権限検索は競合しません。
Stripeコネクタの費用はいくらですか?
Stripe Connectorは、有効なReplyRabbit ProまたはTeamプランに含まれています。それ以外の場合は、1つのFreeScoutインストール用の買い切りライセンスとして18 EURかかります。
別のメールアドレスから書き込む顧客を照合できますか?
はい。会話を開き、StripeパネルでLink another emailを選択し、スレッドからアドレスを選ぶか入力してください。リンクはメールボックスごとに記憶されるため、リンクされたアドレスからの今後の会話は同じStripe顧客を表示します。パネルにはManually connectedと表示され、そこからリンクを解除できます。