الانتقال إلى المحتوى الرئيسي
أضِف التحقق من الهوية عبر Didit إلى Salesforce Sales Cloud / Service Cloud باستخدام الحزمة المُدارة الخاصة بنا. يُضاف المكوّن إلى صفحات سجلات Contact و Lead، وينشئ الجلسات عبر مؤسستك باستخدام Apex (يبقى مفتاح API الخاص بـ Didit داخل Salesforce)، ويكتب النتائج إلى الحقول القياسية في السجل حتى تتمكن Flows و Reports من اتخاذ إجراءات بناءً عليها. يتيح Invocable Action المدمج لـ Flow Builder تشغيل عمليات التحقق تلقائياً، على سبيل المثال عند إنشاء Lead جديد.

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

  • مؤسسة Salesforce (إصدار Enterprise أو أعلى؛ أو إصدار Developer للاختبار)
  • حساب في Didit Console مع سير عمل مُهيَّأ
  • صلاحية تثبيت الحزم المُدارة وإنشاء Sites في Setup

​
الخطوة 1: تثبيت التطبيق

يثبّت الرابط أدناه الحزمة المنشورة DiditVerifyManaged 1.0.0.2. تثبيت الحزمة منفصل عن الموافقة على إدراج التطبيق في السوق.
  1. افتح رابط التثبيت: https://login.salesforce.com/packaging/installPackage.apexp?p0=04td10000004M0LAAU
  2. اختر Install for Admins Only أثناء تهيئة التكامل واختباره. امنح الوصول للمستخدمين المقصودين بعد التحقق من إعداداتك.
تثبيت تطبيق Didit في Salesforce
  1. انقر على Install

​
الخطوة 2: احصل على بيانات اعتماد Didit

​
احصل على مفتاح API (لوضع API)

  1. سجّل الدخول إلى Didit Business Console
  2. انتقل إلى API & Webhooks في الشريط الجانبي الأيسر
  3. انسخ مفتاح API الخاص بك
كيفية الحصول على مفتاح API من Didit Business Console

​
احصل على مُعرّف سير العمل

  1. في Didit Business Console، انتقل إلى Workflows
  2. اختر سير العمل الذي تريد استخدامه (أو أنشئ واحداً جديداً)
  3. انسخ Workflow ID (وهو UUID بالشكل xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
كيفية الحصول على مُعرّف سير العمل من Didit Business Console

​
الخطوة 3: هيّئ إعدادات Didit

  1. انقر على App Launcher (أيقونة الشبكة في أعلى اليسار) وابحث عن “Didit”
كيفية الدخول إلى تطبيق Didit
  1. افتح تطبيق Didit، وستصل مباشرة إلى علامة التبويب Didit Settings
  2. أدخل بيانات الاعتماد والتفضيلات الخاصة بك:
  1. انقر على Save Settings

​
الخطوة 4: أضف المكوّن إلى صفحات السجلات

  1. انتقل إلى سجل Contact أو Lead
عرض صفحة جهة الاتصال
  1. انقر على أيقونة الترس → Edit Page (أو Setup → Object Manager → Contact/Lead → Lightning Record Pages)
عرض تفاصيل جهة الاتصال
  1. في Lightning App Builder، اسحب Didit Identity Verification من لوحة المكوّنات
سحب مكوّن Didit
  1. انقر على Save ثم Activate للصفحة، واختر “Assign as Org Default” عند التفعيل، وشاهد الفيديو:
حفظ الصفحة وتفعيلها مع مكوّن Didit
  1. يستخدم المثال أعلاه صفحة سجل Contact، والخطوات نفسها تنطبق على صفحات سجلات Lead.

​
كيفية العمل

​
وضع API (موصى به)

  1. يضغط المستخدم على Verify Identity في سجل Contact/Lead
  2. ينشئ Apex جلسة عبر Didit API (يبقى مفتاح API على الخادم)
  3. يفتح Didit SDK مسار التحقق، إما كطبقة منبثقة أو كعرض مدمج داخل الصفحة، وذلك حسب إعداد Display Mode لديك
  4. عند الانتهاء، يُحدَّث السجل تلقائياً:
    • Verification Status ← نتيجة الجلسة (Approved، Declined، In Review، وغيرها)
    • Identity Verified ← true عند Approved؛ وfalse عند Declined
    • الطابع الزمني Verified At وDidit Session ID
    • Verified Document Type وDocument Expiry Date وAML Check Status (تُملأ عبر webhook، انظر أدناه)
  5. يعرض المكوّن حالة التحقق ونوع المستند وتاريخ الانتهاء ونتيجة AML مباشرة داخل الصفحة، دون الحاجة إلى أي إعداد لتخطيط الصفحة
  1. يضغط المستخدم على Verify Identity
  2. يُفتح رابط UniLink ثابت في نافذة منبثقة أو في iframe (لا حاجة إلى استدعاء API)
  3. عند الانتهاء، تُحفظ النتيجة في السجل

​
التحديثات التلقائية للتحقق (Webhooks)

عند اكتمال جلسة التحقق (سواء كان الوكيل يتابع الصفحة أم لا)، يرسل Didit webhook إلى مؤسسة Salesforce الخاصة بك لتحديث سجل Contact/Lead تلقائياً. يتطلب ذلك إعداد Salesforce Site مرة واحدة.

​
لماذا يلزم هذا؟

لا تقبل Salesforce طلبات HTTP واردة من خدمات خارجية دون endpoint عام. ينشئ Salesforce Site هذا الـendpoint حتى يتمكن Didit من دفع نتائج التحقق مباشرة إلى مؤسستك في الوقت الفعلي.

​
الخطوة 1: انتقل إلى Setup > Sites

في Salesforce، انقر على أيقونة الترس > Setup. في مربع Quick Find، اكتب Sites وانقر عليه ضمن Sites and Domains.
الخطوة 1 - البحث عن Sites
إذا كانت هذه أول مرة، فحدِّد “I have read and accepted the Salesforce Site Terms of Use” وانقر على Register My Salesforce Site Domain.
الخطوة 1 - صفحة Sites مع تسجيل النطاق

​
الخطوة 2: إنشاء Site جديد

انقر على زر جديد في قائمة Sites. املأ الحقول التالية:
  • Site Label: DiditWebhook
  • Site Name: يُملأ تلقائياً بالقيمة DiditWebhook
  • Default Web Address: didit
  • Active: محدَّد
  • Active Site Home Page: InMaintenance
اترك جميع الحقول الأخرى بقيمها الافتراضية وانقر على حفظ.
الخطوة 2 - نموذج Site جديد

​
الخطوة 3: تحقق من إنشاء Site

بعد الحفظ، ستظهر صفحة تفاصيل Site. دوِّن Site URL، وسيبدو على النحو التالي https://your-org.develop.my.salesforce-sites.com/didit. ستحتاج إليه لاحقاً.
الخطوة 3 - تم إنشاء Site

​
الخطوة 4: امنح Guest User صلاحية الوصول إلى فئة webhook

في صفحة تفاصيل Site، انقر على Public Access Settings. يفتح هذا ملف تعريف Guest User. مرّر إلى الأسفل حتى Enabled Apex Class Access وانقر على تعديل. حدِّد DiditWebhookReceiver من قائمة Available وانقر على إضافة لنقلها إلى قائمة Enabled. انقر على حفظ.
الخطوة 4 - Apex Class Access

​
الخطوة 5: اضبط webhook في وحدة تحكم Didit

  1. انتقل إلى business.didit.me > API وwebhook
  2. اضبط رابط Webhook على: https://your-org.develop.my.salesforce-sites.com/didit/services/apexrest/didit/webhook/
ملاحظة: تعتمد تنسيق النطاق الدقيق على نوع مؤسستك. تتضمن مؤسسات Developer Edition النطاق .develop في الرابط. أما مؤسسات الإنتاج فتستخدم https://your-org.my.salesforce-sites.com/didit/services/apexrest/didit/webhook/. انسخ الرابط دائماً من صفحة تفاصيل Site (الخطوة 3) للتأكد.
  1. انسخ المفتاح السري لـ webhook
  2. في Salesforce، انتقل إلى Didit Settings والصق السر في حقل Webhook Secret
  3. انقر على Save Settings
هذا كل شيء. ابتداءً من الآن، ستُحدّث كل نتيجة تحقق سجل Contact/Lead تلقائياً، حتى لو لم يكن أحد يفتح صفحة Salesforce.

​
ما الذي يحفظه webhook

عندما يرسل Didit webhook، يُحدَّث سجل Contact أو Lead تلقائياً. يُحدَّث دائماً، بغض النظر عن نوع سير العمل: يُحدَّث فقط عند تضمين الميزة في سير العمل: إذا لم تكن الميزة مفعّلة في سير عمل Didit لديك، فستبقى الحقول المقابلة فارغة ببساطة، ولن يتعطل أي شيء. كما يُنشأ سجل فرعي Didit Verification (Didit_Verification__c) لكل جلسة، ليمنحك سجل التدقيق كاملاً مع تفاصيل إضافية (رقم المستند، ودولة الإصدار، والاسم الوارد في المستند، وتاريخ الميلاد، ودرجة مطابقة الوجه، ودرجة كشف الحيوية، وعدد تطابقات AML)، وذلك أيضاً فقط للميزات المضمّنة في سير العمل. يمكنك إضافة القائمة المرتبطة Didit Verifications إلى تخطيط صفحة Contact/Lead لعرض السجل.

​
أتمتة Flow (إجراء Invocable)

تتضمن الإضافة إجراء Invocable Apex يمكن لـ Salesforce Flows استدعاؤه لتشغيل التحقق تلقائياً:
  1. في Flow Builder، أضف عنصر الإجراء
  2. ابحث عن “Create Didit Verification Session”
  3. مرّر معرّف سجل Contact أو Lead
  4. يعيد الإجراء القيم url وsessionId وsuccess وerror
  5. استخدم الرابط في إجراء Send Email أو Send Notification لإرساله إلى العميل
أمثلة على حالات الاستخدام:
  • عند إنشاء Lead: أرسل تلقائياً رابط التحقق إلى كل Lead جديد
  • مراقبة انتهاء صلاحية المستند: أنشئ Scheduled Flow يعمل يومياً، ويعثر على جميع سجلات Contact حيث تكون Document Expiry Date ≤ TODAY + 90 days، ثم يرسل رابط إعادة التحقق. يعمل هذا مباشرة باستخدام الحقل Document Expiry Date الذي يملؤه webhook.

​
استكشاف الأخطاء وإصلاحها

​
الزر لا يستجيب عند النقر

  • تأكد من أنك حفظت مفتاح API ومعرّف سير العمل (Workflow ID) في إعدادات Didit
  • تحقق من أن معرّف سير العمل ينتمي إلى التطبيق نفسه الذي يخص مفتاح API
  • فعّل Debug Logging في إعدادات Didit، ثم تحقق من وحدة تحكم المتصفح بحثاً عن الأخطاء

​
”رد غير بصيغة JSON من Didit API”

  • تحقق من أن Remote Site Setting الخاص بالعنوان https://verification.didit.me مفعّل: Setup → Remote Site Settings
  • تحقق من أن مفتاح API صالح ولم تنتهِ صلاحيته في Didit Business Console

​
يعيد Webhook الاستجابة 401 — “Webhook secret not configured”

  • انتقل إلى Didit Settings والصق مفتاح webhook السري (المنسوخ من Didit Console → API & Webhooks) في حقل Webhook Secret، ثم انقر Save Settings

​
يعيد Webhook الاستجابة 401 — “Invalid signature” أو “Request timestamp is stale”

  • التوقيع غير صالح: تأكد من أن Webhook Secret في Didit Settings يطابق تماماً المفتاح الموجود في Didit Console، دون مسافات أو أحرف إضافية
  • الطابع الزمني قديم: يجب أن تصل webhook خلال 5 دقائق من إرسالها. إذا كانت ساعة مؤسسة Salesforce غير متزامنة، فقد يؤدي ذلك إلى إيجابيات كاذبة، لكن هذا نادر جداً

​
نافذة التحقق لا تفتح (خطأ CSP في وحدة تحكم المتصفح)

  • الـCSP Trusted Site الخاص بالعنوان https://verify.didit.me مضمّن في الحزمة المُدارة ويُنشر تلقائياً. إذا كنت تنشر من المصدر مباشرة، فتأكد من تضمين cspTrustedSites/Didit_Verify_Frontend.cspTrustedSite-meta.xml في عملية النشر

​
الدعم (24/7)

فريقنا متاح لمساعدتك على البدء في استخدام الخدمة وتشغيلها.

البريد الإلكتروني

أرسل لنا بريداً إلكترونياً على hello@didit.me.
آخر تعديل في ٧ نوفمبر ٢٠٢٦