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

# أتمتة التحقق من الهوية عبر Zapier

> أتمتة سير عمل التحقق من الهوية عبر تطبيق Didit في Zapier. شغّل عمليات التحقق واستمع إلى النتائج في 6,000+ تطبيق. الدفع حسب الاستخدام.

اربط Didit بـ **6,000+ تطبيق** عبر Zapier، دون الحاجة إلى كتابة أي كود. أنشئ جلسات التحقق تلقائياً، وتفاعل مع تغييرات الحالة، وزامن النتائج مع نظام إدارة علاقات العملاء أو قاعدة البيانات أو أدوات التواصل لديك.

> [card] [فتح Didit على Zapier](https://zapier.com/apps/didit/integrations)
>
> تصفح المشغِّلات والإجراءات والقوالب الجاهزة في سوق Zapier.

[تكامل Didit مع Zapier](https://www.youtube.com/embed/D7X4kNHxX0A?rel=0\&playsinline=1)

***

## ما ستحصل عليه

> [card] إنشاء الجلسات
>
> شغّل جلسات التحقق من خلال إرسال النماذج أو أحداث نظام إدارة علاقات العملاء أو أي تطبيق متصل بـ Zapier.

> [card] Webhook في الوقت الفعلي
>
> استقبل تحديثات الحالة الفورية (Approved وDeclined وIn Review وغيرها) على شكل مشغِّلات في Zapier.

> [card] استرجاع النتائج
>
> استرجع تفاصيل الجلسة كاملة، مثل بيانات الهوية ودرجات كشف الحيوية ونتائج AML، عند الطلب.

***

## المتطلبات الأساسية

| المتطلب | مكان الحصول عليه |
| - | - |
| **حساب Didit** | سجّل عبر [business.didit.me](https://business.didit.me)، وخطة KYC المجانية تكفي للتجربة. |
| **مفتاح API** | الكونسول → **API وwebhook** → انسخ مفتاح الإنتاج. يستخدم تطبيق Zapier هذا المفتاح للمصادقة في كل إجراء. |
| **مُعرّف سير العمل** | الكونسول → **سير العمل** → اختر سير العمل الذي تريد تشغيله (أو [أنشئ واحداً](https://docs.didit.me/ar/console/workflows.md)). |
| **حساب Zapier** | مجاني أو مدفوع: [zapier.com](https://zapier.com). تتيح الخطة المجانية 100 مهمة شهرياً، وهذا يكفي للتجارب الصغيرة. |

***

## كيف يعمل

**1. ربط Didit بـ Zapier**

في Zapier، ابحث عن **Didit** في دليل التطبيقات (أو افتح [صفحة السوق](https://zapier.com/apps/didit/integrations) مباشرةً)، ثم اربط حسابك باستخدام **مفتاح API** من الكونسول → **API وwebhook**.

> [!TIP]
>
> يصادق مفتاح API على كل إجراءات Didit في Zapier. تحتاج إلى الربط مرة واحدة فقط، إذ تشترك كل الـ Zaps في الاتصال نفسه، وتدوير المفتاح في الكونسول يُبطل اتصال Zapier حتى تعيد الربط.

**2. إعداد مشغِّل**

اختر ما يبدأ الـ Zap. يمكن أن يكون **مشغِّل Didit** أو أي تطبيق آخر:

| مصدر المشغِّل | مثال |
| - | - |
| **webhook من Didit** | تغيّرت حالة الجلسة إلى "Approved" |
| **Google Forms** | إنشاء جلسة تحقق ← إرسال نموذج جديد |
| **HubSpot** | تشغيل KYC ← إنشاء جهة اتصال جديدة |
| **Stripe** | التحقق من الهوية قبل الصرف ← عميل جديد |
| **Typeform** | بدء التحقق ← إكمال نموذج التسجيل |

**3. إضافة إجراء من Didit**

استخدم أحد إجراءات Didit المتاحة (تتطابق أسماؤها مع الأسماء الواردة في [صفحة Zapier في السوق](https://zapier.com/apps/didit/integrations)):

**Create Verification Session**: يغلّف `POST /v3/session/`

* أدخل **مُعرّف سير العمل** لسير التحقق المراد تنفيذه.
* اختيارياً، حدّد **رابط الاستدعاء** لإعادة التوجيه بعد التحقق.
* مرّر **بيانات المورّد** (مثل البريد الإلكتروني للمستخدم أو معرّفك الداخلي) لربط الجلسة بسجلاتك.
* يعيد الإجراء `session_id` الجديد و`url` الموجّه للمستخدم و`status` الأولي. استخدم `url` لإرسال المستخدم إلى سير التحقق.

**Retrieve Verification Session**: يغلّف `GET /v3/session/{sessionId}/decision/`

* مرّر `session_id` لجلب نتيجة التحقق كاملة.
* الوصول إلى بيانات الهوية ودرجات كشف الحيوية ونتائج AML و`status` النهائية وروابط الوسائط المرفوعة.

**4. التفاعل مع النتائج**

أضف إجراءات لاحقة بناءً على نتيجة التحقق:

| الحالة | الإجراء المقترح |
| - | - |
| `"Approved"` | تحديث نظام إدارة علاقات العملاء، ومنح الوصول إلى المنصة، وإرسال بريد الترحيب |
| `"Declined"` | تمييز السجل في قاعدة البيانات، وإبلاغ فريق الامتثال، وإرسال بريد الرفض |
| `"In Review"` | إنشاء مهمة لفريق الامتثال، وإرسال إشعار على Slack |
| `"Abandoned"` | إرسال تذكير بالبريد الإلكتروني مع رابط تحقق جديد |

![إنشاء جلسة تحقق من الهوية من Didit من خطوة إجراء في Zapier](https://mintcdn.com/didit-0f962782/DSfxHq_ggIpqiQSG/images/zapier-create-session.png?fit=max\&auto=format\&n=DSfxHq_ggIpqiQSG\&q=85\&s=f847a30aa1e0b600543ae4dec6229cdd)

إنشاء جلسة تحقق من Didit من إجراء في Zapier.

***

## قوالب Zap الشائعة

> [card] Google Forms → Didit → Gmail
>
> يملأ المستخدم نموذج التسجيل ← تُنشأ جلسة التحقق ← تُرسل النتيجة بالبريد الإلكتروني إلى المستخدم والمسؤول.

> [card] HubSpot → Didit → HubSpot
>
> جهة اتصال جديدة ← تشغيل KYC ← تحديث خصائص جهة الاتصال بحالة التحقق وبيانات الهوية.

> [card] Stripe → Didit → Slack
>
> عميل جديد ← التحقق من الهوية ← إبلاغ فريقك على Slack بالنتيجة.

> [card] Webhook → Didit → Airtable
>
> مشغِّل مخصص ← التحقق من المستخدم ← تسجيل نتائج الجلسة في Airtable لسجلات الامتثال.

***

## المشغِّلات والإجراءات المتاحة

تتطابق الأسماء أدناه مع تطبيق Didit الحالي على Zapier في [السوق](https://zapier.com/apps/didit/integrations). إذا رأيت تسمية مختلفة قليلاً داخل Zapier نفسه، فاعتمد واجهة Zapier، فالسلوك الأساسي واحد.

### المشغِّلات (تبدأ Zap)

| المشغِّل | الحدث الأساسي | الوصف |
| - | - | - |
| **Session Status Updated** | [webhook من نوع `status.updated`](https://docs.didit.me/ar/integration/webhooks) | يُطلق في كل مرة تتغير فيها حالة جلسة التحقق (`Approved` و`Declined` و`In Review` و`Resubmitted` و`Abandoned` و`Kyc Expired` وغيرها). |

### الإجراءات (تنفّذ عملاً)

| الإجراء | endpoint الأساسي | الوصف |
| - | - | - |
| **Create Verification Session** | `POST /v3/session/` | يبدأ جلسة جديدة باستخدام سير العمل الخاص بك، ورابط استدعاء اختياري، و`vendor_data`. يعيد رابط الجلسة لمشاركته مع المستخدم. |
| **Retrieve Verification Session** | `GET /v3/session/{sessionId}/decision/` | يجلب حمولة القرار كاملة، أي بيانات الهوية ودرجات الحيوية ونتائج AML والحالة النهائية، لـ `session_id` محدد. |

***

## أمور يجب معرفتها

> [!WARNING]
>
> صُمّم تطبيق Didit في Zapier عمدًا ليغطي أهم ما يمكن أتمتته: بدء الجلسات والاستجابة لتحديثات حالتها. الميزات التالية **غير متاحة حاليًا** عبر Zapier، وتتطلب استدعاء API مباشرًا:
>
> * رفع صورة المستند أو الفيديو أو ملف إثبات العنوان (POA) من خطوة في Zap.
> * تجاوز القرارات عبر [`PATCH /v3/session/{sessionId}/update-status/`](https://docs.didit.me/ar/sessions-api/update-status).
> * endpoints الخاصة بالتحقق من الشركات (KYB) (سجلات الشركات والأشخاص الرئيسيون).
> * أنواع أحداث webhook بخلاف تغييرات الحالة على مستوى الجلسة (مثل `transaction.status.updated` و`user.status.updated`).
>
> إذا احتجت إلى أي من هذه الميزات من أداة بلا كود، فاستخدم [Sessions API](https://docs.didit.me/ar/sessions-api/create-session.md) عبر خطوة **Webhooks by Zapier** في Zapier مع مفتاح API الخاص بك.

***

## نصائح وأفضل الممارسات

> [accordion] استخدم بيانات البائع لربط الجلسات
>
> مرّر دائمًا معرّفًا فريدًا (البريد الإلكتروني أو معرّف المستخدم أو UUID) في حقل **بيانات البائع** عند إنشاء الجلسات. يتيح لك ذلك مطابقة نتائج التحقق مع المستخدم الصحيح في نظامك.

> [accordion] تعامل مع جميع نتائج الحالة
>
> أنشئ مسارات في Zap (باستخدام ميزة Paths في Zapier) للتعامل مع الحالات المختلفة بطرق مختلفة: مقبولة، ومرفوضة، وقيد المراجعة، وأُعيد إرسالها، ومتروكة، ومنتهية الصلاحية، ولكل منها استجابة مخصصة.

> [accordion] استخدم التصفية لتقليل الإشعارات غير الضرورية
>
> أضف تصفية Zapier لتشغيل الإجراءات اللاحقة لحالات محددة فقط. على سبيل المثال، أرسل بريد الترحيب فقط عندما تكون الحالة `"Approved"`.

> [accordion] اختبر قبل الانتقال إلى الإنتاج
>
> استخدم ميزة الاختبار في Zapier مع زر **Try Webhook** في Didit (في Console، ثم API & Webhooks) للتحقق من عمل Zap من البداية إلى النهاية قبل معالجة مستخدمين حقيقيين.

***

## الخطوات التالية

> [card] [دليل البدء السريع](https://docs.didit.me/ar/getting-started/quick-start.md)
>
> إعداد حسابك في Didit، وإنشاء سير عمل، والحصول على مفتاح API الخاص بك.

> [card] [webhook](https://docs.didit.me/ar/integration/webhooks.md)
>
> تعرّف على حمولات payload الخاصة بـ webhook وعلى التحقق من التوقيع للتكاملات من جهة الخادم.


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