---
title: أنواع الأحداث
description: مرجع أنواع أحداث Webhook في IDCloud — حمولات اكتمال العملية والفشل وتغيير الحالة.
canonical: https://developer.unico.io/ar/dual-api/developers/webhooks-and-events/event-types
locale: ar
generated_by: markdown-export
---

تصف حمولات Webhook انتقال حالة العملية. تُوثّق هذه الصفحة مخطط الحمولة والتعداد الكامل لقيم `lastEvent`.

### مخطط الحمولة

| الحقل | النوع | الوصف |
|---|---|---|
| `processId` | `string` (UUID) | معرّف المعاملة. |
| `state` | `string` | الحالة الحالية للمعاملة. حالياً: `PROCESS_STATE_FINISHED`. |
| `flow` | `string` | التدفق الذي نُفِّذ لهذه المعاملة (مثل: `id`، `idtoken`). |
| `lastEvent` | `string` | آخر حدث في المعاملة. **يُعاد فقط عندما تنتهي صلاحية العملية قبل أن يُكمل المستخدم التدفق.** |
| `lastEventDescription` | `string` | وصف مقروء للإنسان لـ `lastEvent`. **يُعاد فقط عندما تنتهي صلاحية العملية قبل أن يُكمل المستخدم التدفق.** |

:::note[مفردات الحالة]
يستخدم حقل `state` في حمولات Webhook البادئة `PROCESS_STATE_*`. هذه مفردات مستقلة عن حقلَي `result` و`status` اللذَين تُعيدهما نقطة نهاية GetProcess، واللذان يستخدمان `PROCESS_RESULT_*`. لا تعامل هذه المفردات على أنها قابلة للتبادل.
:::

### مثال على الحمولة

#### منتهية — ناجحة

```json
{
  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "state": "PROCESS_STATE_FINISHED",
  "flow": "id"
}
```

#### منتهية — منتهية الصلاحية

```json
{
  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "state": "PROCESS_STATE_FINISHED",
  "flow": "id",
  "lastEvent": "EVENT_TYPE_SESSION_ENDED",
  "lastEventDescription": "Session ended by timeout or by new session created"
}
```

### تعداد lastEvent

القائمة الكاملة للقيم التي قد تظهر في `lastEvent`:

| الحدث | الوصف |
|---|---|
| `EVENT_TYPE_PROCESS_CREATED` | تم إنشاء العملية |
| `EVENT_TYPE_QR_CODE_READ` | تمت قراءة رمز QR |
| `EVENT_TYPE_PROCESS_STARTED_BY_USER` | بدأ المستخدم العملية |
| `EVENT_TYPE_IDENTITY_VALIDATION_STEP_FINISHED` | اكتملت خطوة التحقق من الهوية |
| `EVENT_TYPE_DOCUMENT_STEP_STARTED` | بدأت خطوة المستند |
| `EVENT_TYPE_DOCUMENT_PHOTO_CAPTURED` | تم التقاط صورة المستند |
| `EVENT_TYPE_DOCUMENT_UPLOADED_FROM_GALLERY` | تم رفع المستند من المعرض |
| `EVENT_TYPE_DOCUMENT_STEP_FINISHED` | اكتملت خطوة المستند |
| `EVENT_TYPE_SESSION_ENDED` | انتهت الجلسة بسبب انتهاء المهلة أو إنشاء جلسة جديدة |
| `EVENT_TYPE_ERROR_ON_DOCUMENT_STEP` | خطأ في خطوة المستند |

:::secondary[معالجة قابلة للتهيئة]
قد تتطور مجموعة الأحداث. تعامل مع الأحداث التي يتفاعل معها endpoint الخاص بك باعتبارها **إعداداً**، لا ثوابت مُضمَّنة في الكود — بهذه الطريقة يمكن تفعيل أحداث جديدة دون نشر جديد.
:::

### قراءة النتيجة الكاملة للعملية

تُشير حمولة Webhook إلى اكتمال العملية، لكنها لا تتضمن النتيجة نفسها. لاسترداد النتيجة — إلى جانب بيانات الالتقاط، ونتائج القياس الحيوي، وحقول المستند، وما إلى ذلك — استدعِ نقطة النهاية المناسبة **GetProcess**:

- لتدفقات المرئي / الويب والأجهزة الأصلية: انظر [مرجع API > الويب والأجهزة الأصلية > GET /v1/process/{id}](/dual-api/developers/api-reference/web-sdk).
- لتدفقات غير المرئي / API: انظر [مرجع API > API > GET /processes/v1/{id}](/dual-api/developers/api-reference/api).