---
title: Webhooks والأحداث
description: مقدمة إلى Webhooks في IDCloud — استقبال إشعارات فورية لأحداث عمليات التحقق من الهوية.
canonical: https://developer.unico.io/ar/dual-api/developers/webhooks-and-events/
locale: ar
generated_by: markdown-export
---

**Webhook** هو خدمة إشعارات منهجية تتيح التكامل غير المتزامن بين الأنظمة — تُخطر Unico IDCloud الخادم الخلفي الخاص بك في كل مرة تتغير فيها حالة عملية ما، بحيث لا تحتاج إلى الاستعلام المتكرر عن التحديثات.

يغطي هذا القسم الأمور الأربعة التي تحتاجها لدمج webhooks: كيفية **إعداد** endpoint والمصادقة، و**الأحداث** التي ترسلها Unico، و**استراتيجية الاحتياطي**، وأنماط **الأمان والموثوقية** التي يجب أن يطبقها endpoint الخاص بك.

### متى تستخدم Webhooks

تُعدّ Webhooks الطريقة الموصى بها للحصول على إشعار عند اكتمال العملية. وهي ذات أهمية خاصة في:

- **تدفقات Web وSDK غير المتزامنة** — للحصول على إشعار عند انتهاء معالجة `POST /client/v1/process` على جانب Unico.
- **التدفقات طويلة الأمد** التي تجمع قدرات متعددة (مثل تحليل المستندات + المراجعة اليدوية). تُطلَق Webhooks فقط عند الحالة النهائية (`PROCESS_STATE_FINISHED`)؛ ولا يتم تسليم أي أحداث تقدم وسيطة.

تكمّل Webhooks endpoints **GetProcess**، لكنها لا تحل محلها. راجع [الاحتياطي](/developers/webhooks-and-events/fallback).

### في هذا القسم

- **[الإعداد](/developers/webhooks-and-events/setup)** — تسجيل endpoint وطرق المصادقة (OAuth2 وBasic وAPI Key) وإعدادات إعادة المحاولة.
- **[أنواع الأحداث](/developers/webhooks-and-events/event-types)** — الأحداث التي ترسلها Unico وبنية الحمولة.
- **[الأمان](/developers/webhooks-and-events/security)** — التعامل مع الطلبات المتكررة وحد التزامن ومعدل الأخطاء.
- **[الاحتياطي](/developers/webhooks-and-events/fallback)** — كيفية استرداد نتيجة العملية عندما يكون webhook غير متاح.