موصل Shopify
يعمل مع Shopify
اربط Shopify بـ FreeScout حتى تعرض المحادثات طلبات العملاء المطابقة وسياق الشراء. تنشئ تطبيقًا مخصصًا للقراءة فقط في لوحة إدارة Shopify وتلصق رمز الوصول الخاص به في FreeScout، فلا حاجة إلى حساب شريك أو مراجعة تطبيق. كما يغذي ReplyRabbit طبقة الذكاء الاصطناعي بسياق ملكية المنتج حتى تتمكن المسودات من الإشارة إلى ما اشتراه العميل.
هل تبحث عن النظرة العامة؟
نظرة عامة
يضيف موصل Shopify شريطاً جانبياً للطلب إلى محادثات FreeScout. عندما تحتوي محادثة على عنوان بريد إلكتروني لعميل، يستعلم الموصل واجهة Shopify GraphQL Admin API على متجرك بحثاً عن الطلبات المطابقة ويعرضها بجانب المحادثة.
يعرض الشريط الجانبي لوحة العميل، وسجل الطلبات الكامل، وبنود كل طلب مع الكميات والأسعار، والإجماليات المالية، والقيمة الدائمة للعميل (CLV)، ومتوسط قيمة الطلب (AOV)، واستحقاق ملكية المنتج الذي يتدفق إلى سياق ReplyRabbit AI لمسودات أكثر صلة.
هناك مكون واحد للتثبيت: وحدة موصل Shopify لـ FreeScout. يقرأ Shopify GraphQL Admin API عبر HTTPS باستخدام رمز وصول Admin API من تطبيق مخصص، ثم يعرض الشريط الجانبي للطلب. لديه صفحة إعدادات خاصة به لكل صندوق بريد في FreeScout.
يعمل الشريط الجانبي للطلبات بمفرده. استحقاق ملكية المنتج الذي يتدفق إلى مسودات الذكاء الاصطناعي هو الجزء الذي يستخدم ReplyRabbit.
المتطلبات الأساسية
قبل أن تبدأ، تأكد من أن لديك:
- تركيب FreeScout عامل.
- متجر Shopify على
your-store.myshopify.comالنطاق (أو نطاق مخصص يعيّن إلى واحد)، مع أذونات الموظفين لتطوير التطبيقات. - تثبيت ReplyRabbit وتفعيله إذا كنت تريد سياق ملكية المنتج في مسودات الذكاء الاصطناعي.
- ترخيص Shopify Connector (18 EUR دفعة واحدة، لتركيب FreeScout واحد)، أو خطة ReplyRabbit Pro أو Team نشطة، التي تتضمنه.
إذا لم يكن ReplyRabbit مثبتاً بعد، ابدأ بـ كيفية تثبيت وحدة ReplyRabbit، ثم أكمل كيفية إعداد ReplyRabbit.
إنشاء تطبيق مخصص في Shopify
يصادق الموصل باستخدام رمز وصول Admin API من تطبيق مخصص موجود داخل متجرك.
فتح Develop apps
في لوحة إدارة Shopify، انتقل إلى الإعدادات، ثم التطبيقات وقنوات البيع، ثم تطوير التطبيقات. إذا طُلب منك، فاسمح بتطوير التطبيقات المخصصة.إنشاء التطبيق
انقر إنشاء تطبيق، سمّه "ReplyRabbit Connector"، وأنشئه.عيّن نطاقات Admin API
فتح هيّئ نطاقات Admin API وحددread_customers,read_orders، وread_products. حدّدread_all_ordersأيضاً إذا كنت تريد سجل طلبات أقدم من 60 يوماً. احفظ.ثبّت وانسخ الرمز
انقر تثبيت التطبيق، ثم اكشف الرمز مرة واحدة وانسخ رمز وصول Admin API (يبدأ بـshpat_). يعرضه Shopify مرة واحدة فقط، لذا خزّنه في مكان آمن.
وصول للقراءة فقط
قم بتثبيت وحدة موصل FreeScout
تنزيل وحدة الموصل
نزّل وحدة موصل FreeScout بصيغة ZIP من لوحة تحكم ReplyRabbit. يظهر التنزيل بمجرد شرائك الموصل أو امتلاكك خطة ReplyRabbit Pro أو Team نشطة.رفع إلى FreeScout
في FreeScout، انتقل إلى الوحدات، انقر زر الرفع، اختر ملف ZIP، وثبّته.فعّل الوحدة
فعّل تكامل Shopify الوحدة من قائمة الوحدات.
هيّئ لكل صندوق بريد
افتح إعدادات الموصل
في FreeScout، افتح صندوق البريد الذي يجب أن يعرض بيانات طلبات Shopify، وافتح قائمة إعدادات صندوق البريد، واختر موصل المتجر. هذه صفحة إعدادات موصل Shopify، وليست قسماً داخل إعدادات ReplyRabbit.أدخل نطاق المتجر ورمز الوصول
أدخل نطاق متجرك، على سبيل المثالyour-store.myshopify.com، والصق رمز وصول Admin API. احفظ. يتحقق الموصل من الرمز والنطاقات مقابل متجرك قبل تخزينه؛ يُخزّن الرمز مشفّراً ولا يُعرض مرة أخرى.أضف مفتاح ترخيص الموصل
إذا اشتريت الموصل، اضبطSHOPIFYINTEGRATION_LICENSE_KEYفي FreeScout الخاص بك.envإلى مفتاح الترخيص الخاص به. تخطَّ هذه الخطوة إذا كانت خطة ReplyRabbit Pro أو Team نشطة تغطي التثبيت.اختبار
افتح محادثة FreeScout حيث يطابق بريد العميل طلب Shopify وتأكد من ظهور الشريط الجانبي للطلب.
يخزن كل صندوق بريد FreeScout نطاق متجره ورمز الوصول الخاص به، لذا يمكنك ربط صناديق بريد مختلفة بمتاجر مختلفة.
ما الذي يعرضه الموصل
- لوحة العميل للشخص الموجود في المحادثة.
- سجل الطلب الكامل مع رقم الطلب والتاريخ والحالة والإجمالي.
- بنود لكل طلب مع الكميات والأسعار.
- الإجماليات المالية (المجموع الفرعي والخصم والشحن والضريبة والاستردادات).
- القيمة الدائمة للعميل (CLV) ومتوسط قيمة الطلب (AOV).
- استحقاق ملكية المنتج لمسودات الذكاء الاصطناعي.
كيفية الحصول على الموصل
موصل Shopify وحدة مدفوعة. يمكنك الحصول عليها بطريقتين:
- اشترِ Shopify Connector مقابل 18 EUR كترخيص لمرة واحدة لتثبيت FreeScout واحد، ثم عيّن مفتاح ترخيصه كـ
SHOPIFYINTEGRATION_LICENSE_KEYفي FreeScout.env. - استخدم خطة ReplyRabbit Pro أو Team نشطة، والتي تتضمن الموصل دون تكلفة إضافية.
اشترِ الترخيص أو نزّل الموصل من لوحة تحكم ReplyRabbit. زر صفحة الأسعار لخيارات خطة ReplyRabbit. إذا كانت خطة ReplyRabbit Pro أو Team النشطة تغطي التثبيت، يعمل الموصل بمجرد تكوينه، دون الحاجة إلى مفتاح ترخيص منفصل.
استكشاف الأخطاء وإصلاحها
| العَرَض | ما يجب التحقق منه |
|---|---|
| "رفض Shopify الاتصال" عند الحفظ | تم إدخال الرمز بشكل خاطئ أو إلغاؤه أو أنه ينتمي إلى متجر مختلف. اكشف رمزًا جديدًا بإعادة تثبيت التطبيق المخصص والصقه مرة أخرى. |
| "نطاقات Admin API هذه مفقودة" عند الحفظ | افتح التطبيق المخصص، وأضف النطاقات المفقودة تحت هيّئ نطاقات Admin API، احفظ، وأعد تثبيت التطبيق. إعادة التثبيت تصدر رمزاً جديداً. |
| نطاق المتجر مرفوض | استخدم your-store.myshopify.com النطاق، أو نطاق مخصص يعيّن إليه. يتم رفض المضيفين الخاصين وعناوين IP. |
| لا يظهر الشريط الجانبي للطلب | تأكد من تفعيل لوحة صندوق البريد ومن ظهور الاتصال كمتصل في صفحة الإعدادات. |
| الطلبات فارغة لعميل معروف | تأكد من أن بريد العميل في محادثة FreeScout يطابق البريد في طلبات Shopify الخاصة به. |
| تظهر فقط طلبات آخر 60 يومًا | أضف read_all_orders النطاق إلى التطبيق المخصص، وأعد تثبيته، والصق الرمز الجديد. |
| بنود السطر أو البيانات المالية أو CLV لا تظهر | تأكد من حفظ مفتاح ترخيص الموصل، أو من أن خطة ReplyRabbit Pro أو Team نشطة وتغطي التثبيت. |
| سياق ملكية المنتج لا يظهر في المسودات | تأكد من ترخيص الموصل، ومن تثبيت ReplyRabbit، ومن أن الموصل يعيد الطلبات، ومن تفعيل ميزة سياق الذكاء الاصطناعي لصندوق البريد. |
للمشكلات الأوسع، راجع استكشاف أخطاء ReplyRabbit وإصلاحها.
الخصوصية والتعامل مع البيانات
عندما يستعلم الموصل من Shopify، يرسل عنوان البريد الإلكتروني للعميل إلى Shopify GraphQL Admin API عبر HTTPS باستخدام رمز تطبيقك المخصص. تملأ بيانات الطلب التي يتم إرجاعها من متجرك الشريط الجانبي لـ FreeScout، ومع ReplyRabbit، تبني سياق الذكاء الاصطناعي للمسودات.
التطبيق المخصص لديه نطاقات قراءة فقط، لذا لا يكتب الموصل أبدًا إلى متجرك. يُخزن رمز الوصول مشفرًا في FreeScout، وتتحقق الطلبات الصادرة من TLS ولا تتبع أي عمليات إعادة توجيه.
لا تُرسل أي بيانات طلبات Shopify إلى أطراف ثالثة إلا عبر مزود الذكاء الاصطناعي المحدد لصندوق البريد، وفقط عندما تستخدمها ميزة سياق الذكاء الاصطناعي. إذا كانت سياستك تتطلب بقاء بيانات الطلبات بالكامل على خوادمك، فاستخدم مزود ذكاء اصطناعي محليًا (مثل Ollama) لصندوق البريد.
الخطوات التالية
- إنهاء كيفية إعداد ReplyRabbit إذا كان صندوق البريد لا يزال بحاجة إلى إعدادات المزود أو السياق أو النمط.
- أيضاً على WooCommerce أو Magento؟ راجع موصل WooCommerce و موصل Magento الأدلة.
الأسئلة الشائعة
كيف يتصل موصل Shopify بمتجري؟
مع تطبيق مخصص تنشئه في مسؤول Shopify (الإعدادات، التطبيقات وقنوات البيع، تطوير التطبيقات). امنحه نطاقات read_customers و read_orders و read_products، وثبته، والصق رمز وصول Admin API مع نطاق متجرك في إعدادات موصل FreeScout. يتحقق الموصل من الرمز مقابل متجرك قبل حفظه.
هل أحتاج إلى حساب Shopify Partner أو إدراج في App Store؟
لا. يُنشأ التطبيق المخصص داخل لوحة إدارة متجرك، ولا يحتاج إلى حساب شريك ولا مراجعة تطبيق ولا إدراج عام.
كم يكلف موصل Shopify؟
موصل Shopify مشمول مع خطة ReplyRabbit Pro أو Team نشطة. وإلا، يكلف 18 EUR كرخصة لمرة واحدة لتثبيت FreeScout واحد. إذا اشتريته، فاضبط مفتاح رخصته كـ SHOPIFYINTEGRATION_LICENSE_KEY في ملف .env الخاص بـ FreeScout.
لماذا أرى فقط الطلبات من آخر 60 يومًا؟
تحد Shopify التطبيقات بسجل طلبات لمدة 60 يومًا ما لم يكن للتطبيق نطاق read_all_orders. حدّد read_all_orders عند إعداد التطبيق المخصص لرؤية السجل الكامل.
هل يمكن لكل صندوق بريد FreeScout الاتصال بمتجر Shopify مختلف؟
نعم. يخزن كل صندوق بريد نطاق متجره ورمز الوصول في إعدادات الموصل، لذا يمكن ربط متاجر مختلفة بصناديق بريد مختلفة.