أذونات API
لإطلاق العنان للإمكانات الكاملة لـ AI SmartTalk — مثل البحث عن الطلبات، تحديث أوصاف المنتجات، أو إدارة العملاء — تحتاج إلى تكوين رمز API لخدمة ويب PrestaShop مع الأذونات الصحيحة.
معلومات
هذه الخطوة مطلوبة إذا كنت ترغب في استخدام إجراءات AI (SmartFlow). بدونها، يمكن لمساعدك الذكي الإجابة على الأسئلة بناءً على المعرفة المتزامنة، لكنه لن يكون قادرًا على الوصول إلى بيانات المتجر في الوقت الفعلي.
1. تمكين خدمة الويب
- انتقل إلى الإعدادات المتقدمة > خدمة الويب
- قم بتمكين خدمة ويب PrestaShop
- انقر على حفظ
2. إنشاء مفتاح API
- في صفحة خدمة الويب، انقر على إضافة مفتاح خدمة ويب جديد
- املأ النموذج:
- المفتاح: انقر على توليد لإنشاء رمز آمن، أو أدخل مفتاحك الخاص
- وصف المفتاح:
AI SmartTalk - الحالة: مفعل
- قم بتعيين الأذونات كما هو موضح أدناه
- انقر على حفظ
warning
انسخ واحفظ مفتاح API — ستحتاج إليه عند تكوين التكامل في AI SmartTalk.
3. الأذونات المطلوبة
في قسم الأذونات لمفتاح API الخاص بك، قم بتمكين الموارد التالية:
| المورد | GET | PUT | POST | الوصف |
|---|---|---|---|---|
| المنتجات | نعم | نعم | — | قراءة تفاصيل المنتج، تحديث الأوصاف وSEO |
| الطلبات | نعم | — | — | البحث عن الطلبات بواسطة المرجع أو العميل |
| تفاصيل الطلب | نعم | — | — | عرض المنتجات داخل الطلب |
| حالات الطلب | نعم | — | — | قراءة تسميات حالة الطلب |
| تاريخ الطلبات | نعم | — | نعم | قراءة تاريخ الحالة، إضافة تغييرات الحالة |
| العملاء | نعم | نعم | — | البحث عن معلومات العملاء وتحديثها |
| اللغات | نعم | — | — | قائمة باللغات المتاحة في المتجر |
تلميح
تحقق فقط من الأذونات المذكورة أعلاه. لا حاجة لمنح الوصول إلى موارد أخرى.
4. ما يستخدمه كل مورد
المنتجات (قراءة + كتابة)
- قراءة: استرجاع تفاصيل المنتج — الاسم، الوصف، الوصف القصير، السعر، المرجع، المخزون، حقول SEO (عنوان ميتا، وصف ميتا، كلمات ميتا)
- كتابة: تحديث أوصاف المنتجات، الأوصاف القصيرة، وحقول SEO مع دعم كامل للغات متعددة
الطلبات (قراءة فقط)
- البحث عن طلب بواسطة رقم مرجعه
- قائمة الطلبات لعميل معين (بالبريد الإلكتروني)
- الحصول على أحدث طلب لعميل
تفاصيل الطلب (قراءة فقط)
- عرض المنتجات داخل الطلب: الاسم، المرجع، الكمية، سعر الوحدة
حالات الطلب (قراءة فقط)
- استرجاع التسمية القابلة للقراءة البشرية لكل حالة طلب (مثل "تم قبول الدفع"، "تم الشحن")
تاريخ الطلبات (قراءة + إنشاء)
- قراءة: عرض تاريخ تغييرات الحالة لطلب
- إنشاء: إضافة تغيير حالة جديد إلى طلب (مثل، وضع علامة على أنه تم شحنه)، مع إشعار بالبريد الإلكتروني اختياري للعميل
العملاء (قراءة + كتابة)
- قراءة: البحث عن عميل بواسطة البريد الإلكتروني أو المعرف — استرجاع الاسم، البريد الإلكتروني، تاريخ التسجيل، حالة النشرة الإخبارية، الملاحظات
- كتابة: تحديث معلومات العميل (الاسم الأول، الاسم الأخير، البريد الإلكتروني، الملاحظات)
اللغات (قراءة فقط)
- قائمة بجميع اللغات المكونة في متجرك (تستخدم لتحديث المنتجات متعددة اللغات)
5. إدخال مفتاح API في AI SmartTalk
بمجرد إنشاء مفتاح خدمة الويب الخاص بك وتكوينه:
- انتقل إلى تكوين وحدة AI SmartTalk في PrestaShop
- يتم عادةً نقل مفتاح API أثناء اتصال OAuth
- إذا كنت بحاجة إلى تحديثه، انتقل إلى لوحة معلومات AI SmartTalk الخاصة بك > التكامل > PrestaShop وقم بتحديث رمز خدمة الويب
بالنسبة لـ إعدادات المواقع المتعددة، يمكن أن يكون لكل موقع مفتاح API لخدمة ويب خاص به مكون بشكل مستقل.
الخطوات التالية
- مزامنة بيانات متجرك — دفع كتالوج منتجاتك إلى AI
- انظر ما يمكن أن تفعله AI — مرجع كامل للإجراءات المتاحة