مرجع إجراءات الذكاء الاصطناعي
عند الاتصال بالأذونات الصحيحة لـ API، يمكن لمساعدك الذكي تنفيذ الإجراءات التالية على متجر PrestaShop الخاص بك في الوقت الفعلي. هذه الإجراءات متاحة في تدفقات العمل SmartFlow ويمكن أيضًا استخدامها من قبل الذكاء الاصطناعي خلال المحادثات مع عملائك.
المنتجات
الحصول على المنتج
استرجع التفاصيل الكاملة لمنتج بواسطة معرفه.
- الإدخال: معرف المنتج
- الإرجاع: الاسم، الوصف، الوصف القصير، المرجع، السعر، كمية المخزون، حالة النشاط، حقول SEO (عنوان ميتا، وصف ميتا، كلمات مفتاحية ميتا)
- إذن API:
products(GET)
تحديث محتوى المنتج
تحديث الوصف و/أو الوصف القصير لمنتج، مع دعم متعدد اللغات بالكامل.
- الإدخالات: معرف المنتج، الوصف (اختياري)، الوصف القصير (اختياري)، معرف اللغة (اختياري — الافتراضي هو اللغة الرئيسية للمتجر)
- الإرجاع: تأكيد مع قائمة الحقول المحدثة
- إذن API:
products(GET + PUT)
يحافظ الذكاء الاصطناعي على المحتوى في لغات أخرى عند تحديث لغة محددة. على سبيل المثال، تحديث الوصف الفرنسي لن يؤثر على النسخة الإنجليزية.
تحديث SEO المنتج
تحديث حقول SEO لمنتج، مع دعم متعدد اللغات.
- الإدخالات: معرف المنتج، عنوان ميتا (اختياري)، وصف ميتا (اختياري)، كلمات مفتاحية ميتا (اختياري)، معرف اللغة (اختياري)
- الإرجاع: تأكيد مع قيم SEO المحدثة
- إذن API:
products(GET + PUT)
الطلبات
الحصول على الطلب بواسطة المرجع
ابحث عن طلب محدد باستخدام رقم مرجعه (مثل، ABCDEF123).
- الإدخال: مرجع الطلب
- الإرجاع: تفاصيل الطلب الكاملة بما في ذلك التاريخ، الحالة، المبلغ الإجمالي، طريقة الدفع، معلومات الشحن، وقائمة المنتجات
- إذن API:
orders(GET)،order_details(GET)،order_states(GET)
الحصول على الطلبات بواسطة البريد الإلكتروني
استرجع جميع الطلبات المقدمة من عميل محدد.
- الإدخالات: بريد العميل، الحد (اختياري — الافتراضي هو 10)
- الإرجاع: قائمة الطلبات مع التفاصيل الكاملة، العدد الإجمالي
- إذن API:
orders(GET)،order_details(GET)،order_states(GET)،customers(GET)
الحصول على آخر طلب
احصل على أحدث طلب لعميل محدد.
- الإدخال: بريد العميل
- الإرجاع: أحدث طلب مع التفاصيل الكاملة، أو null إذا لم يتم العثور على طلبات
- إذن API:
orders(GET)،order_details(GET)،order_states(GET)،customers(GET)
تحديث حالة الطلب
تغيير حالة الطلب (مثل، وضع علامة على أنه تم الشحن، وضع علامة على أنه تم التسليم).
- الإدخالات: معرف الطلب، معرف حالة الطلب الجديدة، إرسال إشعار عبر البريد الإلكتروني (اختياري — الافتراضي هو لا)
- الإرجاع: تأكيد مع الحالة الجديدة وما إذا تم إرسال بريد إلكتروني
- إذن API:
order_histories(GET + POST)
يمكن أن يؤدي تغيير حالة الطلب إلى إرسال إشعارات عبر البريد الإلكتروني للعملاء إذا كانت خيار sendEmail مفعلًا. تأكد من تطبيق الحالة الصحيحة.
العملاء
الحصول على العميل
ابحث عن عميل بواسطة عنوان بريده الإلكتروني.
- الإدخال: بريد العميل
- الإرجاع: معرف العميل، الاسم الأول، الاسم الأخير، البريد الإلكتروني، تاريخ الميلاد، حالة النشرة الإخبارية، تاريخ التسجيل، الملاحظات
- إذن API:
customers(GET)
تحديث العميل
تحديث معلومات ملف تعريف العميل.
- الإدخالات: معرف العميل، الاسم الأول (اختياري)، الاسم الأخير (اختياري)، البريد الإلكتروني (اختياري)، الملاحظات (اختياري)
- الإرجاع: تأكيد مع قائمة الحقول المحدثة
- إذن API:
customers(GET + PUT)
التكوين
الحصول على اللغات
قائمة بجميع اللغات المكونة على متجر PrestaShop الخاص بك.
- لا حاجة لإدخال
- الإرجاع: قائمة باللغات مع المعرف، الاسم، ورمز ISO (مثل،
fr,en,de) - إذن API:
languages(GET)
تُستخدم هذه العملية داخليًا بواسطة الذكاء الاصطناعي عند إجراء تحديثات متعددة اللغات للمنتجات، لضمان استخدام معرف اللغة الصحيح.
جدول الملخص
| الإجراء | الفئة | قراءة | كتابة |
|---|---|---|---|
| الحصول على المنتج | المنتجات | نعم | — |
| تحديث محتوى المنتج | المنتجات | نعم | نعم |
| تحديث SEO المنتج | المنتجات | نعم | نعم |
| الحصول على الطلب بواسطة المرجع | الطلبات | نعم | — |
| الحصول على الطلبات بواسطة البريد الإلكتروني | الطلبات | نعم | — |
| الحصول على آخر طلب | الطلبات | نعم | — |
| تحديث حالة الطلب | الطلبات | — | نعم |
| الحصول على العميل | العملاء | نعم | — |
| تحديث العميل | العملاء | نعم | نعم |
| الحصول على اللغات | التكوين | نعم | — |
ذات صلة
- أذونات API — تكوين الأذونات المطلوبة لخدمة الويب
- Webhooks & Skills — تفعيل هذه الإجراءات تلقائيًا عند أحداث المتجر