إنتقل إلى المحتوى الرئيسي

تكامل Zid

اربط متجر Zid عندك مع Orki عشان يقدر وكلاؤك الأذكياء يصلون إلى كتالوج منتجاتك ويساعدون العملاء في التسوق بالعربية والإنجليزية.

المسار: المنتجات > المصادر > Zid

ما هي Zid؟​

Zid هي منصة تجارة إلكترونية رائدة في منطقة الشرق الأوسط وشمال أفريقيا. هي شائعة بشكل خاص في السعودية ودول الخليج، وتقدّم حلول تجارة إلكترونية تركّز على العربية أولاً.

ما الذي يفعله هذا التكامل​

بمجرد الربط، يقدر وكلاؤك الأذكياء:

  • البحث في كتالوج منتجات Zid عندك
  • التوصية بالمنتجات بالعربية أو الإنجليزية
  • إرسال شرائط منتجات على واتساب
  • الوصول لأسعار وتوفر بشكل لحظي

المتطلبات المسبقة​

قبل ربط Zid، تأكد أن عندك:

  • متجر Zid
  • وصول إلى لوحة تحكم شركاء Zid (partner.zid.sa)
  • وصول API مفعّل في باقتك في Zid

ربط Zid​

يعتمد الربط على بيانات اعتماد تنسخها من لوحة تحكم شركاء Zid — لا توجد خطوة تفويض OAuth ولا إعادة توجيه إلى Zid.

الخطوة 1: افتح مصدر Zid​

اذهب إلى المنتجات ← المصادر ← Zid في الشريط الجانبي لـ Orki واضغط على "إضافة تكامل". يرشدك معالج خطوة بخطوة خلال العملية.

الخطوة 2: انسخ بيانات الاعتماد من Zid​

في لوحة تحكم شركاء Zid (partner.zid.sa)، اذهب إلى الإعدادات ← تكاملات API ← معلومات التكامل المباشر (Direct Integration Info) وانسخ:

الحقلالوصف
معرّف المتجر (Store ID)معرّف متجر Zid الخاص بك
رابط المتجر (Store URL)رابط متجرك
رمز المدير (Manager Token)رمز API المستخدم لقراءة كتالوجك

الخطوة 3: الصق في Orki​

الصق معرّف المتجر ورابط المتجر ورمز المدير في نموذج Orki واحفظ التكامل.

الخطوة 4: انتظر المزامنة الأولية​

سوف يبدأ Orki في مزامنة منتجاتك تلقائياً. قد تأخذ بضع دقائق حسب حجم كتالوجك.

الخطوة 5: اختبر في ساحة التجربة​

اذهب إلى ساحة التجربة واختبر البحث عن المنتجات بالعربية والإنجليزية للتحقق من التكامل.

ما الذي يتم مزامنته​

البياناتمتزامنةملاحظات
اسم المنتج (عربي)نعماللغة الأساسية
اسم المنتج (إنجليزي)نعمإذا متاح في Zid
الوصف (عربي)نعموصف المنتج الكامل
الوصف (إنجليزي)نعمإذا متاح في Zid
السعرنعمبعملة متجرك (SAR، AED، إلخ.)
الصورنعمكل صور المنتج
المتغيراتنعمالمقاس، اللون، إلخ.
المخزوننعممستويات المخزون
SKUنعمإذا متاح
الفئاتنعمللتنظيم

دعم اللغتين​

متاجر Zid عادةً عندها محتوى ثنائي اللغة، ويدعم Orki ذلك بالكامل:

المحتوى العربي​

  • أسماء المنتجات وأوصافها بالعربية تتزامن بشكل صحيح
  • يقدر الذكاء الاصطناعي الرد بالعربية عن المنتجات
  • يتم التعامل مع النص من اليمين إلى اليسار (RTL) بشكل صحيح

المحتوى الإنجليزي​

  • الترجمات الإنجليزية تتزامن إذا كانت متاحة في Zid
  • يقدر الذكاء الاصطناعي التبديل بين العربية والإنجليزية بناءً على لغة العميل

مثال للمحادثة (عربية)​

العميل: عندكم شنط جلد؟

الذكاء الاصطناعي: نعم! عندنا مجموعة متنوعة من الشنط الجلدية. تفضل بعض الخيارات: [يرسل شريط منتجات]

مثال للمحادثة (إنجليزية)​

Customer: Do you have leather bags?

AI: Yes! We have a great selection of leather bags. Here are some options: [يرسل شريط منتجات]

سلوك المزامنة​

المزامنة التلقائية​

تتزامن المنتجات تلقائياً:

  • لما تربط أول مرة
  • بشكل دوري طوال اليوم
  • لما يتم اكتشاف تغييرات على المنتجات في Zid

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

لفرض مزامنة فورية:

  1. اذهب إلى المنتجات ← المصادر
  2. ابحث عن تكامل Zid
  3. اضغط على "مزامنة"

إدارة المنتجات المتزامنة​

عرض المنتجات​

تظهر منتجات Zid في شبكة منتجاتك مع:

  • عمود المصدر يعرض "Zid"
  • الأسماء بالعربية والإنجليزية (إذا متاحة)
  • كل معلومات المنتج المتزامنة

تعديل المنتجات​

منتجات Zid هي للقراءة فقط في Orki. للتحديث:

  1. أجرِ التغييرات في لوحة تحكم Zid عندك
  2. انتظر المزامنة التلقائية، أو شغّل مزامنة يدوية
  3. تظهر البيانات المحدَّثة في Orki

حالة المنتج​

تحكم بإذا كانت منتجات Zid متاحة للذكاء الاصطناعي:

  • نشط: يقدر الذكاء الاصطناعي البحث والتوصية بهذا المنتج
  • غير نشط: مخفي من بحث الذكاء الاصطناعي

اقلب الحالة مباشرة في Orki — هذا ما يؤثر على متجر Zid عندك.

إدارة التكامل​

في المنتجات ← المصادر، يوفّر كل تكامل Zid الإجراءات التالية:

الإجراءالوصف
تعديلتحديث معرّف المتجر أو رابط المتجر أو رمز المدير
مفتاح تفعيل/تعطيلإيقاف التكامل أو تشغيله مؤقتاً
مزامنةتشغيل مزامنة فورية للمنتجات
حذف التكاملإزالة التكامل — يظهر تحذير يوضح أن البيانات المتزامنة ستُحذَف
ما الذي يحدث عند الحذف
  • تُزال المنتجات المتزامنة من Orki
  • ما يقدر الذكاء الاصطناعي يصل إلى منتجات Zid
  • متجر Zid عندك ما يتأثر

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

المنتجات لا تظهر​

  • تأكد أن الربط نشط
  • تحقق أن المنتجات منشورة في Zid
  • جرّب مزامنة يدوية
  • تأكد أن المنتجات ليست مخفية أو في حالة مسودة

النص العربي لا يظهر​

  • تأكد أن متصفحك يدعم النص العربي
  • تحقق أن بيانات المنتج موجودة بالعربية في Zid
  • امسح ذاكرة التخزين المؤقت للمتصفح وحدّث

فُقِد الاتصال​

إذا توقفت المزامنة عن العمل:

  1. تحقق أن رمز المدير ما زال صالحاً في لوحة تحكم شركاء Zid
  2. استخدم تعديل لتحديث بيانات الاعتماد إذا تغيّرت
  3. شغّل مزامنة وانتظر مزامنة المنتجات مرة أخرى

الترجمات الإنجليزية مفقودة​

الترجمات الإنجليزية تظهر فقط إذا كانت موجودة في متجر Zid عندك. أضف الترجمات في Zid عشان تتزامن إلى Orki.

الخطوات التالية​