Pico
Pico DocsSandbox

الوثائقShopify

دليل التكامل

إعداد Shopify للتجّار

ثبّت Pico على متجر Shopify عبر OAuth، وزامن كتالوجك الحقيقي، وفعّل المساعد العائم عبر تضمين تطبيق السمة. لا حاجة لتعديل ملفات السمة يدويًا.

تثبيت OAuthتضمين تطبيق السمة

ما يحتاجه Pico

يستخدم Pico واجهة GraphQL Admin من Shopify لمزامنة الكتالوج وتضمين تطبيق السمة لأداة الواجهة. لا تظهر رموز Admin API أبدًا في المتصفح.

العنصرالمكانالاستخدام
نطاق المتجرyour-store.myshopify.comتثبيت OAuth وهوية المتجر
موافقة OAuthشاشة تثبيت Shopifyرمز وصول مشفّر دون اتصال في Pico
صلاحيات الكتالوجread_products (+ المخزون عند منحه)مزامنة المنتجات والمتغيرات والأسعار والتوفر
تضمين تطبيق السمةمحرر السمة → تضمينات التطبيقيحمّل سكربت ويدجت Pico العام

التثبيت والتفويض في Pico

  1. افتح التكاملات

    في لوحة Pico افتح Integrations ثم Connect Shopify.

  2. أدخل نطاق المتجر

    استخدم النطاق القانوني *.myshopify.com (مثل acme.myshopify.com).

  3. وافق على الصلاحيات في Shopify

    يطلب Shopify إذن قراءة الكتالوج. يخزّن Pico الرمز مشفّرًا ولا يعرضه مرة أخرى.

  4. العودة إلى الإعداد

    بعد الموافقة تعود إلى Pico مع حالة الاتصال وخطوات الإعداد. الاتصال لا يعني اكتمال مزامنة الكتالوج.

مزامنة الكتالوج

  1. تُجدول المزامنة الأولى تلقائيًا

    بعد التثبيت الناجح يضع Pico مزامنة الكتالوج في قائمة الانتظار. تابع التقدم تحت Catalog.

  2. راجع المنتجات

    تأكد من تطابق العناوين والصور والأسعار والمتغيرات والروابط مع Shopify لعينة من المنتجات.

  3. أعد المحاولة عند الحاجة

    يمكن إعادة محاولة المزامنات الفاشلة من Catalog. تُعاد محاولات حدود المعدل المؤقتة مع تأخير متزايد.

تفعيل تضمين تطبيق السمة

يُقدَّم Pico كتضمين تطبيق سمة Shopify (مساعد عائم). يفعّله التجّار في محرر السمة—دون تعديلات Liquid يدوية.

  1. في تكاملات Pico افتح رابط محرر السمة (أو محرر السمة → تضمينات التطبيق).
  2. فعّل Pico Assistant.
  3. الصق معرّف الودجت العام (يبدأ بـ pw_) وعنوان قاعدة Pico API في إعدادات التضمين.
  4. احفظ، افتح الواجهة الأمامية، وتأكد من تحميل الودجت مرة واحدة.
تضمين عام مكافئ (مرجع)
<script
  src="https://YOUR_PICO_API_HOST/pico-widget.js"
  data-public-widget-id="pw_..."
  data-api-url="https://YOUR_PICO_API_HOST/api/v1"
  defer
></script>

في المتجر الإلكتروني يستخدم إضافة إلى السلة Ajax Cart من Shopify ليبقى درج السلة متزامنًا. فضّل تضمين تطبيق السمة على لصق هذا السكربت يدويًا.

لغات هذا الدليل

دليل إعداد التاجر هذا متاح بكل لغات موقع Pico. استخدم مبدّل اللغة في ترويسة الموقع لتغييره.

الرمزاللغة
enEnglish (الإنجليزية)
arالعربية
deDeutsch (الألمانية)
elΕλληνικά (اليونانية)

لغات ويدجت المساعد

مساعد Pico المواجه للمتسوق يدعم حاليًا حزم اللغات التالية. عيّن الافتراضي في إعدادات المساعد.

الرمزاللغة
enEnglish (الإنجليزية)
elΕλληνικά (اليونانية)

واجهة API (headless)

تُنشأ متاجر Shopify عبر OAuth وليس عبر POST /stores مع بيانات الاعتماد. التدفق المعتاد:

تثبيت + حالة + مزامنة
POST /api/v1/integrations/shopify/install
{ "shop": "your-store.myshopify.com" }

# Follow authorize_url, then Shopify redirects to the Pico callback.
GET /api/v1/integrations/shopify/{storeId}/status
POST /api/v1/stores/{storeId}/test
POST /api/v1/catalog/{storeId}/sync

حدود الإصدار الأولي

  • تُدعم مزامنة الكتالوج والاكتشاف المستند إلى بيانات حقيقية واختيار المتغير والإضافة إلى السلة.
  • لا امتدادات دفع Shopify ولا خصومات ولا واجهات طلبات/عملاء في هذا الدليل.
  • لا يكتب Pico بيانات المنتجات إلى Shopify.
  • إدراج متجر التطبيقات وفوترة Shopify خطوتان منفصلتان للإطلاق.

مراجع Shopify الرسمية

تحقق من المصادقة والصلاحيات وخطوات امتداد السمة في وثائق Shopify:

← العودة إلى نظرة الوثائق