SkyLight Chat
دليل المنتج

تكامل سلة

اربط متجر سلة الخاص بك بـ SkyLight Chat لمزامنة الطلبات واسترداد السلال المهجورة وأداة الدردشة في واجهة المتجر وإشعارات واتساب التلقائية.

تكامل سلة

اربط متجر سلة للتجارة الإلكترونية مع SkyLight Chat لأتمتة التواصل مع العملاء واسترداد السلال المهجورة وتقديم الدعم الفوري عبر واتساب والدردشة الحية.


الغرض

يُزامن تكامل سلة بيانات متجرك إلى SkyLight Chat حتى تتمكن من:

  • مزامنة المنتجات — يصل كتالوج المتجر إلى قاعدة معرفة من نوع كتالوج منتجات مع الأسعار والمخزون والصور وpurchase_url لكل منتج (متاح أيضًا عبر API قاعدة المعرفة).
  • مزامنة الطلبات — استيراد تفاصيل الطلب والحالة ومعلومات العميل إلى SkyLight Chat.
  • دفع تغييرات الحالة إلى سلة — التأكيد أو الإلغاء أو متابعة التنفيذ من SkyLight Chat (أو API الطلبات)؛ تُرسل التغييرات إلى سلة عبر API ثم تُحفظ محليًا.
  • استرداد السلال المهجورة — إرسال تذكيرات واتساب بمحتويات السلة وروابط الدفع.
  • تضمين أداة واجهة المتجر — إضافة الدردشة الحية إلى متجر سلة الخاص بك.
  • أتمتة الإشعارات — تأكيدات الطلبات وتحديثات الشحن وتنبيهات التسليم.
  • إثراء جهات الاتصال — إنشاء أو تحديث جهات الاتصال تلقائيًا من عملاء سلة.

صلاحيات الوصول

الدورالصلاحيات
المالكوصول كامل — الربط وقطع الاتصال وتكوين المزامنة وإدارة الأداة
المشرفوصول كامل
العضوعرض البيانات المُزامنة؛ لا يمكنه تغيير إعدادات التكامل
المشاهدقراءة فقط

المتطلبات الأساسية

  1. متجر سلة نشط — يجب أن يكون لديك حساب تاجر في سلة.
  2. تطبيق SkyLight Chat مثبت على سلة — ثبّته من متجر تطبيقات سلة.
  3. قناة واتساب متصلة — مطلوبة لاسترداد السلال وإشعارات الطلبات.
  4. واتساب متصل — لرسائل استرداد السلال المهجورة.

الشرح التفصيلي الكامل

إنشاء رمز الاتصال

  1. في SkyLight Chat، اذهب إلى التكاملات ← سلة.
  2. انقر على إنشاء رمز الاتصال.
  3. انسخ الرمز (مثال: SC-A1B2C3D4).

الاتصال في سلة

  1. سجّل الدخول إلى لوحة تحكم سلة.
  2. اذهب إلى الإعدادات ← التطبيقات والتكاملات.
  3. ابحث عن SkyLight Chat وانقر على تثبيت (أو افتح إذا كان مثبتًا مسبقًا).
  4. الصق رمز الاتصال في الحقل المخصص.
  5. انقر على اتصال.
  6. عد إلى SkyLight Chat؛ يجب أن تظهر الحالة الآن متصل.

تكوين إعدادات المزامنة

  1. افتح تبويب إعدادات المزامنة.
  2. بدّل:
    • مزامنة الطلبات — استيراد الطلبات الجديدة والمُحدّثة.
    • مزامنة جهات الاتصال — إنشاء جهات اتصال من عملاء سلة.
    • استرداد السلال المهجورة — تفعيل تذكيرات السلال.
  3. اختر تكرار المزامنة:
    • فوري (مدفوع بخطافات الويب)
    • كل 5 دقائق
    • كل 15 دقيقة
    • كل ساعة
  4. انقر على حفظ.

إعداد استرداد السلال المهجورة

  1. اذهب إلى تبويب السلال المهجورة.
  2. اكتب رسالة الاسترداد باستخدام متغيرات السلة (انظر القاموس أدناه).
  3. عيّن التأخير — الدقائق للانتظار بعد هجر السلة قبل الإرسال (مثال: 30، 60، 120).
  4. عيّن المتغيرات باستخدام العناصر النائبة المتاحة:
المتغيرالوصفمثال الإخراج
{name}الاسم الأول للعميلسارة
{total}المبلغ الإجمالي للسلة299.00
{currency}رمز عملة المتجرSAR
{checkout_url}رابط مباشر لاستئناف الدفعhttps://store.salla.sa/cart/abc123
{items}أسماء المنتجات مفصولة بفواصلقميص أزرق، حذاء رياضي
{store_name}اسم متجر سلة الخاص بكأزياء النخيل
  1. عاين الرسالة للتحقق من وضع المتغيرات.
  2. انقر على حفظ وتفعيل.

تفعيل أداة واجهة المتجر

  1. افتح تبويب الأداة.
  2. بدّل تفعيل الأداة إلى تشغيل.
  3. خصّص:
    • الموضع — أسفل اليسار أو أسفل اليمين.
    • اللون الرئيسي — ليتطابق مع علامتك التجارية (منتقي ألوان سداسية).
    • رسالة الترحيب — التحية المعروضة عند فتح الأداة.
  4. انسخ مقتطف كود التضمين.
  5. في قالب سلة الخاص بك، الصق المقتطف قبل وسم </body> الإغلاق.
  6. احفظ وانشر القالب.

تظهر الأداة الآن في واجهة متجرك، مما يتيح للزوار الدردشة عبر واتساب أو الدردشة الحية.

عرض الطلبات المُزامنة

تظهر الطلبات المُزامنة ضمن الطلبات في SkyLight Chat. يُظهر كل طلب:

  • اسم العميل ورابط جهة الاتصال
  • رقم الطلب والحالة
  • عناصر الطلب بالكميات والأسعار
  • عنوان الشحن
  • طوابع الإنشاء والتحديث
  • شارة المصدر سلة (created_by = salla)

تأكيد أو إلغاء طلبات سلة من SkyLight

تغييرات الحالة لطلبات سلة ثنائية الاتجاه:

  1. افتح الطلب في SkyLight Chat (أو استدعِ PUT /api/v1/orders/{id} / POST /api/v1/orders/{id}/cancel).
  2. أكّد أو ألغِ أو انتقل إلى الحالة المسموحة التالية.
  3. يدفع SkyLight الحالة المطابقة إلى سلة (POST …/orders/{salla_id}/status) ثم يحدّث الطلب محليًا.
  4. تُبقي خطافات سلة / المزامنة لاحقًا الطرفين متوافقين.
حالة SkyLightتُرسل إلى سلة (slug)
مؤكد / قيد التجهيزin_progress
تم الشحنshipped
تم التوصيلdelivered
ملغيcanceled

يتطلب اتصال سلة نشطًا بصلاحية orders.read_write. تعديل عناصر طلبات سلة يبقى من لوحة سلة فقط (لا يُدفع من SkyLight).

المزامنة اليدوية

انقر على مزامنة الآن في تبويب إعدادات المزامنة لتشغيل سحب فوري للطلبات وجهات الاتصال.

قطع اتصال سلة

  1. اذهب إلى التكاملات ← سلة.
  2. انقر على قطع الاتصال.
  3. أكّد مربع الحوار.

يوقف قطع الاتصال جميع عمليات المزامنة ويُعطّل الأداة. تبقى البيانات التاريخية في SkyLight Chat.


قاموس الحقول

الحقلالوصف
رمز الاتصالرمز فريد يربط SkyLight Chat بتطبيق سلة
اسم المتجراسم عرض متجر سلة
مزامنة الطلباتمفتاح لاستيراد الطلبات
مزامنة جهات الاتصالمفتاح لإنشاء جهات اتصال من العملاء
استرداد السلال المهجورةمفتاح لإرسال تذكيرات السلال
تكرار المزامنةعدد مرات سحب البيانات
التأخيرالدقائق قبل إرسال رسالة السلة المهجورة
كود تضمين الأداةمقتطف JavaScript لواجهة متجرك

الحالات والشارات

الحالةلون الشارةالمعنى
متصلأخضرالتكامل نشط
غير متصلرماديغير مرتبط
جارٍ المزامنةأزرقنقل البيانات قيد التقدم
خطأأحمرفشلت المزامنة؛ تحقق من السجلات

حالات مزامنة الطلبات

الحالةالمعنى
قيد الانتظارالطلب في انتظار المعالجة
مؤكدالطلب مؤكد من المتجر
قيد المعالجةالطلب قيد التحضير
تم الشحنالطلب أُرسل
تم التوصيلالطلب اكتمل
ملغىالطلب ملغى

الشاشات الفرعية

تبويب السلال المهجورة

القسمالمحتويات
رسالة الاستردادمربع نص مع متغيرات السلة
إدخال التأخيرالدقائق (رقمي)
تعيين المتغيراتيُظهر العناصر النائبة المتاحة وحقول جهات الاتصال
المعاينةمعاينة مباشرة للرسالة ببيانات نموذجية
مفتاح التفعيلتشغيل/إيقاف لاسترداد السلال

تبويب الأداة

القسمالمحتويات
مفتاح التفعيلتشغيل/إيقاف
الموضعأزرار اختيار (يسار/يمين)
منتقي اللونسداسي أو محدد مرئي
رسالة الترحيبإدخال نصي
كود التضمينمقتطف للقراءة فقط مع زر نسخ

سجل النشاط

العمودالوصف
الطابع الزمنيمتى حدث الحدث
نوع الحدثطلب مُزامن، جهة اتصال مُنشأة، سلة مهجورة، إلخ
التفاصيلمعرف الطلب، اسم جهة الاتصال، أو معرف السلة
الحالةنجاح، فشل

الروابط مع المناطق الأخرى

الميزةكيفية الارتباط
الطلباتتظهر طلبات سلة المُزامنة في وحدة الطلبات
جهات الاتصاليصبح عملاء سلة جهات اتصال تلقائيًا
الحملاتاستهداف عملاء سلة بحملات البث
الدردشة الحيةتستخدم أداة واجهة المتجر بنية الدردشة الحية
خطافات الويبأحداث order.created وorder.updated تتضمن طلبات سلة

الحدود وسلوك الخطط

الخطةتكامل سلةرسائل السلال المهجورة/شهريًا
Starterغير متضمن
Proمتضمن500
Businessمتضمن2,000
Enterpriseمتضمنغير محدود

تُحتسب عمليات مزامنة الطلبات وجهات الاتصال ضمن حدود خطتك المعنية.


استكشاف الأخطاء وإصلاحها

المشكلةالسببالحل
رمز الاتصال غير صالحانتهى الرمز أو استُخدم مسبقًاأنشئ رمزًا جديدًا في SkyLight Chat
الطلبات لا تُزامنمفتاح المزامنة معطّل أو خطاف الويب مُكوّن خطأتحقق من تفعيل المزامنة؛ انقر على مزامنة الآن
رسائل استرداد السلال لا تُرسلواتساب غير متصل أو الاسترداد معطّلفعّل الاسترداد؛ أعد ربط واتساب
الأداة لا تظهركود التضمين مفقود أو ذاكرة القالب المؤقتةامسح ذاكرة القالب المؤقتة؛ تحقق من وضع المقتطف
المتغيرات تظهر كعناصر نائبةصيغة المتغير غير صحيحةاستخدم الصيغة الدقيقة: {name}، {total}، إلخ
جهات اتصال مكررةالعميل موجود مسبقًا بنفس الهاتفجهات الاتصال موحدة بالهاتف؛ المكررات تُتخطى

مقالات ذات صلة