
موصل WooCommerce
يعمل مع WooCommerce
اربط WooCommerce بـ FreeScout حتى تعرض المحادثات طلبات العملاء المطابقة وسياق الشراء. يتصل الموصل مباشرة بـ WooCommerce REST API، فلا حاجة إلى تثبيت إضافة على جانب المتجر. كما يغذي ReplyRabbit طبقة الذكاء الاصطناعي بسياق ملكية المنتج حتى تتمكن المسودات من الإشارة إلى ما اشتراه العميل.
هل تبحث عن النظرة العامة؟
نظرة عامة
يضيف موصل WooCommerce لوحة طلبات جانبية إلى محادثات FreeScout. عندما تحتوي المحادثة على عنوان بريد إلكتروني للعميل، يستعلم الموصل من WooCommerce REST API (wc/v3) على متجرك لمطابقة الطلبات ويعرضها بجانب المحادثة.
يعرض الشريط الجانبي لوحة العميل، وسجل الطلبات الكامل، وبنود كل طلب مع الكميات والأسعار، والإجماليات المالية، والقيمة الدائمة للعميل (CLV)، ومتوسط قيمة الطلب (AOV)، واستحقاق ملكية المنتج الذي يتدفق إلى سياق ReplyRabbit AI لمسودات أكثر صلة.
هناك مكون واحد للتثبيت: وحدة موصل WooCommerce لـ FreeScout. يقرأ WooCommerce REST API عبر HTTPS باستخدام مفتاح وسر المستهلك، ثم يعرض الشريط الجانبي للطلب. لديه صفحة إعدادات خاصة به لكل صندوق بريد في FreeScout.
يعمل الشريط الجانبي للطلبات بمفرده. استحقاق ملكية المنتج الذي يتدفق إلى مسودات الذكاء الاصطناعي هو الجزء الذي يستخدم ReplyRabbit.
المتطلبات الأساسية
قبل أن تبدأ، تأكد من أن لديك:
- تركيب FreeScout عامل.
- متجر WooCommerce يمكن الوصول إليه عبر HTTPS، مع صلاحية وصول إدارية لإنشاء مفاتيح REST API.
- متجر غير محمي بمصادقة HTTP الأساسية على مستوى الموقع بأكمله، والتي تتعارض مع ترويسة مصادقة REST API.
- تثبيت ReplyRabbit وتفعيله إذا كنت تريد سياق ملكية المنتج في مسودات الذكاء الاصطناعي.
- ترخيص WooCommerce Connector (18 EUR دفعة واحدة، لتركيب FreeScout واحد)، أو خطة ReplyRabbit Pro أو Team نشطة، التي تتضمنه.
إذا لم يكن ReplyRabbit مثبتاً بعد، ابدأ بـ كيفية تثبيت وحدة ReplyRabbit، ثم أكمل كيفية إعداد ReplyRabbit.
إنشاء مفاتيح WooCommerce REST API
يصادق الموصل باستخدام مفتاح WooCommerce REST API، المكوّن من مفتاح وسر المستهلك. أنشئ المفتاح في لوحة إدارة WordPress.
افتح إعدادات REST API
في لوحة إدارة WordPress، انتقل إلى WooCommerce، ثم الإعدادات، ثم متقدم، ثم REST API.إضافة مفتاح
انقر إضافة مفتاح. أدخل وصفاً مثل "ReplyRabbit Connector"، واضبط الأذونات إلى قراءة، وانقر إنشاء مفتاح API.انسخ مفتاح المستهلك والسر
انسخ مفتاح المستهلك و سر المستهلك. يعرض WooCommerce السر مرة واحدة، لذا خزّن القيمتين في مكان آمن قبل مغادرة الصفحة.
وصول للقراءة فقط
قم بتثبيت وحدة موصل FreeScout
تستعلم وحدة موصل WooCommerce في FreeScout واجهة WooCommerce REST API وتعرض الشريط الجانبي للطلب في المحادثات. وهي وحدة مستقلة بإعداداتها الخاصة، منفصلة عن ReplyRabbit.
تنزيل وحدة الموصل
سجّل الدخول على app.replyrabbit.app لتنزيل ملف ZIP لوحدة موصل FreeScout. يظهر التنزيل بمجرد شراء الموصل أو امتلاك خطة ReplyRabbit Pro أو Team نشطة.رفع إلى FreeScout
في FreeScout، انتقل إلى الوحدات، انقر زر الرفع، اختر ملف ZIP، وثبّته.فعّل الوحدة
فعّل WooCommerce الوحدة من قائمة الوحدات.
هيّئ لكل صندوق بريد
بعد تثبيت الوحدة، اربطها بمتجرك في صفحة إعدادات الموصل الخاصة بكل صندوق بريد.
افتح إعدادات الموصل
في FreeScout، افتح صندوق البريد الذي يجب أن يعرض بيانات طلبات WooCommerce، وافتح قائمة إعدادات صندوق البريد، واختر موصل المتجر. هذه صفحة إعدادات موصل WooCommerce، وليست قسماً داخل إعدادات ReplyRabbit.أدخل عنوان URL للمتجر
الصق عنوان URL الأساسي لمتجر WooCommerce عبر HTTPS، على سبيل المثالhttps://your-store.com. لا حاجة إلى شرطة مائلة لاحقة.أدخل مفتاح المستهلك والسر
الصق مفتاح المستهلك و سر المستهلك التي أنشأتها في WooCommerce. تُخزَّن مشفرة، ولا يُعرض سوى معاينة مقنّعة بعد الحفظ.أضف مفتاح ترخيص الموصل
إذا اشتريت الموصل، أدخل مفتاح الترخيص الخاص به. تخطَّ هذه الخطوة إذا كانت خطة ReplyRabbit Pro أو Team النشطة تغطي التثبيت.حفظ واختبار
احفظ الإعدادات. افتح محادثة FreeScout حيث يطابق بريد العميل طلب WooCommerce وتأكد من ظهور الشريط الجانبي للطلب.
يخزن كل صندوق بريد FreeScout عنوان URL الخاص بمتجره ومفاتيح REST API الخاصة به، لذا يمكنك ربط صناديق بريد مختلفة بمتاجر WooCommerce مختلفة.
ما الذي يعرضه الموصل
- لوحة العميل للشخص الموجود في المحادثة.
- سجل الطلب الكامل مع رقم الطلب والتاريخ والحالة والإجمالي.
- بنود لكل طلب مع الكميات والأسعار.
- الإجماليات المالية (المجموع الفرعي والخصم والشحن والضريبة والاستردادات).
- القيمة الدائمة للعميل (CLV) ومتوسط قيمة الطلب (AOV).
- استحقاق ملكية المنتج لمسودات الذكاء الاصطناعي.
كيفية الحصول على الموصل
موصل WooCommerce وحدة مدفوعة. يمكنك الحصول عليها بطريقتين:
- اشترِ WooCommerce Connector مقابل 18 EUR كترخيص لمرة واحدة لتثبيت FreeScout واحد، ثم الصق مفتاح ترخيصه في إعدادات الموصل.
- استخدم خطة ReplyRabbit Pro أو Team نشطة، والتي تتضمن الموصل دون تكلفة إضافية.
اشترِ الترخيص أو نزّل الموصل من لوحة تحكم ReplyRabbit. زر صفحة الأسعار لخيارات خطة ReplyRabbit. إذا كانت خطة ReplyRabbit Pro أو Team النشطة تغطي التثبيت، يعمل الموصل بمجرد تكوينه، دون الحاجة إلى مفتاح ترخيص منفصل.
استكشاف الأخطاء وإصلاحها
| العَرَض | ما يجب التحقق منه |
|---|---|
| لا يظهر الشريط الجانبي للطلب | تأكد من صحة عنوان URL للمتجر ومفتاح المستهلك وسر المستهلك في إعدادات الموصل، ومن تفعيل لوحة صندوق البريد. |
| خطأ "Connection refused" أو انتهاء المهلة | تحقق من أن خادم FreeScout يمكنه الوصول إلى URL متجرك عبر HTTPS. قد تحظر الجدران النارية أو قوائم IP المسموح بها أو وضع الصيانة الطلب. |
| عنوان URL للمتجر مرفوض | يجب تقديم المتجر عبر HTTPS. يتم رفض http:// يُرفض عنوان URL أو مضيف غير قابل للوصول. |
| فشل المصادقة | تأكد من أن المتجر غير محمي بمصادقة HTTP الأساسية على مستوى الموقع بأكمله، لأنها تعترض ترويسة مصادقة REST API قبل أن تصل إلى WooCommerce. |
| مفتاح المستهلك أو السر مرفوض | أعد إنشاء المفتاح في WooCommerce ضمن الإعدادات، ثم متقدم، ثم REST API، مع قراءة الصلاحية، والصق مفتاح المستهلك والسر الجديدين في إعدادات الموصل. |
| الطلبات فارغة لعميل معروف | تأكد من أن بريد العميل في محادثة FreeScout يطابق بريد الفوترة في طلبات WooCommerce الخاصة به. |
| بنود السطر أو البيانات المالية أو CLV لا تظهر | تأكد من حفظ مفتاح ترخيص الموصل، أو من أن خطة ReplyRabbit Pro أو Team نشطة وتغطي التثبيت. |
| سياق ملكية المنتج لا يظهر في المسودات | تأكد من ترخيص الموصل، ومن تثبيت ReplyRabbit، ومن أن الموصل يعيد الطلبات، ومن تفعيل ميزة سياق الذكاء الاصطناعي لصندوق البريد. |
للمشكلات الأوسع، راجع استكشاف أخطاء ReplyRabbit وإصلاحها.
الخصوصية والتعامل مع البيانات
عندما يستعلم الموصل من WooCommerce، يرسل عنوان البريد الإلكتروني للعميل إلى WooCommerce REST API الخاص بك عبر HTTPS. تملأ بيانات الطلب التي يتم إرجاعها من متجرك الشريط الجانبي لـ FreeScout، ومع ReplyRabbit، تبني سياق الذكاء الاصطناعي للمسودات.
مفتاح REST API يحتاج فقط إلى قراءة الصلاحية، لذا لا يكتب الموصل أبدًا إلى متجرك. يتم تخزين مفتاح المستهلك والسر مشفرين في FreeScout، وتتحقق الطلبات الصادرة من TLS ولا تتبع أي عمليات إعادة توجيه.
لا تُرسل أي بيانات طلبات WooCommerce إلى أطراف ثالثة إلا عبر مزود الذكاء الاصطناعي المحدد لصندوق البريد، وفقط عندما تستخدمها ميزة سياق الذكاء الاصطناعي. إذا كانت سياستك تتطلب بقاء بيانات الطلبات بالكامل على خوادمك، فاستخدم مزود ذكاء اصطناعي محليًا (مثل Ollama) لصندوق البريد.
الخطوات التالية
- إنهاء كيفية إعداد ReplyRabbit إذا كان صندوق البريد لا يزال بحاجة إلى إعدادات المزود أو السياق أو النمط.
- انظر كيفية تثبيت وحدة ReplyRabbit إذا لم تكن قد ثبّت ReplyRabbit بعد.
الأسئلة الشائعة
هل أحتاج إلى إضافة WordPress لموصل WooCommerce؟
لا. يتحدث الموصل مباشرة إلى WooCommerce REST API. تولّد مفتاح REST API في WooCommerce وتدخل عنوان URL للمتجر ومفتاح المستهلك وسر المستهلك في موصل FreeScout. هناك تنزيل واحد، وهو وحدة موصل WooCommerce لـ FreeScout.
كم يكلف موصل WooCommerce؟
موصل WooCommerce مشمول مع خطة ReplyRabbit Pro أو Team النشطة. وإلا، يكلف 18 EUR كترخيص لمرة واحدة لتثبيت واحد لـ FreeScout. إذا اشتريته، فالصق مفتاح الترخيص في إعدادات الموصل.
كيف يطابق الموصل العملاء؟
يبحث الموصل عن طلبات WooCommerce باستخدام عنوان البريد الإلكتروني للعميل في محادثة FreeScout. بالنسبة لملكية المنتج، يتحقق أيضًا من رسائل البريد الإلكتروني المرتبطة، وكخيار احتياطي بأفضل جهد، من الطلبات المدفوعة الأخرى على نفس نطاق البريد الإلكتروني.
ما الإذن الذي يحتاجه مفتاح REST API؟
للقراءة فقط. لا يكتب الموصل أبدًا إلى متجرك، لذا يكفي مفتاح بصلاحية Read.
هل يمكن لكل صندوق بريد FreeScout الاتصال بمتجر WooCommerce مختلف؟
نعم. يخزن كل صندوق بريد عنوان URL الخاص بمتجره ومفاتيح REST API الخاصة به في إعدادات الموصل، لذا يمكن ربط متاجر مختلفة بصناديق بريد مختلفة.