# أرسل الأحداث إلى أنظمتك عبر webhooks

> يُبلغ الـ webhook نظامك الخاص لحظة حدوث شيء في متجرك، مثل طلب جديد أو تغيّر في المخزون. أضف URL نقطة النهاية في الإعدادات > Webhooks، واختر الأحداث، وأرسل اختبارًا، وشاهد كل عملية تسليم واستجابتها.

مركز المساعدة / التكاملات - آخر تحديث 2 نوفمبر 2026

يرسل الـ webhook رسالة إلى عنوان ويب تختاره، لحظة حدوث شيء في متجرك. على سبيل المثال، يمكن أن يصل طلب جديد مباشرة إلى نظام التجهيز لديك، وتغيّر المخزون إلى جدول المخزون، وعميل جديد إلى نظام إدارة العملاء. لا تحتاج أنظمتك إلى سؤال Shoprocket باستمرار عن التغييرات.

تحتاج إلى مكان تذهب إليه الرسائل: عنوان على خادمك الخاص، أو أداة تمنحك عنوانًا، مثل منصة أتمتة. إعداد الطرف المستقبِل عادةً من عمل المطوّر.

## قبل أن تبدأ

- تتوفر Webhooks في خطة **Growth** وما فوقها. في خطة أدنى، تعرض الشاشة الخطة التي تتضمنها.
- إنها جزء من تطبيق **أدوات المطوّرين**، مع **مفاتيح API**. إن لم ترَ **Webhooks** تحت **الإعدادات** في الشريط الجانبي، فانتقل إلى **التطبيقات**، وابحث عن **أدوات المطوّرين** تحت **المطوّرون** وانقر **إضافة**. راجع [أضف التطبيقات وأزلها](https://shoprocket.io/ar/help/the-apps-page.md).

## أضف نقطة نهاية

1. في لوحة التحكم، انتقل إلى **الإعدادات > Webhooks** وانقر **إضافة نقطة نهاية**.
2. أدخل **الاسم**. سمّها باسم النظام الذي ترسل إليه، لتعرف ما الذي يتعطل إن حذفتها.
3. أدخل **URL نقطة النهاية**. يجب أن يبدأ بـ `https://`.
4. اترك **نقطة نهاية وضع الاختبار** مطفأة لنقطة النهاية التي تدير عملك الحقيقي. فعّلها لنقطة نهاية يجب أن تستقبل طلبات الاختبار فقط.
5. اختر الأحداث المرسلة. حدّد الأحداث واحدًا واحدًا، أو استخدم **تحديد الكل** لمجموعة، أو **الاشتراك في كل الأحداث**. الأفضل أن تختار الأحداث التي يستخدمها نظامك فقط. انقر **مثال** بجانب حدث لترى الرسالة التي يرسلها.
6. انقر **إضافة نقطة نهاية**.

![لوحة إضافة نقطة نهاية webhook: الاسم Fulfilment، وURL نقطة نهاية https، ونقطة نهاية وضع الاختبار مطفأة، وأحداث الطلبات محدّدة مع مثال رسالة مفتوح](https://shoprocket.io/img/help/webhooks/add-endpoint.webp)

## الأحداث

| المجموعة | الأحداث |
|---|---|
| **الطلبات** | إنشاء، تحديث، دفع، استرداد، تجهيز، تجهيز جزئي، حذف |
| **العملاء** | إنشاء، تحديث، حذف |
| **المنتجات** | إنشاء، تحديث، حذف |
| **المخزون** | تحديث المخزون |
| **الخصومات** | إنشاء، تحديث، حذف |
| **الفئات** | إنشاء، تحديث، حذف |
| **الاشتراكات** | إنشاء، تجديد، فشل التجديد، إيقاف مؤقت، استئناف، إلغاء، انتهاء |
| **مفاتيح الترخيص** | تعيين، تعليق، إعادة تفعيل، انتهاء، إلغاء |

## أرسل اختبارًا

انقر **إرسال اختبار** على نقطة نهاية. يرسل Shoprocket حدث اختبار فورًا ويخبرك إن قبلته نقطة النهاية وبماذا أجاب خادمك، مثل "استجاب بالرمز 200 خلال 140ms."، أو أنه تعذّر الوصول إليها أصلًا.

## شاهد ما أُرسل

تسرد بطاقة **عمليات التسليم الأخيرة**، أسفل نقاط النهاية، كل حدث حاول Shoprocket إرساله: متى، ورمز الاستجابة الذي أعطاه خادمك، وعدد المحاولات. تكون عملية التسليم **تم التسليم** أو **في الانتظار** أو **إعادة المحاولة** أو **فشل**. بعد أن تصلح مشكلة لديك، انقر **إعادة الإرسال** على أي عملية تسليم لإرسالها مجددًا.

![عمليات التسليم الأخيرة لنقطة نهاية: أحداث مسلّمة برمز HTTP 200، وواحدة قيد إعادة المحاولة برمز HTTP 500، وزر إعادة الإرسال](https://shoprocket.io/img/help/webhooks/recent-deliveries.webp)

## عندما تفشل عمليات التسليم

يجب أن يجيب خادمك على كل رسالة بأي رمز استجابة 2xx. إن لم يفعل، يواصل Shoprocket المحاولة لمدة يوم تقريبًا.

إذا فشلت عمليات التسليم إلى نقطة نهاية واحدة 20 مرة متتالية، تُطفأ نقطة النهاية وتذكر السبب. أصلح نقطة النهاية، ثم انقر **إعادة التفعيل الآن**. عندها يُرسل كل ما تراكم في الانتظار أثناء إطفائها. وقبل أن تُطفأ نقطة النهاية، تحذّرك بينما تتراكم حالات الفشل، مثل "فشلت 3 عمليات تسليم متتالية. بعد 20 نوقف نقطة النهاية هذه تلقائيًا."

## عدّل نقطة نهاية أو احذفها

انقر زر تعديل نقطة النهاية لتغيير اسمها أو عنوانها أو أحداثها، ثم **حفظ**. لإيقاف الإرسال إليها نهائيًا، انقر **حذف** وأكّد.

## للمطوّرين

كل رسالة موقّعة بسر التوقيع الخاص بنقطة النهاية، ليتحقق خادمك من أنها جاءت فعلًا من Shoprocket. انقر **عرض سر التوقيع** على نقطة النهاية لنسخه. تحمل كل رسالة أيضًا اسم حدثها ومعرّف تسليم، ليتمكن خادمك من تجاهل التكرارات. يحتوي دليل المطوّرين على التحقق من التوقيع، ومحتوى كل حدث، وتفاصيل إعادة المحاولة. راجع [Webhooks](https://shoprocket.io/docs/webhooks.md).

## ذو صلة

- [أنشئ مفتاح API](https://shoprocket.io/ar/help/api-keys.md)
- [Zapier](https://shoprocket.io/ar/help/zapier.md)
- [وضع الاختبار والمدفوعات الحقيقية](https://shoprocket.io/ar/help/test-mode-vs-live.md)

[افتح Webhooks في لوحة التحكم](https://app.shoprocket.io/go/settings/webhooks)

---

- HTML version: https://shoprocket.io/ar/help/webhooks
- Language: العربية (ar)
- Also in: [Deutsch](https://shoprocket.io/de/hilfe/ereignisse-mit-webhooks-senden.md), [Ελληνικά](https://shoprocket.io/el/help/webhooks.md), [English](https://shoprocket.io/help/webhooks.md), [Español](https://shoprocket.io/es/ayuda/envia-eventos-con-webhooks.md), [Français](https://shoprocket.io/fr/aide/envoyer-des-evenements-avec-les-webhooks.md), [עברית](https://shoprocket.io/he/help/webhooks.md), [हिन्दी](https://shoprocket.io/hi/help/webhooks.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/webhook.md), [Italiano](https://shoprocket.io/it/aiuto/invia-eventi-con-i-webhook.md), [日本語](https://shoprocket.io/ja/help/webhooks.md), [Lietuvių](https://shoprocket.io/lt/pagalba/webhookai.md), [Norsk](https://shoprocket.io/nb/hjelp/webhooks.md), [Nederlands](https://shoprocket.io/nl/hulp/webhooks.md), [Polski](https://shoprocket.io/pl/pomoc/webhooki.md), [Português](https://shoprocket.io/pt/ajuda/envie-eventos-com-webhooks.md), [Română](https://shoprocket.io/ro/ajutor/webhooks.md), [Русский](https://shoprocket.io/ru/help/webhooks.md), [ไทย](https://shoprocket.io/th/help/webhooks.md), [Türkçe](https://shoprocket.io/tr/yardim/webhooklar.md), [中文](https://shoprocket.io/zh/help/webhooks.md)
