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

# سجلات رسائل البريد الإلكتروني للعملاء

> اطّلع على كل رسالة بريد إلكتروني للمعاملات أرسلتها Dodo Payments إلى عميل، وتحقق من وصولها، واقرأ الرسالة تمامًا كما أُرسلت، وأرسلها مرة أخرى.

<CardGroup cols={2}>
  <Card title="List Customer Emails" icon="list" href="/api-reference/customers/list-customer-emails">
    اقرأ رسائل البريد الإلكتروني المرسلة إلى العميل ونتيجة تسليمها.
  </Card>

  <Card title="Get Email Content" icon="envelope-open" href="/api-reference/customers/get-customer-email-body">
    اقرأ رسالة بريد إلكتروني واحدة تمامًا كما أُرسلت.
  </Card>
</CardGroup>

## نظرة عامة

ترسل Dodo Payments رسائل البريد الإلكتروني الخاصة بالمعاملات إلى عملائك نيابةً عنك: الإيصالات، وإشعارات استرداد الأموال، وإشعارات الاشتراكات، ورسائل المطالبة بالدفع والاسترداد، ومنح الاستحقاقات، وروابط تسجيل الدخول إلى Customer Portal.

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

<Frame>
  <img src="https://mintcdn.com/dodopayments/9G2eOufWVa-OvQvG/images/email-logs/sent-emails-tab.png?fit=max&auto=format&n=9G2eOufWVa-OvQvG&q=85&s=6c7fa235800cee5c32eb286312f2a52b" alt="تبويب رسائل البريد الإلكتروني المرسلة في صفحة العميل، ويعرض كل رسالة مع حالة تسليمها" style={{ maxHeight: '500px', width: 'auto' }} width="2310" height="996" data-path="images/email-logs/sent-emails-tab.png" />
</Frame>

<Info>
  تُحتفظ برسائل البريد الإلكتروني لمدة **180 يومًا**. تأتي حالة التسليم من مزود البريد الإلكتروني، وتتحدث خلال ثوانٍ من وقوع الحدث.
</Info>

## عرض رسائل البريد الإلكتروني الخاصة بالعميل

<Steps>
  <Step title="Open the customer">
    انتقل إلى **العملاء** في لوحة التحكم واختر العميل.
  </Step>

  <Step title="Open the Sent Emails tab">
    يسرد التبويب كل رسالة بريد إلكتروني أُرسلت إلى هذا العميل خلال آخر 180 يومًا، بدءًا من الأحدث.
  </Step>

  <Step title="Read a row">
    يعرض كل صف الموضوع، والمرسل أسفله، والفئة، والتاريخ والوقت، وحالة التسليم.
  </Step>
</Steps>

## حالة التسليم

| الحالة       | المعنى                                                              |
| ------------ | ------------------------------------------------------------------- |
| `sent`       | سلّمت Dodo Payments الرسالة إلى المزود. وهي في طريقها إلى المستلم.  |
| `delivered`  | قبل خادم البريد الإلكتروني المستلم الرسالة.                         |
| `failed`     | لم تصل الرسالة. يظهر سبب الفشل.                                     |
| `complained` | أبلغ المستلم عن الرسالة باعتبارها غير مرغوب فيها.                   |
| `blocked`    | لم يُرسل أي شيء. في وضع الاختبار، يعني ذلك استهلاك الحصة الأسبوعية. |

### أسباب الفشل

عند فشل إرسال رسالة بريد إلكتروني، يعرض الصف سببًا يوضح ما إذا كان يلزم اتخاذ إجراء. مرّر المؤشر فوق حالة **فشل** لقراءته:

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

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

## قراءة رسالة بريد إلكتروني

اختر **إعادة الإرسال** في أحد الصفوف لفتح لوحة الرسالة. يعرض **معاينة البريد الإلكتروني** في هذه اللوحة النسخة المخزنة تمامًا كما أُرسلت.

<Frame>
  <img src="https://mintcdn.com/dodopayments/9G2eOufWVa-OvQvG/images/email-logs/email-preview.png?fit=max&auto=format&n=9G2eOufWVa-OvQvG&q=85&s=b0d00b4b6fe62c6ace0b8a2b4419619b" alt="محتوى البريد الإلكتروني المخزن، معروضًا كما تلقاه العميل" style={{ maxHeight: '500px', width: 'auto' }} width="824" height="1148" data-path="images/email-logs/email-preview.png" />
</Frame>

لا تحتوي بعض رسائل البريد الإلكتروني على محتوى لعرضه:

* **رسائل تسجيل الدخول إلى Customer Portal.** تحتوي على رابط تسجيل دخول فعال، لذلك لا يُعرض محتواها مطلقًا.
* **الرسائل المحظورة.** لم تصل إلى المزود، لذلك لا توجد نسخة منها.
* **الرسائل الأقدم من 180 يومًا.** يمسح المزود المحتوى بعد هذه المدة.

## إرسال رسالة بريد إلكتروني مرة أخرى

اختر **إعادة الإرسال** في أحد الصفوف لإرسال الرسالة نفسها مرة أخرى. تعيد Dodo Payments إنشاء الرسالة من الحدث الأصلي، لذلك يعرض الإيصال دائمًا الحالة الحالية للدفع.

<Frame>
  <img src="https://mintcdn.com/dodopayments/9G2eOufWVa-OvQvG/images/email-logs/resend-email.png?fit=max&auto=format&n=9G2eOufWVa-OvQvG&q=85&s=8751c05df35b14f116c8d487eaae7b70" alt="عنصر التحكم في إعادة الإرسال ضمن صف رسالة بريد إلكتروني، مع خيار الإرسال إلى عنوان مختلف" style={{ maxHeight: '500px', width: 'auto' }} width="896" height="2104" data-path="images/email-logs/resend-email.png" />
</Frame>

تُبقي اللوحة العنوان الأصلي في حقل **إلى**. غيّره للإرسال إلى مكان آخر. بعد حدوث فشل دائم، يلزم استخدام عنوان مختلف، لأن استخدام العنوان نفسه سيؤدي إلى الفشل مجددًا.

<Warning>
  إعادة الإرسال هي رسالة بريد إلكتروني جديدة. وتظهر في التبويب كصف مستقل.
</Warning>

### الحدود

* يمكن إرسال كل رسالة بريد إلكتروني مرة أخرى **ثلاث مرات**.
* تُطبَّق فترة انتظار بين المحاولات: خمس دقائق قبل إعادة الإرسال الأولى، وعشر دقائق قبل الثانية، وخمس عشرة دقيقة قبل الثالثة.
* لا يُحتسب الإرسال الذي لم يصل إلى المزود ضمن المحاولات الثلاث، لكنه يضيف إلى فترة الانتظار.
* تتوفر إعادة الإرسال في لوحة التحكم فقط. واجهة API للقراءة فقط.

### الحالات التي لا تتوفر فيها إعادة الإرسال

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

<Note>
  تُرسل رسالة تسجيل الدخول إلى Customer Portal دائمًا إلى العنوان الذي طلبها، وتُنشئ كل عملية إعادة إرسال رابط تسجيل دخول جديدًا.
</Note>

## وضع الاختبار

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

عند استهلاك الحصة، تُسجَّل رسائل البريد الإلكتروني اللاحقة على أنها `blocked` ولا يُرسل أي شيء. يعرض الصف العبارة "Not sent: the test-mode email allowance for this week is spent". وتُعاد تهيئة الحصة كل أسبوع. لا يفرض الوضع المباشر هذا الحد.

<Info>
  لا تُرسل رسائل تسجيل الدخول إلى Customer Portal مطلقًا في وضع الاختبار، ولا تستهلك الحصة.
</Info>

## قراءة رسائل البريد الإلكتروني من خلال API

تتوفر القائمة والمحتوى أيضًا عبر API key الخاص بك، حتى تتمكن من عرض حالة التسليم في أدوات الدعم الخاصة بك.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://live.dodopayments.com/customers/{customer_id}/emails?page_size=10 \
    -H "Authorization: Bearer $DODO_API_KEY"
  ```

  ```typescript Node.js theme={null}
  const res = await fetch(
    `https://live.dodopayments.com/customers/${customerId}/emails?page_size=10`,
    { headers: { Authorization: `Bearer ${process.env.DODO_API_KEY}` } },
  );
  const { items, total_count } = await res.json();
  ```

  ```python Python theme={null}
  import os, requests

  res = requests.get(
      f"https://live.dodopayments.com/customers/{customer_id}/emails",
      params={"page_size": 10},
      headers={"Authorization": f"Bearer {os.environ['DODO_API_KEY']}"},
  )
  items = res.json()["items"]
  ```
</CodeGroup>

يحمل كل عنصر `status`، و`failure_code` و`failure_reason` عند فشل الإرسال، و`has_preview` للإشارة إلى ما إذا كان المحتوى المخزن موجودًا. كما يحمل كائنًا من نوع `policies` يوضح ما يمكنك فعله بالصف:

| الحقل                        | المعنى                                                |
| ---------------------------- | ----------------------------------------------------- |
| `resend_allowed`             | يمكنك إرسال هذا الصف مرة أخرى.                        |
| `retry_allowed`              | فشل الإرسال، ويمكنك محاولة إرساله مرة أخرى.           |
| `resends_remaining`          | عدد مرات إعادة الإرسال المتبقية للرسالة.              |
| `requires_different_address` | سيفشل العنوان نفسه مرة أخرى، لذا يجب تقديم عنوان آخر. |
| `superseded`                 | استبدل إرسال لاحق للرسالة نفسها بهذا الصف.            |

اقرأ `policies` بدلًا من اشتقاق الأهلية بنفسك. يطبّق الخادم القواعد المذكورة أعلاه.

<CardGroup cols={2}>
  <Card title="Customer Management" icon="user-group" href="/features/customers">
    أدر العملاء، وسجل المشتريات، وإمكانية الوصول للخدمة الذاتية.
  </Card>

  <Card title="Communication Preferences" icon="bell" href="/features/communication-preferences">
    اختر رسائل البريد الإلكتروني التي ترسلها Dodo Payments نيابةً عنك.
  </Card>
</CardGroup>