وحدة PrestaShop

آخر تحديث: 14 يوليو 2026

تربط وحدة PrestaKick PrestaShop ب PrestaKick ، وتزامن البيانات وتعرض الميزات الموجهة للعملاء على الموقع الإلكتروني.

افتح قسم إدارة الوحدات

بعد تثبيت الوحدة، افتح PrestaKick AI في PrestaShop المكتب الخلفي. الأقسام الرئيسية هي:

• Connection: اتصال المتجر والوصول إلى البيانات.
• Widget: تكوين إطار الدردشة.
• Features: تفعيل البحث واقتراحات المنتجات.
• Cron Jobs: تكوين المهام المتكررة وعرض السجلات.
• AI Content وإنشاء أو ترجمة المحتوى AI Translate: في المكتب الخلفي.
• Support: عرض معلومات الدعم.

بعد تغيير الإعدادات، اختر Save configuration. إذا غادرت الصفحة قبل الحفظ، فلن يدخل التغيير حيز التنفيذ.

اتصل باستخدام OAuth

OAuth هو الطريقة الموصى بها للاتصال:

1. افتح Connection.
2. اختر Connect with PrestaKick.
3. سجل الدخول إلى لوحة المعلومات إذا لزم الأمر.
4. اختر المتجر المناسب ثم اختر Confirm connection.
5. عد إلى الوحدة وتحقق من حالة Connected.
6. اختر Save configuration.

أكمل اتصالا قبل فتح تدفق OAuth جديد. روابط OAuth محدودة بالوقت ولا يمكن استخدامها إلا مرة واحدة.

الاتصال اليدوي

استخدم Connect manually فقط عندما لا يمكنك الاتصال باستخدام OAuth. تحتاج إلى إدخال القيم المقدمة من لوحة التحكم، بما في ذلك:

• PrestaKick URL
• Module Secret
• API Base URL
• Widget Key
• Shop ID
• API Widget URL

بالنسبة للمتجر الحي، يجب أن تشير واجهة برمجة التطبيقات إلى https://api.prestakick.com وخدمة الدردشة إلى https://chat.prestakick.com.

بعد الدخول، اختر Save configuration ثم Test connection.

صلاحيات الوصول إلى البيانات

يسمح قسم Store API Key PrestaKick بطلب البيانات من المتجر. API Permissions تحديد نوع البيانات التي سيتم قراءتها، على سبيل المثال:

• المنتجات والفئات.
• الزبائن والطلبات.
• عربة تسوق.
• تخزين المعلومات.
• صفحات نظام إدارة المحتوى.

قم بتفعيل أنواع البيانات فقط التي تحتاجها. إذا قمت بإيقاف تشغيل إذن، قد تكون الميزات التي تعتمد على هذا النوع من البيانات مفقودة.

عندما تنشئ مفتاح API جديد، يتوقف المفتاح القديم عن العمل. اختر Save configuration ، ثم حدث أي أنظمة لا تزال تستخدم المفتاح القديم.

تمكين البحث والاقتراحات

Features مفتوحة للإدارة:

• Image Search (Vision Search): البحث عن المنتجات حسب الصور.
• Semantic Search: إيجاد المنتجات حسب المعنى.
• Display Related Products: عرض المنتجات ذات الصلة في مواقع محددة.

إذا كانت الصفحة تظهر API connection required ، أكمل الاتصال أولا. بعض الميزات تتطلب خطة مناسبة؛ انظر .

كيف يتم مزامنة البيانات

عندما تتغير البيانات في PrestaShop ، تضيف الوحدة التغيير إلى قائمة الانتظار. يقوم كرون بمعالجة الطابور ويرسل البيانات إلى PrestaKick.

يمكنك أيضا طلب إعادة مزامنة من صفحة Data sync في لوحة التحكم. كل نوع بيانات له حد تردد تزامن يدوي؛ إذا رأيت رسالة حد، انتظر حتى يسمح لك بالمحاولة مرة أخرى.

حالة الاتصال

Connected فقط يؤكد أن تفاصيل الاتصال صحيحة. تعكس الحالات أعلاه نشاط الوحدة الأخير.

جهز وظائف الكرون

1. وظائف الكرون → الإعدادات المفتوحة.
2. نسخ الأمر أو رابط الرابط الذي توفره الوحدة.
3. أضف إلى جدولة الاستضافة حسب التردد المعروض على الشاشة.
4. استخدم Run now لتجربة إذا لزم الأمر.
5. افتح وظائف كرون → سجلات لرؤية النتائج.

لا تشارك عناوين URL الخاصة بالكرون لأنها تحتوي على رموز أمان. إذا أبلغت السجلات عن Unauthorized: invalid or missing cron token. ، انسخ المعلومات الجديدة من Settings وحدثها على الاستضافة.

محتوى الذكاء الاصطناعي وترجمة الذكاء الاصطناعي

AI Content يدعم إنشاء المحتوى. AI Translate يدعم الترجمة إلى لغات أخرى. لكل قسم إعداداته وتاريخه الخاص.

قم بتدقيق المحتوى الذي ينشئه الذكاء الاصطناعي قبل النشر. تحقق من أسماء المنتجات، المواصفات، السياسات، ومصطلحات العلامة التجارية.

عندما تكون هناك حاجة للدعم

أرسل إلى الدعم:

• اسم المتجر ونطاق المتجر.
• لقطة شاشة كاملة لرسالة الخطأ.
• عندما حدث الخطأ، مع المنطقة الزمنية.
• الحالة في Connection والسجلات ذات الصلة في سجلات الوظائف → الكرون.

لا ترسل أسرار الوحدة، أو مفاتيح واجهة برمجة التطبيقات، أو مفاتيح الويدجت، أو رموز الكرون.

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