
موصل Stripe لـ FreeScout
يعمل مع Stripe
يضع موصل Stripe سياق دفع العميل واشتراكه بجانب محادثة FreeScout. يستخدم مفتاح Stripe API مقيدًا للقراءة فقط، لذا يمكنه البحث عن المعلومات دون تغيير أي شيء في Stripe.
هل تبحث عن النظرة العامة؟
ما الذي يعرضه الموصل
عندما تحتوي محادثة FreeScout على عنوان بريد إلكتروني للعميل، يبحث الموصل في Stripe عن العميل المطابق وسجلات الدفع الأخيرة. اعتمادًا على ما يجده، يمكن أن تعرض الشريط الجانبي:
- هوية العميل، مع الاسم المرتبط بعميل Stripe، بالإضافة إلى البريد وتاريخ العميل منذ.
- تعرض الاشتراكات أيقونة رابط تفتح الاشتراك في Stripe، والفترة، ونقطة حالة ملونة، وسعر الوحدة للعنصر الأول مع فترة الفوترة مثل
€49/mأو€120/y، واسم المنتج (بالرجوع إلى الاسم المستعار للسعر، ثم إلى تسمية عامة). تظهر أعمدة مثل Cancels أو Trial end أو Discount فقط عندما تكون لدى الخطة. - المدفوعات في جدول بنمط الطلب: أيقونة رابط تفتح الدفع في Stripe، والتاريخ، ونقطة حالة مع أي مخاطر Radar وأيقونات فحص البطاقة، والإجمالي، وقائمة مختصرة بالعناصر المشتراة.
- تظهر المبالغ المستردة والنزاعات كتفاصيل على صف الدفع الذي تنتمي إليه. يظهر عمود التفاصيل فقط عندما يكون لدى صف واحد على الأقل شيء لعرضه.
- المدفوعات الفاشلة مع سبب رفض متاح، معروضة في عمود التفاصيل نفسه.
- مبالغ مع رمز عملة حيث يوجد، على سبيل المثال
€61أو$12.50، وإلا فرمز العملة؛ تُعرض التواريخ بشكل مختصر، مثلSep 24 '26. - إجماليات المبالغ المحصلة والاستردادات والصافي للمدفوعات المحملة.
- ربط البريد الإلكتروني: عندما يكتب العميل من عنوان مختلف عن العنوان الموجود في Stripe، اربط بريدًا إلكترونيًا من Stripe بالسلسلة وسيعرض اللوحة مدفوعات ذلك العميل.
- العلامة التجارية لطريقة دفع محفوظة وآخر أربعة أرقام وتاريخ الانتهاء.
عندما يستطيع الموصل رؤية جزء فقط من سجل الدفع، تقول ملاحظة واحدة تحت الإجماليات إن الإجماليات تغطي المدفوعات المحملة فقط. لا تتكرر على كل إجمالي.
يحد الموصل من كل عملية بحث ويتحقق فقط من السجلات المرتبطة بذلك العميل. ولا يفحص حساب Stripe بأكمله بحثًا عن النزاعات أو سجل الدفع. النتيجة الفارغة أو الجزئية لا تثبت عدم وجود سجل آخر في Stripe.
المتطلبات الأساسية
قبل أن تبدأ، تأكد من أن لديك:
- تركيب FreeScout عامل.
- وصول إلى لوحة تحكم Stripe يتيح لك إنشاء مفتاح API مقيد.
- ترخيص ReplyRabbit Pro أو Team نشط، أو ترخيص Stripe Connector مستقل. الترخيص المستقل هو 18 EUR كشراء لمرة واحدة لكل تثبيت FreeScout.
- تثبيت ReplyRabbit فقط إذا كنت تريد سياق التجارة بالذكاء الاصطناعي الاختياري والمفعّل صراحةً للمسودات.
سجّل الدخول إلى لوحة تحكم ReplyRabbit الخاصة بك. تتضمن خطة ReplyRabbit Pro أو Team النشطة تنزيل الموصل. إذا لم تكن لديك أي من الخطتين، فاشترِ الترخيص المستقل هناك، ثم نزّل الموصل واحتفظ بمفتاح ترخيصه في اللوحة.
إنشاء مفتاح Stripe API مقيد
يحتاج الموصل إلى Stripe مفتاح مقيد، وليس مفتاحاً سرياً. أنشئ مفتاحاً مقيّداً جديداً في لوحة Stripe. اضبط العملاء, الاشتراكات, الفواتير, الرسوم, PaymentIntents, PaymentMethods، و النزاعات إلى قراءة، واضبط المنتجات إلى قراءة لعرض أسماء خطط الاشتراك. بدون صلاحية قراءة المنتجات، تعود الاشتراكات إلى الاسم المستعار للسعر أو تسمية عامة. اترك كل مجموعة صلاحيات غير ذات صلة على لا شيء.
لا تلصق مفتاحًا سريًا
انسخ المفتاح المقيد عندما يعرضه Stripe. تعامل معه ككلمة مرور. يشفّره الموصل عند الحفظ ولا يعرض القيمة الكاملة مرة أخرى أبدًا.
قم بتثبيت الموصل
تنزيل موصل Stripe
سجّل الدخول على app.replyrabbit.app. نزّل الموصل عبر خطة ReplyRabbit Pro أو Team النشطة لديك، أو اشترِ ترخيص Stripe Connector المستقل أولاً.ارفعها إلى FreeScout
في FreeScout، افتح الوحدات، استخدم عنصر التحكم بالرفع لاختيار ملف ZIP، وثبّته.فعّل الوحدة
تفعيل موصل Stripe من قائمة وحدات FreeScout.
هيّئ صندوق بريد
فتح إعدادات Stripe Connector
افتح صندوق بريد FreeScout الذي يجب أن يعرض سياق دفع Stripe، ثم اختر موصل Stripe من قائمة إعداداته.الصق المفتاح المقيد
فعّل الموصل وألصق مفتاح Stripe المقيد للقراءة فقط. إذا اشتريت ترخيص الموصل المستقل، فألصق أيضًا مفتاح ترخيصه من حساب ReplyRabbit. ترخيص ReplyRabbit Pro أو Team المثبّت يفتح موصل Stripe تلقائيًا. احفظ الإعدادات.اختبر المفتاح المحفوظ
استخدم اختبر المفتاح المحفوظ للتأكد من أن Stripe يقبل المفتاح وصلاحية قراءة العملاء الخاصة به.تحقق من محادثة مطابقة
افتح محادثة يوجد بريد العميل الخاص بها في Stripe وتأكد من ظهور لوحة Stripe في الشريط الجانبي.
يخزن كل صندوق بريد FreeScout مفتاح Stripe المشفر الخاص به. يمكنك ربط حسابات Stripe مختلفة بصناديق بريد مختلفة.
طابق عميلًا يكتب من بريد إلكتروني مختلف
يطابق Stripe عنوان البريد الإلكتروني للمحادثة. عندما يكتب زميل، أو يستخدم العميل عنوانًا مختلفًا عن العنوان الموجود في عميل Stripe الخاص به، اربط البريد الإلكتروني الصحيح بالمحادثة:
ابحث عن لوحة Stripe
افتح المحادثة وابحث عن لوحة Stripe في الشريط الجانبي.ربط بريد إلكتروني آخر
اختر ربط بريد إلكتروني آخر، ثم اختر عنواناً من سلسلة الرسائل أو اكتب عنوان الفوترة المستخدم في Stripe.تحقق من اللوحة
تعرض اللوحة الآن مدفوعات ذلك العميل، وتلاحظ مرتبط بـ العنوان، ويقدم إزالة الرابط. تسرد إعدادات الموصل كل رابط محفوظ مع إزالة إجراء لكل عنوان.
يربط الربط كل عنوان غير صندوق بريد في المحادثة، والمرسل، وإلى، ونسخة، ببريد Stripe الإلكتروني الذي تختاره. تُخزَّن هذه الروابط لصندوق البريد، لذا تُحل المحادثات المستقبلية من أي منها إلى نفس عميل Stripe. لا يزال الموصل يقرأ بيانات Stripe فقط.
سياق مسودة ReplyRabbit اختياري
يعمل الشريط الجانبي دون ReplyRabbit. لا يلزم ReplyRabbit إلا إذا كنت تريد تفاصيل Stripe الأخيرة متاحة عند إنشاء مسودات AI.
للاشتراك، اضبط STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true في بيئة FreeScout، ثم قم بتمكين الموصل لصندوق البريد. بالنسبة لجانب ReplyRabbit، إما قم بتعيين REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true لكل صندوق بريد، أو اختر تشغيل لصندوق بريد واحد تحت إعدادات صندوق البريد، المنتجات، بيانات المتجر في المسودات. يظهر هذا الصف في عرض Essentials بمجرد توفر موصل متجر لصندوق البريد؛ قبل ذلك، قم بالتبديل إلى جميع الإعدادات للعثور عليه. يمكن لمسؤول FreeScout فقط تغييره. يتجاوز اختيار صندوق البريد إعداد الخادم؛ "استخدام الإعداد الافتراضي" (الافتراضي) يتبعه. كلا الإعدادين معطلان افتراضيًا. بعد تغيير قيم البيئة، قم بتشغيل php artisan config:clear من دليل FreeScout حتى يلتقط FreeScout القيم الجديدة بدلاً من تكوين مخزن مؤقتًا.
يجب أن يكون Stripe هو المزود الوحيد النشط للسياق الكامل لصندوق البريد هذا. إذا كان Shopify يزود أيضًا بسياق تجاري كامل، فسيستبعد ReplyRabbit بيانات التجارة من المسودات حتى يبقى واحد فقط مفعّلًا. لا تتعارض عمليات البحث عن استحقاقات Magento وWooCommerce. يبقى الشريط الجانبي لـ Stripe متاحًا لوكيل الدعم.
معالجة البيانات والحدود
يرسل الموصل بريد المحادثة الإلكتروني إلى Stripe عبر HTTPS للعثور على السجلات المطابقة الخاصة بالعميل. ويخزن المفتاح المقيد مشفرًا. ولا يخزن أرقام البطاقات الكاملة أو حمولات Stripe الخام أو عناوين الفوترة أو البيانات الوصفية أو أسرار نية الدفع أو عناوين URL للإيصالات.
تستخدم طلبات Stripe الإصدار المثبت 2026-02-25.clover إصدار API. عندما لا يطابق أي سجل Customer، يفحص الموصل ما لا يزيد عن 200 عملية دفع حديثة من آخر 90 يومًا ويطابق البريد الإلكتروني محليًا بشكل تام. هذا الاحتياط لمدفوعات الضيوف غير مكتمل عمدًا.
يحافظ البحث المحدود على استجابة الشريط الجانبي ويقلل الوصول غير الضروري إلى البيانات. توضح ملاحظة واحدة أسفل الإجماليات متى تغطي فقط المدفوعات التي حمّلها الموصل. لتدقيق كامل على مستوى الحساب، استخدم لوحة Stripe.
استكشاف الأخطاء وإصلاحها
| العَرَض | ما يجب التحقق منه |
|---|---|
| يرفض Stripe المفتاح | أنشئ مفتاحًا مقيدًا جديدًا بأذونات القراءة المطلوبة. لا تستخدم مفتاحًا سريًا كاملًا. |
| الشريط الجانبي فارغ لمشتر معروف | تأكد من أن بريد محادثة FreeScout يطابق تمامًا بريد المشتري في Stripe. لا يتم فحص مدفوعات الضيوف إلا ضمن الاحتياط المحدود البالغ 90 يومًا و200 عملية دفع. |
| استرداد أو نزاع مفقود | يتحقق الموصل فقط من مجموعة محدودة من السجلات الحديثة لذلك العميل. تحقق من لوحة Stripe للحصول على سجل الحساب الكامل. |
| لا تتضمن مسودات ReplyRabbit سياق الدفع | تأكد من أن كلا علمي بيئة سياق التجارة true، موصل Stripe متاح لصندوق البريد، ولا يوجد مزوّد تجارة آخر نشط. |
| بعض تفاصيل الدفع غير متاحة | بالنسبة لعملية شراء مستقلة، تأكد من حفظ مفتاح ترخيص Stripe Connector في إعدادات الموصل وأنه نشط لنطاق FreeScout المقصود. بالنسبة للوصول المجمّع، تأكد من تثبيت ترخيص ReplyRabbit Pro أو Team نشط على موقع FreeScout نفسه. |
الخطوات التالية
- قراءة كيفية إعداد ReplyRabbit إذا كان صندوق البريد لا يزال بحاجة إلى إعدادات مزود الذكاء الاصطناعي أو المسودة.
- انظر موصل Shopify, موصل WooCommerce، أو موصل Magento أدلة لمنصات التجارة الأخرى.
الأسئلة الشائعة
هل يكتب موصل Stripe إلى Stripe؟
لا. يستخدم الموصل مفتاح Stripe API مقيّدًا بأذونات القراءة الموثقة فقط. لا ينشئ عمليات استرداد ولا يلغي اشتراكات ولا يعيد محاولة الرسوم ولا يغيّر بيانات Stripe.
إذا لم يظهر أي استرداد أو نزاع، فهل يعني ذلك عدم وجود أي منها في Stripe؟
لا. يفحص الموصل مجموعة محدودة من السجلات الحديثة لذلك العميل. تصف اللوحة الفارغة تلك السجلات فقط، وليس سجل حساب Stripe الكامل.
هل يمكن استخدام بيانات Stripe في مسودات ReplyRabbit؟
نعم، بعد تمكين كل من ReplyRabbit و Stripe Connector لسياق التجارة وأن يكون Stripe هو المزود الوحيد النشط للسياق الكامل لصندوق البريد. إذا كان Shopify أيضًا يوفر سياق التجارة الكامل، فإن ReplyRabbit يترك بيانات التجارة خارج المسودات حتى يبقى واحد فقط ممكّنًا. لا تتعارض عمليات البحث عن استحقاق Magento و WooCommerce.
كم يكلف موصل Stripe؟
موصل Stripe مشمول مع خطة ReplyRabbit Pro أو Team النشطة. وإلا، يكلف 18 EUR كترخيص لمرة واحدة لتثبيت واحد لـ FreeScout.
هل يمكنني مطابقة عميل يكتب من بريد إلكتروني مختلف؟
نعم. افتح المحادثة، واختر Link another email في لوحة Stripe، واختر عنواناً من سلسلة الرسائل أو اكتب واحداً. يتم تذكر الروابط لصندوق البريد، لذا تُظهر المحادثات المستقبلية من أي عنوان مرتبط نفس عميل Stripe. تعرض اللوحة بعد ذلك Manually connected، ويمكنك إلغاء الربط من هناك.