انتقل إلى المحتوى الرئيسي
Phynxa

Shopify

اربط متجر Shopify واحدًا بتطبيق من Dev Dashboard أو برمز إدارة قديم ليستطيع الوكيل البحث عن الطلبات والعملاء والمنتجات.

ما الذي ستحققه

سيعرض متجرك Connected في Phynxa.

نظرة عامة وحالات الاستخدام

يستطيع الربط إيجاد الطلبات والعملاء والمنتجات وإنشاء عميل عبر Admin GraphQL API في Shopify (الإصدار 2026-10): وهي اللبنات الأساسية للردّ على مكالمات من نوع "أين طلبي؟".

المتطلبات المسبقة

  • متجر Shopify تملكه، وإذن إنشاء تطبيق له.

إعداد الحساب الخارجي (في Shopify)

Shopify هي التي تتحكم في هذه الشاشات. دليل Shopify: Client credentials grant.

التطبيقات الجديدة (منذ 1 يناير 2026)

  1. في Shopify Dev Dashboard أنشئ تطبيقًا تملكه المؤسسة نفسها التي تملك متجرك.
  2. امنحه النطاقات (scopes) أدناه وثبّته على المتجر.
  3. انسخ Client ID وClient secret.

أما التطبيقات المخصصة القديمة المنشأة في إدارة المتجر قبل 2026 فما زال لها رمز دائم يبدأ بـ shpat_. ويمكنك استخدامه بدلًا من ذلك.

اربطه في Phynxa

  1. Integrations، Connect في Shopify.
  2. أدخل Shop (مثل acme.myshopify.com).
  3. أدخل Client ID وClient secret، أو فقط Admin API token (older apps) واترك حقول العميل فارغة.
  4. اختر Check and connect.

الأذونات والإعدادات

النطاقات: read_orders وread_customers وwrite_customers وread_products. وتحتاج الطلبات الأقدم من 60 يومًا أيضًا إلى read_all_orders. ومع client secret تحصل Phynxa على رمز يدوم 24 ساعة وتجدده تلقائيًا.

استخدمه في مكالمة

في تبويب Tools للوكيل، Add tool، Integration، Shopify:

الإجراءما يفعلهيعمل
Find orderيبحث عن طلب: حالته والدفع والشحن والتتبع. ويحتاج order_number وemail المسجّل في الطلب، ولا يُظهر شيئًا ما لم يتطابقا معًا، فمعرفة الرقم وحده لا تكشف شيئًا.ينتظر
Find customerيجد عميلًا بـemail أو phone أو name: الاسم والبريد والهاتف وعدد الطلبات. ولا تُشارَك الملاحظات الداخلية والوسوم والإنفاق مع الوكيل.ينتظر
Create customerيضيف عميلًا من first_name وlast_name وemail وphone؛ ويلزم بريد أو هاتف أو اسم عائلة.في الخلفية
Find productيجد المنتجات بالاسم: السعر والمخزون والمتغيرات. ويحتاج query.ينتظر

اختبره

يجب أن يجيب Test connection "Shopify is responding."

النتيجة المتوقعة

تعرض البطاقة Connected.

استكشاف الأخطاء

  • يفشل الفحص. أعد التحقق من عنوان المتجر وclient ID والسرّ، ومن أن التطبيق مثبَّت على هذا المتجر.
  • طلبات أقدم مفقودة. أضف read_all_orders.
  • أخطاء تبدو كنجاح. يردّ GraphQL في Shopify بالرمز 200 حتى في حالات الفشل؛ وتفسّر Phynxa تلك الحالات فشلًا وتعرض الرسالة.

الأمان وبيانات الاعتماد

تُخزَّن الأسرار مشفّرة. ألغِ تثبيت التطبيق في Shopify لسحب الوصول؛ وRemove ينسى بيانات الاعتماد هنا.

أدلة ذات صلة

هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.