دليل تكامل شوبيفاي
اربط متجر شوبيفاي بـ ZaLinkAI باستخدام Admin API 2024-01 وامنح وكلاء الذكاء الاصطناعي قدرات تجارية كاملة.
مصادقة OAuth 2.0
يستخدم شوبيفاي OAuth 2.0 لتثبيت التطبيقات المخصصة والعامة على متاجر التجار.
تثبيت التطبيق
ينقر التاجر على "تثبيت" من متجر تطبيقات شوبيفاي أو رابط التثبيت. يتم إعادة توجيهه إلى شاشة موافقة OAuth مع client_id والنطاقات و redirect_uri.
منح الأذونات
يراجع التاجر ويوافق على نطاقات API المطلوبة. يتحقق شوبيفاي من الطلب وينشئ رمز تفويض.
الرد والتحقق
يعيد شوبيفاي التوجيه إلى عنوان الرد مع الرمز ونطاق المتجر وتوقيع HMAC. تحقق من HMAC لضمان أصالة الطلب.
تبادل الرموز
استبدل الرمز برمز وصول غير متصل. رموز شوبيفاي غير المتصلة لا تنتهي ولا تحتاج تحديث -- تبقى صالحة حتى إلغاء تثبيت التطبيق.
نطاقات API المطلوبة
يطلب ZaLinkAI الحد الأدنى من النطاقات اللازمة لوظائف وكيل الذكاء الاصطناعي الكاملة.
read_products
الوصول لكتالوج المنتجات والمتغيرات والصور والمجموعات.
write_draft_orders
إنشاء مسودات طلبات لتدفقات السلة والدفع بالذكاء الاصطناعي.
read_orders
استرجاع سجل الطلبات وحالة التنفيذ وبيانات التتبع.
read_customers
الوصول لملفات العملاء والعناوين وسجل المشتريات.
write_checkouts
إنشاء روابط دفع آمنة للتجارة عبر المحادثة.
read_inventory
تتبع مستويات المخزون في الوقت الفعلي عبر المواقع.
read_shipping
الوصول لمناطق الشحن والأسعار وملفات التسليم.
read_discounts
استرجاع أكواد الخصم النشطة وقواعد الأسعار.
قدرات المنصة
نظرة شاملة على إجراءات وكيل الذكاء الاصطناعي المتاحة عبر موصل شوبيفاي.
المنتجات والمجموعات
- كتالوج المنتجات مع المتغيرات والحقول المخصصة
- مزامنة المجموعات الذكية والمخصصة
- إدارة الصور والوسائط
- تتبع المخزون متعدد المواقع
السلة والدفع
- نظام سلة قائم على مسودة الطلبات
- إنشاء روابط دفع آمنة
- تطبيق أكواد الخصم
- استعادة السلات المتروكة
إدارة العملاء
- ملفات العملاء والشرائح
- دفتر العناوين وبيانات الاتصال
- سجل الطلبات لكل عميل
- علامات وملاحظات العملاء
Webhooks والأحداث
- التحقق من توقيع HMAC-SHA256
- أحداث الطلبات والمنتجات والعملاء
- حدث دورة حياة إلغاء التثبيت
- إعادة محاولة تلقائية بتراجع أسي
رموز الوصول غير المتصلة
توفر رموز شوبيفاي غير المتصلة وصولاً مستمراً يبسط التكامل.
الرموز غير المتصلة لا تنتهي ولا تحتاج تحديثاً دورياً.
تبقى الرموز صالحة حتى يقوم التاجر بإلغاء تثبيت التطبيق.
يقوم ZaLinkAI بتشفير الرموز بـ AES-256 قبل التخزين.
إذا أعاد التاجر التثبيت، يتم إصدار رمز جديد تلقائياً.
استكشاف الأخطاء
المشكلات الشائعة وحلولها لتكامل شوبيفاي.
invalid_hmac
فشل التحقق من توقيع HMAC في رد OAuth.
تأكد من حساب HMAC-SHA256 باستخدام client_secret الصحيح ومقارنة جميع معاملات الاستعلام (باستثناء hmac نفسها).
access_denied
لم يوافق التاجر على النطاقات المطلوبة.
يجب أن يوافق التاجر على جميع النطاقات المطلوبة. أعد توجيههم إلى رابط التثبيت مرة أخرى.
shop_not_found
نطاق المتجر المقدم غير صالح أو المتجر معطل.
تحقق من صيغة نطاق المتجر (my-store.myshopify.com) قبل بدء OAuth.
api_version_unsupported
إصدار API المطلوب قديم أو غير صالح.
يستخدم ZaLinkAI Admin API 2024-01. تأكد من تطابق إعدادات تطبيقك مع هذا الإصدار.