> ## 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.

# رسائل العميل

> في Didit، عاين الرسائل الثابتة، واطلب معلومات من جهة اتصال موثّقة، وراجع ردود العملاء.

افتح الحالة واختر **مراسلة العميل**.
اختر مستلمًا متحقَّقًا منه واللغة والغرض، ثم حدّد **معاينة**.
تعرض المعاينة المُرسِل والمستلم والموضوع ونص البريد الإلكتروني بدقة.
اختر **تعديل** لتغيير الاختيار، أو **إرسال** لتأكيده.
يجب إنشاء المعاينة من جديد قبل الإرسال إذا تغيّرت أو انتهت صلاحيتها.

## أغراض الرسائل

| الغرض | إجراء العميل | حالة الحالة |
| - | - | - |
| مستند الهوية | رفع صورة واضحة لمستند الهوية | بانتظار المستخدم |
| إثبات العنوان | رفع مستند حديث يُظهر الاسم والعنوان السكني | بانتظار المستخدم |
| مستند الشركة | رفع مستند تسجيل الشركة | بانتظار المستخدم |
| تأكيد التفاصيل | إرسال الاسم الكامل وتاريخ الميلاد ليقيّمهما المراجِع | بانتظار المستخدم |
| المراجعة جارية | لا يلزم أي إجراء؛ لا يحتوي البريد الإلكتروني على زر للرد | بدون تغيير |

تقبل رفع المستندات حاليًا صور JPEG وPNG وWebP بحجم يصل إلى 5 MB.
تظهر الأغراض المنطبقة على الشخص المعني بالحالة فقط.
تتوفر قوالب البريد الإلكتروني للعملاء حاليًا باللغات الإنجليزية والإسبانية والبرتغالية.
تستخدم وحدة التحكم حقل البريد الإلكتروني نفسه ومحدد اللغة نفسه المستخدمين في إعادة إرسال الجلسة.

## المستلمون المتحقَّق منهم والقوالب الثابتة

يجب أن يكون المستلم قد أكمل التحقق من البريد الإلكتروني في جلسة تنتمي إلى الشخص المعني بالحالة والتطبيق.
لا يُعدّ العنوان المستورد في ملف المستخدم أو المعدَّل فيه دليلًا على التحقق.
إذا لم توجد جهة اتصال متحقَّق منها، يوضح المحرر ذلك ويبقى الإرسال معطّلًا.

لا يستطيع المراجِعون إدخال نص بريد إلكتروني حر أو روابط أو عناوين مُرسِل أو مستلمين.
يستخدم البريد الإلكتروني العلامة التجارية الحالية لـ Didit أو العلامة البيضاء.
يتطلب المُرسِل المخصص التحقق من نطاق البريد الإلكتروني المُعدّ.
يوضح كل قالب للمستلم أن البريد الإلكتروني لن يطلب كلمات المرور أو رموز التحقق أو الدفع.

تبقى إعادة إرسال الجلسة إجراءً منفصلًا لتكرار فحوصات التحقق.
تعرض معاينتها بريد إعادة الإرسال الفعلي والفحوصات المحددة.

## التسليم والاستجابات

يميّز سجل الرسائل بين نتائج التسليم: في قائمة الانتظار، وقيد الإرسال، ومُرسَل، ومحاكى، وغير معروف.
البريد المحاكى لا يُرسل فعليًا.
تعني النتيجة غير المعروفة أن المزود ربما قبل البريد الإلكتروني؛ ولا يعيد النظام إرساله تلقائيًا.
عند إعادة محاولة طلب مؤكَّد، يُستخدم معرّف الطلب نفسه لتجنب التسليم المكرر.

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

تظهر الاستجابة المرسلة في **رسائل العميل** بوصفها دليلًا بانتظار المراجعة.
تعود الحالة إلى مفتوحة، ويجب مراجعة الحل المعلّق الموجود من جديد.
لا تستطيع الاستجابات استبدال أي تقديم سابق، ولا اعتماد التحقق الأصلي، ولا الكتابة فوق هوية العميل، ولا المساهمة في نتيجة تتعلق بالاحتيال.

يؤدي حذف التحقق الأصلي أو الحالة إلى حذف طلبات العميل والأدلة المرفوعة المرتبطة بها.

## سير عمل API

جميع endpoints في وحدة التحكم محددة النطاق بالمؤسسة والتطبيق والحالة:

```text theme={null}
GET  /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/options/
POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/preview/
GET  /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/
POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/
POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/{request_uuid}/cancel/
POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/{request_uuid}/remind/
GET  /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/{request_uuid}/attachment/
```

تتطلب قراءة السجل والمرفقات الإذن `read:cases`.
تتطلب إنشاء الرسائل ومعاينتها وتأكيدها وإلغاءها وتذكيرها الإذن `write:cases`.
يجب أن يتضمن التأكيد القيم نفسها للمعاملات `contact_id` و`purpose` و`language`، إضافة إلى `request_id` و`expires_at` و`preview_token` التي تعيدها المعاينة.
تنتهي صلاحية إيصال التأكيد بعد 15 دقيقة، بشكل مستقل عن الموعد النهائي لرد العميل.

يرسل التذكير البريد الإلكتروني نفسه مرة أخرى إلى المستلم المتحقَّق منه نفسه، بحد أقصى مرة واحدة لكل طلب كل 24 ساعة.
لا يغيّر التذكير أي شيء آخر: يحتفظ الطلب بموعده النهائي وتحتفظ الحالة بحالتها.
تعيد الاستجابة الطلب، و`reminded_at`، و`delivery_status` الخاص بالتذكير نفسه (`SENT` أو `SIMULATED` أو `UNKNOWN`)، و`next_reminder_at`.
يعيد الطلب الذي لم يعد العميل مطالَبًا بالرد عليه الرمز `409` مع `code` بقيمة `case_request_not_waiting` و`reason` بإحدى القيم: `answered` أو `cancelled` أو `expired` أو `closed` أو `not_actionable` أو `not_delivered` أو `contact_unavailable`.
يعيد التذكير الثاني خلال 24 ساعة الرمز `429` مع `code` بقيمة `case_request_reminder_too_soon` و`retry_at` كطابع زمني ورأس `Retry-After`.
أثناء انتظار الموافقة على الحل، يعيد التذكير الرمز `400`.

endpoint العميل هو `GET` أو `POST /v3/case-requests/{request_uuid}/` مع رأس `X-Case-Request-Token` الخاص بالطلب نفسه.
يحمل رابط الاستجابة بيانات الاعتماد هذه في جزئه الأخير (مكوّن التجزئة)، وتزيل الصفحة هذا الجزء عند فتحها.
لا يمنح الرمز الوصول إلا إلى هذا الطلب وحده.


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