إنشاء Webhooks
تعد Webhooks أداة لاسترداد وتخزين البيانات من حدث معين. وهي تتيح لك تسجيل عنوان URL يبدأ بـ https:// حيث يمكن تخزين بيانات الحدث بتنسيقات JSON أو XML. وتُستخدم Webhooks بشكل شائع للأسباب التالية:
- تقديم طلب
- تغيير سعر منتج
- إشعار عميل المراسلة الفورية أو جهاز المناداة الخاص بك عندما تكون غير متصل بالإنترنت
- جمع البيانات لتخزينها في مستودعات البيانات
- دمج برنامج المحاسبة الخاص بك
- تصفية عناصر الطلب وإبلاغ شركات الشحن المختلفة بالطلب
- إزالة بيانات العملاء من قاعدة البيانات الخاصة بك عندما يقومون بإلغاء تثبيت تطبيقك
أحداث Webhook المدعومة
عند إنشاء Webhook، يمكنك التحديد من أي من الأحداث المدرجة. على سبيل المثال، إذا كنت ترغب في إنشاء Webhook يُرسل في كل مرة يتم فيها دفع طلب، فحدد دفع الطلب. ومثال آخر، إذا كنت ترغب في إنشاء Webhook يُرسل في كل مرة يتم فيها تحديث خاصية المتجر، فحدد تحديث المتجر.
| الفئة | الأحداث |
|---|---|
| عربة التسوق |
|
| الدفع |
|
| المجموعة |
|
| العميل |
|
| الخصم |
|
| مسودة الطلب |
|
| التنفيذ |
|
| المخزون |
|
| الموقع |
|
| السوق |
|
| طلب |
|
| منتج |
|
| استرداد الأموال |
|
| المتجر |
|
| وسيلة الدفع |
|
| قالب |
|
| معاملة |
|
إنشاء webhooks
يمكنك إنشاء webhook في أي وقت. يتم توقيع webhooks الخاصة بك باستخدام معرّف (ID) يتكون من مجموعة من الحروف والأرقام الفريدة لمتجرك.
الخطوات:
سطح المكتب
من مسؤول Shopify، انتقل إلى الإعدادات > الإشعارات.
انقر على Webhooks.
انقر على ⊕ إنشاء webhook.
في القائمة المنسدلة الحدث، حدد أيًا من أحداث webhook المدعومة التي تريد استخدامها كحدث webhook الخاص بك. لا يمكنك تغيير حدث webhook بعد إنشائه.
في القائمة المنسدلة التنسيق، اختر التنسيق الذي تريد أن تُرسل به Shopify هذه المعلومات إليك. الخياران هما JSON أو XML.
في حقل رابط URL، أدخل رابط URL الذي تريد تخزين البيانات فيه. لا يمكن إرجاع webhooks إلى روابط URL التالية:
- Localhost
- أي رابط URL ينتهي بكلمة "internal" (مثل
example.com/internal) - أي رابط URL من أي نطاق مخصص مرتبط بالمتجر
- النطاقات "الوهمية" (مثل
www.example.com) - نطاقات Shopify (مثل
shopify.comوmyshopify.com)
في إصدار Webhook API، حدد إصدار webhook المفضل لديك.
انقر على حفظ.
الهاتف المحمول
من تطبيق Shopify، اضغط على
، ثم اضغط على 
الإعدادات.في قسم إعدادات المتجر، اضغط على الإشعارات.
اضغط على Webhooks.
اضغط على ⊕ إنشاء webhook.
في القائمة المنسدلة الحدث، حدد أيًا من أحداث webhook المدعومة التي تريد استخدامها كحدث webhook الخاص بك. لا يمكنك تغيير حدث webhook بعد إنشائه.
في القائمة المنسدلة التنسيق، اختر التنسيق الذي تريد أن تُرسل به Shopify هذه المعلومات إليك. الخياران هما JSON أو XML.
في حقل رابط URL، أدخل رابط URL الذي تريد تخزين البيانات فيه. لا يمكن إرجاع webhooks إلى روابط URL التالية:
- Localhost
- أي رابط URL ينتهي بكلمة "internal" (مثل
example.com/internal) - أي رابط URL من أي نطاق مخصص مرتبط بالمتجر
- النطاقات "الوهمية" (مثل
www.example.com) - نطاقات Shopify (مثل
shopify.comوmyshopify.com)
في إصدار Webhook API، حدد إصدار webhook المفضل لديك.
اضغط على حفظ أو ✓.
بعد حفظ webhook الجديد الخاص بك، سيتم عرضه في صفحة Webhooks.
تعديل webhooks
يمكنك تعديل تكوين webhook بعد إنشائه. ومع ذلك، لا يمكنك تعديل حدث webhook المحدد.
الخطوات:
سطح المكتب
من مسؤول Shopify، انتقل إلى الإعدادات > الإشعارات.
انقر على Webhooks.
في الصف الذي يحتوي على webhook الذي تريد تعديله، انقر على ... > تعديل.
في مربع الحوار تعديل webhook، قم بتعديل webhook حسب المطلوب.
انقر على حفظ.
الهاتف المحمول
من تطبيق Shopify، اضغط على
، ثم اضغط على الإعدادات.في قسم إعدادات المتجر، اضغط على الإشعارات.
اضغط على Webhooks.
في الصف الذي يحتوي على webhook الذي تريد تعديله، اضغط على ... > تعديل.
في مربع الحوار تعديل webhook، قم بتعديل webhook حسب المطلوب.
اضغط على حفظ أو ✓.
اختبار webhooks
يمكنك اختبار webhook الخاص بك للتأكد من إرسال معلومات الحدث التي تريدها إلى رابط URL الصحيح.
الخطوات:
سطح المكتب
من مسؤول Shopify، انتقل إلى الإعدادات > الإشعارات.
انقر على Webhooks.
في الصف الذي يحتوي على webhook الذي تريد اختباره، انقر على ... > إرسال اختبار.
على رابط URL الذي حددته لـ webhook، تحقق من أن الإشعار يعمل بنجاح.
الهاتف المحمول
من تطبيق Shopify، اضغط على
، ثم اضغط على الإعدادات.في قسم إعدادات المتجر، اضغط على الإشعارات.
اضغط على Webhooks.
في الصف الذي يحتوي على webhook الذي تريد اختباره، اضغط على ... > إرسال اختبار.
على رابط URL الذي حددته لـ webhook، تحقق من أن الإشعار يعمل بنجاح.
حذف webhooks
يمكنك حذف webhook من مسؤول Shopify. لا يمكن التراجع عن هذا الإجراء.
الخطوات:
سطح المكتب
من مسؤول Shopify، انتقل إلى الإعدادات > الإشعارات.
انقر على Webhooks.
في الصف الذي يحتوي على webhook الذي تريد حذفه، انقر على ... > حذف.
الهاتف المحمول
من تطبيق Shopify، اضغط على
، ثم اضغط على الإعدادات.في قسم إعدادات المتجر، اضغط على الإشعارات.
اضغط على Webhooks.
في الصف الذي يحتوي على webhook الذي تريد حذفه، اضغط على ... > حذف.