موصل Magento
يعمل مع Magento
اربط Magento 2 أو Adobe Commerce بـ FreeScout حتى تعرض المحادثات طلبات العملاء المطابقة وسياق الشراء. تكشف وحدة Magento صغيرة للقراءة فقط ملخص دعم عبر Magento REST API، ويعرضه موصل FreeScout في الشريط الجانبي للمحادثة. كما يغذي ReplyRabbit طبقة الذكاء الاصطناعي بسياق ملكية المنتج حتى تتمكن المسودات من الإشارة إلى ما اشتراه العميل.
هل تبحث عن النظرة العامة؟
نظرة عامة
يضيف موصل Magento شريطاً جانبياً للطلب إلى محادثات FreeScout. عندما تحتوي محادثة على عنوان بريد إلكتروني لعميل، يستدعي الموصل moo-support/summary نقطة نهاية على متجر Magento الخاص بك لمطابقة الطلبات وعرضها بجوار المحادثة.
يعرض الشريط الجانبي لوحة العميل، وسجل الطلبات الكامل، وبنود كل طلب مع الكميات والأسعار، والإجماليات المالية، والقيمة الدائمة للعميل (CLV)، ومتوسط قيمة الطلب (AOV)، واستحقاق ملكية المنتج الذي يتدفق إلى سياق ReplyRabbit AI لمسودات أكثر صلة.
هناك مكونان للتثبيت:
- الـ وحدة ReplyRabbit Connector لـ Magento 2. يضيف نقطتي نهاية REST للقراءة فقط (
/rest/V1/moo-support/summaryو/rest/V1/moo-support/purchased-products) خلف إذن مسؤول مخصص يُسمى ReplyRabbit Connector API. لا يغيّر واجهة المتجر أو الدفع. - الـ وحدة موصل Magento لـ FreeScout. يستدعي تلك النقاط الطرفية عبر HTTPS باستخدام رمز وصول تكامل Magento ويعرض الشريط الجانبي للطلب. لديه صفحة إعدادات خاصة به لكل صندوق بريد في FreeScout.
يعمل الشريط الجانبي للطلبات بمفرده. استحقاق ملكية المنتج الذي يتدفق إلى مسودات الذكاء الاصطناعي هو الجزء الذي يستخدم ReplyRabbit.
المتطلبات الأساسية
قبل أن تبدأ، تأكد من أن لديك:
- تركيب FreeScout عامل.
- متجر Magento 2.4 أو أحدث (Magento Open Source أو Adobe Commerce) يمكن الوصول إليه عبر HTTPS، مع صلاحية SSH لتشغيل أوامر Magento CLI.
- وصول مسؤول Magento لإنشاء تكامل.
- تثبيت ReplyRabbit وتفعيله إذا كنت تريد سياق ملكية المنتج في مسودات الذكاء الاصطناعي.
- ترخيص Magento Connector (18 EUR دفعة واحدة، لتركيب FreeScout واحد)، أو خطة ReplyRabbit Pro أو Team نشطة، التي تتضمنه.
إذا لم يكن ReplyRabbit مثبتاً بعد، ابدأ بـ كيفية تثبيت وحدة ReplyRabbit، ثم أكمل كيفية إعداد ReplyRabbit.
قم بتثبيت وحدة Magento
تنزيل وحدة Magento
سجّل الدخول على app.replyrabbit.app ونزّل ملف ZIP لوحدة Magento من بطاقة موصل Magento.فك ضغطه في app/code
ارفع ملف ZIP إلى جذر Magento الخاص بك وفك ضغطه. ينشئapp/code/Moogento/SupportData.تفعيل الوحدة
من جذر Magento، شغّل:في متجر في وضع الإنتاج، شغّل أيضًاbashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deployكما تفعل لأي تثبيت وحدة.
تثبيتات Composer
moogento/m2-supportdata من مستودع حزمة Moogento. لا يحتاج تثبيت ZIP أعلاه إلى بيانات اعتماد Composer.إنشاء رمز تكامل Magento
يصادق الموصل باستخدام رمز وصول من Magento Integration. أنشئ واحدًا مقيّدًا بإذن القراءة فقط الخاص بالوحدة.
فتح Integrations
في لوحة إدارة Magento، انتقل إلى النظام، ثم الامتدادات، ثم التكاملات، وانقر إضافة تكامل جديد.سمّه وحدد نطاق API
أدخل اسمًا مثل "ReplyRabbit Connector" وكلمة مرور المسؤول. في API علامة التبويب، اضبط الوصول إلى الموارد إلى مخصص وحدد فقط ReplyRabbit Connector API (ضمن شجرة المسؤول العلوية). احفظ.فعّل access token وانسخه
انقر تفعيل بجوار التكامل الجديد، ثم السماح. انسخ Access Token. يعرض Magento الرمز في تفاصيل التكامل، بحيث يمكنك العودة إليه لاحقاً.
وصول للقراءة فقط
قم بتثبيت وحدة موصل FreeScout
تستدعي وحدة موصل Magento في FreeScout نقاط نهاية Magento وتعرض الشريط الجانبي للطلب في المحادثات. وهي وحدة مستقلة بإعداداتها الخاصة، منفصلة عن ReplyRabbit.
تنزيل وحدة الموصل
سجّل الدخول على app.replyrabbit.app لتنزيل ملف ZIP لوحدة موصل FreeScout. يظهر كلا التنزيلين بمجرد شراء الموصل أو امتلاك خطة ReplyRabbit Pro أو Team نشطة.رفع إلى FreeScout
في FreeScout، انتقل إلى الوحدات، انقر زر الرفع، اختر ملف ZIP، وثبّته.فعّل الوحدة
فعّل تكامل Magento الوحدة من قائمة الوحدات.
هيّئ لكل صندوق بريد
بعد تثبيت الوحدة، اربطها بمتجرك في صفحة إعدادات الموصل الخاصة بكل صندوق بريد.
افتح إعدادات الموصل
في FreeScout، افتح صندوق البريد الذي يجب أن يعرض بيانات طلبات Magento، وافتح قائمة إعدادات صندوق البريد، واختر موصل المتجر. هذه صفحة إعدادات موصل Magento، وليست قسماً داخل إعدادات ReplyRabbit.أدخل عنوان URL الأساسي لـ Magento
الصق عنوان URL الأساسي لمتجر Magento عبر HTTPS، على سبيل المثالhttps://your-store.com. لا حاجة إلى شرطة مائلة لاحقة.أدخل رمز الوصول
الصق Access Token من تكامل Magento. يتم تخزينه مشفرًا، ويتم عرض معاينة مقنعة فقط بعد الحفظ.عيّن معرّف المتجر (اختياري)
اتركه فارغًا لمطابقة الطلبات عبر جميع المتاجر. أدخل معرّف متجر Magento لتقييد الشريط الجانبي بمتجر أو عرض متجر واحد.أضف مفتاح ترخيص الموصل
إذا اشتريت الموصل، أدخل مفتاح الترخيص الخاص به. تخطَّ هذه الخطوة إذا كانت خطة ReplyRabbit Pro أو Team النشطة تغطي التثبيت.حفظ واختبار
احفظ الإعدادات. افتح محادثة FreeScout حيث يطابق بريد العميل طلب Magento وتأكد من ظهور الشريط الجانبي للطلب.
يخزن كل صندوق بريد FreeScout عنوان URL الأساسي الخاص به ورمز الوصول ومعرّف المتجر، لذا يمكنك ربط صناديق بريد مختلفة بمتاجر أو عروض متجر Magento مختلفة.
ما الذي يعرضه الموصل
- لوحة العميل للشخص الموجود في المحادثة.
- سجل الطلب الكامل مع رقم الطلب والتاريخ والحالة والإجمالي.
- بنود لكل طلب مع الكميات والأسعار.
- الإجماليات المالية (المجموع الفرعي والخصم والشحن والضريبة والاستردادات).
- القيمة الدائمة للعميل (CLV) ومتوسط قيمة الطلب (AOV).
- استحقاق ملكية المنتج لمسودات الذكاء الاصطناعي.
كيفية الحصول على الموصل
موصل Magento وحدة مدفوعة. يمكنك الحصول عليها بطريقتين:
- اشترِ Magento Connector مقابل 18 EUR كترخيص لمرة واحدة لتثبيت FreeScout واحد، ثم الصق مفتاح ترخيصه في إعدادات الموصل.
- استخدم خطة ReplyRabbit Pro أو Team نشطة، والتي تتضمن الموصل دون تكلفة إضافية.
اشترِ الترخيص أو نزّل الموصل من لوحة تحكم ReplyRabbit. زر صفحة الأسعار لخيارات خطة ReplyRabbit. إذا كانت خطة ReplyRabbit Pro أو Team النشطة تغطي التثبيت، يعمل الموصل بمجرد تكوينه، دون الحاجة إلى مفتاح ترخيص منفصل.
استكشاف الأخطاء وإصلاحها
| العَرَض | ما يجب التحقق منه |
|---|---|
| لا يظهر الشريط الجانبي للطلب | تأكد من صحة base URL وaccess token في إعدادات الموصل، ومن تفعيل لوحة صندوق البريد. |
| HTTP 404 من المتجر | وحدة ReplyRabbit Connector غير مثبّتة أو غير مفعّلة. أعد تشغيل bin/magento module:enable Moogento_SupportData و bin/magento setup:upgrade، ثم أفرغ ذاكرة التخزين المؤقت. |
| HTTP 401 أو 403 من المتجر | التكامل غير مفعّل، أو أُعيد إنشاء الرمز، أو يفتقد التكامل ReplyRabbit Connector API المورد. أعد تنشيط التكامل والصق الرمز الحالي. |
| خطأ "Connection refused" أو انتهاء المهلة | تحقق من أن خادم FreeScout يمكنه الوصول إلى URL متجرك عبر HTTPS. قد تحظر الجدران النارية أو قوائم IP المسموح بها أو وضع الصيانة الطلب. |
| تم رفض Base URL | يجب تقديم المتجر عبر HTTPS. يتم رفض http:// يُرفض عنوان URL أو مضيف غير قابل للوصول. |
| الطلبات فارغة لعميل معروف | تأكد من أن بريد العميل في محادثة FreeScout يطابق البريد في طلبات Magento الخاصة به، ومن أن معرّف المتجر (إن تم تعيينه) يطابق المتجر الذي طلب منه. |
| بنود السطر أو البيانات المالية أو CLV لا تظهر | تأكد من حفظ مفتاح ترخيص الموصل، أو من أن خطة ReplyRabbit Pro أو Team نشطة وتغطي التثبيت. |
| سياق ملكية المنتج لا يظهر في المسودات | تأكد من ترخيص الموصل، ومن تثبيت ReplyRabbit، ومن أن الموصل يعيد الطلبات، ومن تفعيل ميزة سياق الذكاء الاصطناعي لصندوق البريد. |
للمشكلات الأوسع، راجع استكشاف أخطاء ReplyRabbit وإصلاحها.
الخصوصية والتعامل مع البيانات
عندما يستعلم الموصل من Magento، يرسل عنوان البريد الإلكتروني للعميل إلى متجر Magento الخاص بك عبر HTTPS. تملأ بيانات الطلب التي يتم إرجاعها من متجرك الشريط الجانبي لـ FreeScout، ومع ReplyRabbit، تبني سياق الذكاء الاصطناعي للمسودات.
يحتاج رمز التكامل فقط إلى ReplyRabbit Connector API المورد، لذا لا يكتب الموصل أبدًا إلى متجرك. يتم تخزين الرمز مشفرًا في FreeScout، وتتحقق الطلبات الصادرة من TLS ولا تتبع أي عمليات إعادة توجيه.
لا تُرسل أي بيانات طلبات Magento إلى أطراف ثالثة إلا عبر مزود الذكاء الاصطناعي المحدد لصندوق البريد، وفقط عندما تستخدمها ميزة سياق الذكاء الاصطناعي. إذا كانت سياستك تتطلب بقاء بيانات الطلبات بالكامل على خوادمك، فاستخدم مزود ذكاء اصطناعي محليًا (مثل Ollama) لصندوق البريد.
الخطوات التالية
- إنهاء كيفية إعداد ReplyRabbit إذا كان صندوق البريد لا يزال بحاجة إلى إعدادات المزود أو السياق أو النمط.
- أيضاً على WooCommerce؟ راجع موصل WooCommerce الدليل.
الأسئلة الشائعة
هل أحتاج إلى وحدة Magento للموصل؟
نعم. يقرأ الموصل نقطة نهاية ملخص الدعم التي تضيفها وحدة ReplyRabbit Connector إلى Magento 2 REST API. هناك تنزيلان، وحدة Magento ووحدة موصل FreeScout Magento، وكلاهما متاح من حساب ReplyRabbit الخاص بك.
ما إصدارات Magento المدعومة؟
Magento 2.4 وما بعده، بما في ذلك Magento Open Source وAdobe Commerce، على PHP 8.0 حتى 8.4. Magento 1 غير مدعوم.
كم يكلف موصل Magento؟
موصل Magento مشمول مع خطة ReplyRabbit Pro أو Team نشطة. وإلا، يكلف 18 EUR كرخصة لمرة واحدة لتثبيت FreeScout واحد. إذا اشتريته، فالصق مفتاح رخصته في إعدادات الموصل.
ما الإذن الذي يحتاجه رمز الوصول؟
فقط مورد ReplyRabbit Connector API، وهو للقراءة فقط. لا يكتب الموصل أبدًا إلى متجرك، لذا لا يحتاج التكامل إلى أي أذونات إدارة أخرى.
هل يمكن لكل صندوق بريد FreeScout الاتصال بمتجر Magento مختلف؟
نعم. يخزن كل صندوق بريد عنوان URL الأساسي الخاص به ورمز الوصول ومعرّف المتجر الاختياري في إعدادات الموصل، لذا يمكن ربط متاجر أو عروض متجر مختلفة بصناديق بريد مختلفة.