جلب العملاء من Shopify
اربط متجرك على Shopify ليصل عملاؤه كجهات اتصال، مع بلدهم وعدد طلباتهم وقيمتهم لتجميع النتائج — ويمكن لطلب أن يبدأ استبيانًا بعد بضعة أيام.
في هذه الصفحة
اربط متجرك على Shopify وسيقرأ Polzy عملاءه وفق جدول زمني. يصلون كجهات اتصال: يجيبون عن الاستبيانات، ولا يسجّلون الدخول أبدًا، ولا يشغلون مقعدًا. ويأتي معهم بلدهم وعدد طلباتهم وقيمتهم كعملاء وتاريخ تسجيلهم، لتقارن النتائج حسبها. وإذا أضفت أيضًا ويب هوك من Shopify، يمكن لطلب شُحن أو دُفع أو أُلغي أو استُرد مبلغه أن يبدأ استبيانًا — بعد بضعة أيام من التسليم مثلًا.
مزامنة الأشخاص متاحة في خطة Team وما فوقها، ولا يستطيع ربط مصدر إلا مسؤولو مساحة العمل. ويتطلب بدء الاستبيانات من الطلبات أيضًا صفحة التكاملات، المتاحة في خطة Business. يقرأ Polzy من Shopify فقط: لا يغيّر أي عميل أو طلب أبدًا.
قبل أن تبدأ
تحتاج إلى:
- أن تكون مسؤولًا في مساحة عمل Polzy، على خطة Team أو أعلى، مع تفعيل مزامنة الأشخاص من الإعدادات ← عام ← ما تقوم به مساحة العمل هذه.
- العنوان الخاص بمتجرك الذي ينتهي بـ
.myshopify.com— لا نطاقًا مخصصًا مثلshop.acme.com. - رمز Admin API access token لا تنتهي صلاحيته، مع النطاقين
read_customersوread_orders. يبدأ بـshpat_. - الحقول التي تريد تجميع النتائج حسبها في مساحة عملك، مثل البلد وعدد الطلبات وقيمة العميل. ومساحة العمل المخصصة للعملاء تحتويها عادةً.
تتزامن مساحة العمل من مصدر واحد في كل مرة. إذا كان هناك مصدر آخر مربوط، فافصله أولًا.
الحصول على رمز وصول
يصدر Shopify الرمز عبر تطبيق في متجرك. ونوع التطبيق مهم، لأن Polzy يحتفظ بالرمز الذي تعطيه إياه ولا يستطيع تجديده:
- تطبيق مخصص أُنشئ في لوحة إدارة Shopify. رمزه لا تنتهي صلاحيته أبدًا، وهذا ما يحتاجه Polzy. توقّف Shopify عن السماح للمتاجر بإنشاء هذه التطبيقات منذ 1 يناير 2026، لكن التطبيق الموجود يستمر في العمل. في لوحة إدارة Shopify، افتح Apps → Develop apps، واختر التطبيق، وتحقّق ضمن API credentials من أن لديه النطاقين
read_customersوread_orders. يعرض Shopify الرمز مرة واحدة عند تثبيت التطبيق؛ وإن لم يعد لديك، فإلغاء تثبيت التطبيق وإعادة تثبيته يُنشئ رمزًا جديدًا. - تطبيق أُنشئ في Dev Dashboard الخاص بـ Shopify. هكذا تُنشأ التطبيقات المخصصة الجديدة اليوم. والطريقة السريعة للحصول على رمز لها — client credentials grant — تعطي رمزًا تنتهي صلاحيته بعد 24 ساعة، فتتوقف مزامنة Polzy في اليوم التالي. لا تستخدمها إلا إذا استطاع مطوّرك الحصول على رمز offline لا تنتهي صلاحيته.
راجع Shopify: Custom apps وShopify: Admin-created custom apps.
ربط Shopify في Polzy
- افتح جهات الاتصال ← المزامنة والحقول.
- ضمن المصادر المتاحة، ابحث عن Shopify واختر ربط. تُفتح لوحة من ثلاث خطوات: الاتصال وإعدادات المزامنة وربط الحقول.
- أدخل نطاق المتجر، مثل
acme.myshopify.com، والصق Admin API access token. اترك سر التوقيع الخاص بالـ webhook فارغًا ما لم تُعدّ ويب هوك الطلبات (أدناه). - اختر اختبار الاتصال. تعني رسالة Connected to متبوعة باسم متجرك أن الرمز يعمل.
- اختر التالي، وراجع إعدادات المزامنة (انظر أدناه)، ثم اختر التالي مرة أخرى.
- في ربط الحقول، أبقِ الربط الافتراضي أو فعّل تخطيط الحقول المخصص (انظر أدناه)، ثم اختر ربط.
يُخزَّن الرمز مشفّرًا ولا يُستخدم إلا للقراءة من متجرك. يتحقق Polzy منه مجددًا حين تختار ربط: فإن رفضه Shopify، لا يُحفظ شيء.
إعدادات المزامنة
| الإعداد | ماذا يفعل | الافتراضي |
|---|---|---|
| العملاء الذين وافقوا على التسويق فقط | يستورد فقط العملاء الذين وافقوا على التسويق عبر البريد الإلكتروني أو الرسائل القصيرة. مُستحسَن: فاستطلاع العملاء الذين رفضوا التسويق قد يخالف موافقتهم. | معطّل |
| الحد الأدنى لعدد الطلبات | يتخطّى العملاء الذين لديهم طلبات أقل من هذا العدد. عند 1، يُستبعد العملاء الذين لم يطلبوا شيئًا قط. | 1 |
يتزامن Shopify كل ساعة. ويُتخطّى دائمًا العملاء الذين لا يملكون بريدًا إلكترونيًا ولا رقم هاتف.
ربط الحقول
يملأ الربط الافتراضي:
| حقل Polzy | من Shopify |
|---|---|
| البريد الإلكتروني، رقم الهاتف | email، phone |
| الاسم الأول، اسم العائلة | first_name، last_name |
| البلد | default_address.country |
| قيمة العميل | total_spent |
| عدد الطلبات | orders_count |
| تاريخ التسجيل | created_at |
لا يُحفظ البلد وقيمة العميل وعدد الطلبات وتاريخ التسجيل إلا إذا كانت هذه الحقول في مساحة عملك. لتغيير الربط، فعّل تخطيط الحقول المخصص. يصبح لكل صف مصدر تملؤه — اختر أحد حقول Shopify، مثل tags أو default_address.city، أو اكتب مسار أي حقل آخر — وقيمة في إذا كان فارغًا، استخدم، تُكتب حين لا يكون لدى Shopify شيء لذلك العميل. أما القيمة التي يرسلها Shopify فلا تُستبدل أبدًا.
لمقارنة النتائج حسب حقل، اجعله حقلًا من نوع قائمة وفعّل المجموعات بجانبه في جدول ربط الحقول، في المزامنة والحقول. تُطابَق القيم القادمة من Shopify مع خيارات الحقل.
المعاينة وتشغيل المزامنة الأولى
- في المزامنة والحقول، اختر معاينة مزامنة ضمن سجل المزامنة. يحسب Polzy ما ستضيفه المزامنة وتحدّثه دون أن يغيّر شيئًا، ويفتح السجل حيث تظهر النتيجة بوصف معاينة.
- راجع المعاينة، ثم اختر مزامنة الآن. تظهر النتيجة في سجل المزامنة.
يُطابَق العملاء بمعرّفهم في Shopify، ثم بالبريد الإلكتروني، فجهة الاتصال التي أضفتها يدويًا أو عبر CSV من قبل تُحدَّث بدلًا من أن تُضاف مرتين.
بدء الاستبيانات من الطلبات
يستطيع Shopify إعلام Polzy حين يُشحن طلب (orders/fulfilled) أو يُدفع (orders/paid) أو يُلغى (orders/cancelled)، وحين يُسترد مبلغ (refunds/create). عندها يمكن لحملة مضبوطة لتبدأ عند حدوث حدث أن ترسل استبيانًا إلى ذلك العميل بعد المهلة التي تختارها، ويمكن لسير عمل أن يتفاعل مع الحدث نفسه. وتأتي منتجات الطلب معه، لتقارن الإجابات حسب المنتج.
- افتح في Polzy التكاملات، ثم Shopify، وانسخ العنوان الظاهر تحت الاستقبال. هذا العنوان مخصص لاتصالك وينتهي بـ
/shopify. - افتح في لوحة إدارة Shopify Settings → Notifications → Webhooks واختر Create webhook.
- اختر Event — شحن طلب مثلًا —، واختر JSON في Format، والصق العنوان في URL، ثم احفظ. كرّر ذلك لكل حدث تريده.
- انسخ المفتاح الذي يوقّع به Shopify الويب هوك الخاصة بك، والظاهر في صفحة Webhooks.
- افتح في Polzy جهات الاتصال ← المزامنة والحقول، واختر الإعدادات، والصق المفتاح في سر التوقيع الخاص بالـ webhook، ثم اختر حفظ في الخطوة الأخيرة.
يرفض Polzy أي ويب هوك لا يستطيع التحقق منه بذلك المفتاح، فلا يكون للطلبات أي أثر حتى تحفظه. وإذا كان تطبيق في متجرك هو من ينشئ الويب هوك، فهي موقّعة بالمفتاح السري لواجهة API لذلك التطبيق: فالصقه هو. وحين يصل طلب لحملة تنتظره، يُطابَق عميله أولًا أو يُضاف كجهة اتصال. راجع Shopify: Creating webhooks، والحملات لجانب الحملة.
استكشاف الأخطاء وإصلاحها
| ما تراه | السبب | ما تفعله |
|---|---|---|
| Store domain should look like your-store.myshopify.com | أدخلت نطاقًا مخصصًا أو عنوان ويب كاملًا. | أدخل نطاق .myshopify.com الخاص بمتجرك فقط. |
| Shopify rejected the token. Check it has read_customers scope. | الرمز غير صحيح، أو انتهت صلاحيته، أو ينقصه النطاق. | تحقّق من نطاقات التطبيق والصق رمزًا لا تنتهي صلاحيته. |
| Store not found. Check the .myshopify.com domain. | لا يستجيب أي متجر على ذلك النطاق. | انسخ النطاق من لوحة إدارة Shopify. |
| تعمل المزامنة يومًا ثم تفشل | الرمز جاء من client credentials grant وانتهت صلاحيته بعد 24 ساعة. | استخدم رمزًا لا تنتهي صلاحيته — راجع الحصول على رمز وصول. |
| لا تبدأ الطلبات أي استبيان | لم يُحفظ سر التوقيع الخاص بالـ webhook، أو ليس هو المفتاح الذي يوقّع به Shopify، أو لا توجد حملة نشطة تنتظر ذلك الحدث. | الصق المفتاح من صفحة Webhooks، وتحقّق من مشغّل الحملة. |
| لم يتم استيراد N جهة اتصال: تم بلوغ حد جهات الاتصال في الخطة. | نفدت جهات الاتصال في خطتك. | ارفع الحد الأدنى لعدد الطلبات أو فعّل العملاء الذين وافقوا على التسويق فقط، أو غيّر الخطة. |
معلومات مفيدة
- جهات اتصال لا أعضاء. لا يسجّل العملاء الدخول أبدًا، ولا يتلقون دعوة، ولا يشغلون مقعدًا. يُحتسبون ضمن جهات الاتصال في خطتك — 10,000 في Team و50,000 في Business. المزامنة التي تتجاوز ذلك تستورد العملاء الذين يتسع لهم، وتتوقف عندهم، وتُبلغ المسؤولين — راجع الاستخدام والحدود.
- ما يصل إلى 50,000 عميل في كل مزامنة. يُقرأ المتجر الأكبر حتى هذا العدد.
- يبقى العملاء المحذوفون. العميل المحذوف في Shopify لا يُحذف ولا يُعطَّل في Polzy؛ احذف جهة الاتصال من جهات الاتصال إن احتجت.
- قطع الاتصال أو الإزالة. من الإعدادات، يوقف قطع الاتصال المزامنة ويحتفظ بالإعدادات والسجل لتعيد الربط لاحقًا، بينما تحذف إزالة الاتصال. في الحالتين تبقى جهات الاتصال المستوردة في Polzy.
- تحتاج إلى مساعدة؟ يشرح رابط اسأل Polzy في لوحة الربط أين تجد كل قيمة في Shopify.
روابط مفيدة
- Shopify: Custom apps — التطبيقات المخصصة اليوم، وتلك التي أُنشئت قبل 2026.
- Shopify: Admin-created custom apps — أين تجد رمز تطبيق موجود ونطاقاته.
- Shopify: Creating webhooks — ويب هوك الطلبات في لوحة إدارة Shopify.
- الأشخاص وجهات الاتصال — الحقول والمجموعات وجهات الاتصال.
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.