إلى جانب WooCommerce، يفهم ربط المتاجر Webhooks منصات Shopify وسلة وزد. الطلبات تنشئ جهة اتصال العميل أو تحدّثها وتُحسب في تقارير المبيعات، والمنتجات تُبقي الكتالوج متوافقًا مع متجرك. تجد هنا الإعدادات الدقيقة لكل منصة.
قبل أن تبدأ
- من يستطيع ذلك: مالك الشركة ومسؤولوها.
- الباقة: متاح عندما تشمل باقتك ربط المتاجر. وعدد المتاجر المربوطة النشطة حدّ من حدود الباقة.
- مسار مبيعات يجب أن يوجد، لأن الربط يطلب مرحلة. راجع الفرص والمسارات.
- العملات المدعومة: يجب أن تكون الطلبات بـUSD أو EUR أو GBP أو TRY أو SAR أو AED. الطلب بعملة أخرى يُرفض ويُعدّ في بطاقة المتجر.
أنشئ الربط
- من القائمة الجانبية افتح المنتجات، ثم اضغط ربط المتاجر.
- في نموذج ربط متجر اكتب اسم المتجر واختر منصة المتجر: Shopify أو سلة أو زد.
- اختر عملة المتجر. هذه المنصات لا ترسل العملة دائمًا مع المنتجات، فتُستخدم هذه العملة لأسعار المنتجات.
- لـShopify وسلة، الصق مفتاح التوقيع الخاص بالمنصة في سر التوقيع من Shopify أو سلة (انظر قسم كل منصة أدناه). ولزد اتركه فارغًا.
- اختر مرحلة في تبدأ طلبات عروض الأسعار في، وإن أردت شخصًا في إسناد الفرص الجديدة إلى. جهات الاتصال الجديدة من المتجر تُسند إليه.
- اضغط ربط متجر، ثم انسخ العنوان في العنوان الذي يرسل إليه متجرك.
Shopify
يوقّع Shopify الـWebhooks بمفتاح خاص به، وتلصقه أنت في رُتبة CRM.
- في لوحة Shopify افتح Settings ثم Notifications ثم Webhooks، وانسخ المفتاح الذي يذكر Shopify أن الـWebhooks موقعة به. إن لم يظهر مفتاح بعد، فإن Shopify يعرضه بعد إنشاء أول Webhook: أنشئ أول Webhook في الخطوة 3، وانسخ المفتاح، ثم عُد إلى الخطوة 2.
- أنشئ الربط كما سبق، بمنصة Shopify والمفتاح في سر التوقيع من Shopify أو سلة.
- في Webhooks اضغط Create webhook لكل حدث أدناه، بصيغة JSON وبالعنوان من العنوان الذي يرسل إليه متجرك:
| الحدث | الأثر |
|---|---|
| Order creation | يحفظ الطلب ويجد العميل أو ينشئه |
| Order update | يحدّث حالته ومجموعه |
| Order payment وOrder cancellation | اختياريان، ومقبولان أيضًا |
| Product creation وProduct update | ينشئ المنتج أو يحدّثه |
كيف تُقرأ طلبات Shopify:
| في Shopify | يُحسب |
|---|---|
| ملغى | cancelled، ليس بيعًا |
| مسترد أو مُبطل | refunded، ليس بيعًا |
| مُسلّم بالكامل (Fulfilled) | completed، بيع |
| مدفوع | processing، بيع |
| غير ذلك | pending، ليس بيعًا |
تُقرأ الحملة من utm_source وutm_medium وutm_campaign في عنوان صفحة الهبوط للطلب. ويأخذ المنتج SKU وسعر أول شكل له، ويُعد نشطًا عندما تكون حالته active.
سلة
ترسل سلة الـWebhooks من تطبيق في بوابة شركاء سلة، وتوقّعها بسر Webhook ذلك التطبيق.
- في بوابة شركاء سلة افتح إعدادات Webhooks لتطبيقك، واختر استراتيجية الحماية Signature، وانسخ السر.
- أنشئ الربط بمنصة سلة والسر في سر التوقيع من Shopify أو سلة.
- أضف العنوان من العنوان الذي يرسل إليه متجرك إلى Webhooks التطبيق، لهذه الأحداث:
order.createdوorder.updatedوorder.status.updatedوorder.cancelledوorder.refundedوproduct.createdوproduct.updatedوproduct.price.updatedوproduct.status.updated.
حالات سلة «قيد التنفيذ» و«تم الشحن» و«جاري التوصيل» تُحسب processing، و«مكتمل» و«تم التوصيل» completed، و«بانتظار الدفع» pending، و«بانتظار المراجعة» on-hold، و«ملغي» cancelled، و«مسترجع» refunded. والمبيعات هي processing وcompleted فقط. المنتج المخفي يُؤرشف. ولا ترسل سلة الحملة مع الطلب.
زد
لا توقّع زد إرسالاتها، لذلك يحمل العنوان نفسه سرك.
- أنشئ الربط بمنصة زد، واترك سر التوقيع من Shopify أو سلة فارغًا.
- انسخ سر التوقيع الذي يظهر مرة واحدة بعد الإنشاء.
- كوّن العنوان: قيمة العنوان الذي يرسل إليه متجرك، ثم
?token=، ثم السر. يبدو هكذا:ADDRESS_FOR_YOUR_STORE?token=YOUR_SECRET. - في زد اشترك بهذا العنوان في
order.createوorder.status.updateوorder.payment_status.updateوproduct.createوproduct.update.
حالات زد «قيد التجهيز» و«جاهز» و«جاري التوصيل» تُحسب processing، و«تم التوصيل» completed، و«جديد» pending، و«ملغي» cancelled، و«مسترجع» refunded. ولا ترسل زد الحملة مع الطلب.
لم تنشر زد قائمة حقول إرسالاتها، فيقرأ رُتبة CRM الأسماء التي تستخدمها واجهة الطلبات لديها. اطلب طلبًا تجريبيًا وتأكد من ظهور جهة الاتصال والطلب قبل الاعتماد على الربط.
اختبر الربط
- اطلب طلبًا تجريبيًا من المتجر.
- في رُتبة CRM افتح جهات الاتصال وابحث عن العميل. ستجد الطلب في سجله.
- في بطاقة المتجر يعرض آخر حدث: وقت الطلب.
- ألغِ الطلب في المتجر، وتأكد في التقارير أنه لم يعد محسوبًا في المبيعات.
معلومات مفيدة
- المطابقة والحساب كما في WooCommerce: البريد أولًا، والهاتف يلتحق فقط بجهة لا تحمل بريدًا آخر، ولا يُكتب فوق بيانات موجودة، والتحديث الأقدم أو المطابق يُتجاهل. راجع WooCommerce.
- الطلبات السابقة لا تُستورد لهذه المنصات، ويصل ما يحدث من الآن فقط.
- تغيير المفتاح: في زد يعرض استبدال السر سرًا جديدًا مرة واحدة، فحدّث قيمة
tokenفي عنوان زد. أما ربط Shopify وسلة فليس فيه استبدال السر، لأن المفتاح مفتاح المنصة نفسها. فإن غيّرت المفتاح في Shopify أو سلة، فالصق الجديد في مفتاح Webhook الجديد من المتجر في بطاقة الربط واضغط حفظ المفتاح الجديد، فتعرض الصفحة حُفظ. الطلبات تُفحص الآن بالمفتاح الجديد. ومن تلك اللحظة تُرفض الإرسالات الموقعة بالمفتاح القديم. - الأحداث غير المعروفة يُرد عليها وتُتجاهل، فالاشتراكات الزائدة لا تضر.
حل المشكلات
| ما تراه | ما تفعله |
|---|---|
| لم يصل أي حدث بعد. | تأكد من العنوان، ومن جزء ?token= في زد. وفي Shopify وسلة تأكد أن المفتاح الملصوق هو الذي توقّع به المنصة |
| أحداث مرفوضة: مع رقم | كانت تلك الطلبات بعملة غير مدعومة، أو بلا بريد ولا هاتف |
| الصق سر التوقيع من متجرك. عند الربط | تحتاج Shopify وسلة إلى مفتاحهما في سر التوقيع من Shopify أو سلة |
| توقفت الأحداث بعد أن غيّرت المفتاح في Shopify أو سلة | الصق المفتاح الجديد في مفتاح Webhook الجديد من المتجر واضغط حفظ المفتاح الجديد |
آخر تحديث 2026-11-08