> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryoto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# خدمات الويب هوك للتحديثات الفورية

> احصل على تحديثات فورية من OTO عند وصول طلب أو تغيّر حالته أو تعذّر إنشاء شحنة، بدلًا من سؤال واجهة API مرارًا، واعرف كيف تضبطها.

خدمات الويب هوك (Webhooks) هي طريقة OTO في إبلاغ أنظمتك بأن شيئًا ما قد حدث، بدلًا من أن تسأل أنظمتك مرارًا عما إذا كان قد حدث شيء.

## الأحداث الثلاثة

| النوع | متى يُطلَق؟ | المستقبِل المعتاد |
| - | - | - |
| `orderStatus` | عند تغيُّر حالة الطلب. | متجرك الإلكتروني، أو نظام ERP، أو أداة خدمة العملاء. |
| `shipmentError` | عند تعذُّر إنشاء الشحنة لدى شركة الشحن. | أي أداة تنبِّه شخصًا ما. هذا هو الفشل الصامت. |
| `newOrders` | عند وصول طلب إلى OTO. | نظام WMS منفصل يحتاج إلى إنشاء الطلب لديه. |

## الإعداد

سجِّل رابطًا (URL) من **الإعدادات ← Developers ‏← Webhooks**، أو عبر `POST /rest/v2/webhook`. تختار الطريقة، ونوع الحدث، ومفتاح تفويض، ومفتاحًا سريًا؛ وتُوقَّع كل حمولة بيانات بـ **HMAC-SHA256** ليتمكن الخادم لديك من إثبات أنها واردة من OTO.

تجد الحمولات كاملةً، وآلية التوقيع، وقواعد بناء نقطة نهاية تتحمل الإرسال المكرر والوصول بغير ترتيب، في [أحداث الويب هوك](https://docs.tryoto.com/ar/developers/webhook-events.md).

> [!WARNING]
>
> **تحقَّق من التوقيع، فالرابط ليس سرًّا**
>
> أي شخص يعرف رابط الويب هوك الخاص بك يمكنه الإرسال إليه. ودون التحقق، يستطيع أن يُبلغ نظامك بأن طلبًا قد تم توصيله.
>
> أعد حساب الـ HMAC، وقارِن في زمن ثابت، وارفض الطوابع الزمنية القديمة.

## البديل، ولماذا لا يصلح مع النموّ

يمكنك بدلًا من ذلك استعلام `orderStatus` دوريًا على فترات منتظمة، وهذا يعمل في اليوم الأول دون الحاجة إلى استضافة نقطة نهاية. لكن مع الأحجام الكبيرة يعني ذلك آلاف الاستدعاءات لمعرفة أن شيئًا لم يتغير، والحالة الوحيدة التي تحتاجها قد تصل متأخرة بمقدار فترة استعلام كاملة.

## صفحات ذات صلة

* [أحداث الويب هوك](https://docs.tryoto.com/ar/developers/webhook-events.md): الحمولات والتحقق.
* [التعاون والإشعارات](https://docs.tryoto.com/ar/platform/collaboration-and-notifications.md): الأحداث نفسها، مرسلةً إلى الأشخاص.
* [تحديثات الحالة والتتبع](https://docs.tryoto.com/ar/modules/sales-channels/updates.md): الأحداث نفسها، مرسلةً إلى قناة بيع.


## Related topics

- [بنية المنصة](https://docs.tryoto.com/ar/get-started/architecture.md)
- [نظرة عامة على عمليات الربط](https://docs.tryoto.com/ar/integrations/overview.md)
- [نظرة عامة على OTO API](https://docs.tryoto.com/ar/developers/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.