تكامل سلة
تكامل سلة
اربط متجر سلة للتجارة الإلكترونية مع SkyLight Chat لأتمتة التواصل مع العملاء واسترداد السلال المهجورة وتقديم الدعم الفوري عبر واتساب والدردشة الحية.
الغرض
يُزامن تكامل سلة بيانات متجرك إلى SkyLight Chat حتى تتمكن من:
- مزامنة المنتجات — يصل كتالوج المتجر إلى قاعدة معرفة من نوع كتالوج منتجات مع الأسعار والمخزون والصور و
purchase_urlلكل منتج (متاح أيضًا عبر API قاعدة المعرفة). - مزامنة الطلبات — استيراد تفاصيل الطلب والحالة ومعلومات العميل إلى SkyLight Chat.
- دفع تغييرات الحالة إلى سلة — التأكيد أو الإلغاء أو متابعة التنفيذ من SkyLight Chat (أو API الطلبات)؛ تُرسل التغييرات إلى سلة عبر API ثم تُحفظ محليًا.
- استرداد السلال المهجورة — إرسال تذكيرات واتساب بمحتويات السلة وروابط الدفع.
- تضمين أداة واجهة المتجر — إضافة الدردشة الحية إلى متجر سلة الخاص بك.
- أتمتة الإشعارات — تأكيدات الطلبات وتحديثات الشحن وتنبيهات التسليم.
- إثراء جهات الاتصال — إنشاء أو تحديث جهات الاتصال تلقائيًا من عملاء سلة.
صلاحيات الوصول
| الدور | الصلاحيات |
|---|---|
| المالك | وصول كامل — الربط وقطع الاتصال وتكوين المزامنة وإدارة الأداة |
| المشرف | وصول كامل |
| العضو | عرض البيانات المُزامنة؛ لا يمكنه تغيير إعدادات التكامل |
| المشاهد | قراءة فقط |
المتطلبات الأساسية
- متجر سلة نشط — يجب أن يكون لديك حساب تاجر في سلة.
- تطبيق SkyLight Chat مثبت على سلة — ثبّته من متجر تطبيقات سلة.
- قناة واتساب متصلة — مطلوبة لاسترداد السلال وإشعارات الطلبات.
- واتساب متصل — لرسائل استرداد السلال المهجورة.
الشرح التفصيلي الكامل
إنشاء رمز الاتصال
- في SkyLight Chat، اذهب إلى التكاملات ← سلة.
- انقر على إنشاء رمز الاتصال.
- انسخ الرمز (مثال:
SC-A1B2C3D4).
الاتصال في سلة
- سجّل الدخول إلى لوحة تحكم سلة.
- اذهب إلى الإعدادات ← التطبيقات والتكاملات.
- ابحث عن SkyLight Chat وانقر على تثبيت (أو افتح إذا كان مثبتًا مسبقًا).
- الصق رمز الاتصال في الحقل المخصص.
- انقر على اتصال.
- عد إلى SkyLight Chat؛ يجب أن تظهر الحالة الآن متصل.
تكوين إعدادات المزامنة
- افتح تبويب إعدادات المزامنة.
- بدّل:
- مزامنة الطلبات — استيراد الطلبات الجديدة والمُحدّثة.
- مزامنة جهات الاتصال — إنشاء جهات اتصال من عملاء سلة.
- استرداد السلال المهجورة — تفعيل تذكيرات السلال.
- اختر تكرار المزامنة:
- فوري (مدفوع بخطافات الويب)
- كل 5 دقائق
- كل 15 دقيقة
- كل ساعة
- انقر على حفظ.
إعداد استرداد السلال المهجورة
- اذهب إلى تبويب السلال المهجورة.
- اكتب رسالة الاسترداد باستخدام متغيرات السلة (انظر القاموس أدناه).
- عيّن التأخير — الدقائق للانتظار بعد هجر السلة قبل الإرسال (مثال: 30، 60، 120).
- عيّن المتغيرات باستخدام العناصر النائبة المتاحة:
| المتغير | الوصف | مثال الإخراج |
|---|---|---|
{name} | الاسم الأول للعميل | سارة |
{total} | المبلغ الإجمالي للسلة | 299.00 |
{currency} | رمز عملة المتجر | SAR |
{checkout_url} | رابط مباشر لاستئناف الدفع | https://store.salla.sa/cart/abc123 |
{items} | أسماء المنتجات مفصولة بفواصل | قميص أزرق، حذاء رياضي |
{store_name} | اسم متجر سلة الخاص بك | أزياء النخيل |
- عاين الرسالة للتحقق من وضع المتغيرات.
- انقر على حفظ وتفعيل.
تفعيل أداة واجهة المتجر
- افتح تبويب الأداة.
- بدّل تفعيل الأداة إلى تشغيل.
- خصّص:
- الموضع — أسفل اليسار أو أسفل اليمين.
- اللون الرئيسي — ليتطابق مع علامتك التجارية (منتقي ألوان سداسية).
- رسالة الترحيب — التحية المعروضة عند فتح الأداة.
- انسخ مقتطف كود التضمين.
- في قالب سلة الخاص بك، الصق المقتطف قبل وسم
</body>الإغلاق. - احفظ وانشر القالب.
تظهر الأداة الآن في واجهة متجرك، مما يتيح للزوار الدردشة عبر واتساب أو الدردشة الحية.
عرض الطلبات المُزامنة
تظهر الطلبات المُزامنة ضمن الطلبات في SkyLight Chat. يُظهر كل طلب:
- اسم العميل ورابط جهة الاتصال
- رقم الطلب والحالة
- عناصر الطلب بالكميات والأسعار
- عنوان الشحن
- طوابع الإنشاء والتحديث
- شارة المصدر سلة (
created_by = salla)
تأكيد أو إلغاء طلبات سلة من SkyLight
تغييرات الحالة لطلبات سلة ثنائية الاتجاه:
- افتح الطلب في SkyLight Chat (أو استدعِ
PUT /api/v1/orders/{id}/POST /api/v1/orders/{id}/cancel). - أكّد أو ألغِ أو انتقل إلى الحالة المسموحة التالية.
- يدفع SkyLight الحالة المطابقة إلى سلة (
POST …/orders/{salla_id}/status) ثم يحدّث الطلب محليًا. - تُبقي خطافات سلة / المزامنة لاحقًا الطرفين متوافقين.
| حالة SkyLight | تُرسل إلى سلة (slug) |
|---|---|
| مؤكد / قيد التجهيز | in_progress |
| تم الشحن | shipped |
| تم التوصيل | delivered |
| ملغي | canceled |
يتطلب اتصال سلة نشطًا بصلاحية orders.read_write. تعديل عناصر طلبات سلة يبقى من لوحة سلة فقط (لا يُدفع من SkyLight).
المزامنة اليدوية
انقر على مزامنة الآن في تبويب إعدادات المزامنة لتشغيل سحب فوري للطلبات وجهات الاتصال.
قطع اتصال سلة
- اذهب إلى التكاملات ← سلة.
- انقر على قطع الاتصال.
- أكّد مربع الحوار.
يوقف قطع الاتصال جميع عمليات المزامنة ويُعطّل الأداة. تبقى البيانات التاريخية في SkyLight Chat.
قاموس الحقول
| الحقل | الوصف |
|---|---|
| رمز الاتصال | رمز فريد يربط SkyLight Chat بتطبيق سلة |
| اسم المتجر | اسم عرض متجر سلة |
| مزامنة الطلبات | مفتاح لاستيراد الطلبات |
| مزامنة جهات الاتصال | مفتاح لإنشاء جهات اتصال من العملاء |
| استرداد السلال المهجورة | مفتاح لإرسال تذكيرات السلال |
| تكرار المزامنة | عدد مرات سحب البيانات |
| التأخير | الدقائق قبل إرسال رسالة السلة المهجورة |
| كود تضمين الأداة | مقتطف JavaScript لواجهة متجرك |
الحالات والشارات
| الحالة | لون الشارة | المعنى |
|---|---|---|
| متصل | أخضر | التكامل نشط |
| غير متصل | رمادي | غير مرتبط |
| جارٍ المزامنة | أزرق | نقل البيانات قيد التقدم |
| خطأ | أحمر | فشلت المزامنة؛ تحقق من السجلات |
حالات مزامنة الطلبات
| الحالة | المعنى |
|---|---|
| قيد الانتظار | الطلب في انتظار المعالجة |
| مؤكد | الطلب مؤكد من المتجر |
| قيد المعالجة | الطلب قيد التحضير |
| تم الشحن | الطلب أُرسل |
| تم التوصيل | الطلب اكتمل |
| ملغى | الطلب ملغى |
الشاشات الفرعية
تبويب السلال المهجورة
| القسم | المحتويات |
|---|---|
| رسالة الاسترداد | مربع نص مع متغيرات السلة |
| إدخال التأخير | الدقائق (رقمي) |
| تعيين المتغيرات | يُظهر العناصر النائبة المتاحة وحقول جهات الاتصال |
| المعاينة | معاينة مباشرة للرسالة ببيانات نموذجية |
| مفتاح التفعيل | تشغيل/إيقاف لاسترداد السلال |
تبويب الأداة
| القسم | المحتويات |
|---|---|
| مفتاح التفعيل | تشغيل/إيقاف |
| الموضع | أزرار اختيار (يسار/يمين) |
| منتقي اللون | سداسي أو محدد مرئي |
| رسالة الترحيب | إدخال نصي |
| كود التضمين | مقتطف للقراءة فقط مع زر نسخ |
سجل النشاط
| العمود | الوصف |
|---|---|
| الطابع الزمني | متى حدث الحدث |
| نوع الحدث | طلب مُزامن، جهة اتصال مُنشأة، سلة مهجورة، إلخ |
| التفاصيل | معرف الطلب، اسم جهة الاتصال، أو معرف السلة |
| الحالة | نجاح، فشل |
الروابط مع المناطق الأخرى
| الميزة | كيفية الارتباط |
|---|---|
| الطلبات | تظهر طلبات سلة المُزامنة في وحدة الطلبات |
| جهات الاتصال | يصبح عملاء سلة جهات اتصال تلقائيًا |
| الحملات | استهداف عملاء سلة بحملات البث |
| الدردشة الحية | تستخدم أداة واجهة المتجر بنية الدردشة الحية |
| خطافات الويب | أحداث order.created وorder.updated تتضمن طلبات سلة |
الحدود وسلوك الخطط
| الخطة | تكامل سلة | رسائل السلال المهجورة/شهريًا |
|---|---|---|
| Starter | غير متضمن | — |
| Pro | متضمن | 500 |
| Business | متضمن | 2,000 |
| Enterprise | متضمن | غير محدود |
تُحتسب عمليات مزامنة الطلبات وجهات الاتصال ضمن حدود خطتك المعنية.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
| رمز الاتصال غير صالح | انتهى الرمز أو استُخدم مسبقًا | أنشئ رمزًا جديدًا في SkyLight Chat |
| الطلبات لا تُزامن | مفتاح المزامنة معطّل أو خطاف الويب مُكوّن خطأ | تحقق من تفعيل المزامنة؛ انقر على مزامنة الآن |
| رسائل استرداد السلال لا تُرسل | واتساب غير متصل أو الاسترداد معطّل | فعّل الاسترداد؛ أعد ربط واتساب |
| الأداة لا تظهر | كود التضمين مفقود أو ذاكرة القالب المؤقتة | امسح ذاكرة القالب المؤقتة؛ تحقق من وضع المقتطف |
| المتغيرات تظهر كعناصر نائبة | صيغة المتغير غير صحيحة | استخدم الصيغة الدقيقة: {name}، {total}، إلخ |
| جهات اتصال مكررة | العميل موجود مسبقًا بنفس الهاتف | جهات الاتصال موحدة بالهاتف؛ المكررات تُتخطى |
مقالات ذات صلة
- الطلبات — إدارة الطلبات وتنفيذها
- جهات اتصال واتساب — عرض عملاء سلة المُزامنين
- الدردشة الحية — تكوين أداة واجهة المتجر
