# العمل مع البريد الإلكتروني

##  لإرسال رسائل البريد الإلكتروني 

{% hint style="warning" %}
يرجى الانتباه!

عند تنفيذ وظائف العمل مع رسائل البريد الإلكتروني، تُرجع الدالة:

أ) إما <mark style="color:green;">**NONE**</mark> — عند التنفيذ الناجح للدالة؛

ب) أو <mark style="color:red;">**حالة خطأ**</mark> نص.
{% endhint %}

send\_email() | send\_email\_from\_bot() | send\_email\_template()

<details>

<summary>الوصف</summary>

<mark style="background-color:blue;">**لإرسال رسالة بريد إلكتروني**</mark>

**send\_email(to\_email, subject, message)**&#x20;

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;to\_email - بريد المستلم** الإلكتروني

<mark style="color:red;">**!**</mark>**&#x20;subject -** موضوع البريد الإلكتروني

<mark style="color:red;">**!**</mark>**&#x20;message -** نص رسالة البريد الإلكتروني

<mark style="background-color:blue;">**لإرسال رسائل بريد إلكتروني عبر الروبوت**</mark>

**send\_email\_from\_bot(email\_bot, client\_email, email\_subject, text, attachment\_url)**&#x20;

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;email\_bot** - عنوان البريد الإلكتروني المرتبط بقناة توزيع البريد الإلكتروني \ <mark style="color:red;">**!**</mark>**&#x20;client\_email** - عنوان البريد الإلكتروني للعميل الذي ستُرسل إليه الرسالة\ <mark style="color:red;">**!**</mark>**&#x20;email\_subject** - موضوع البريد الإلكتروني (العنوان)\ <mark style="color:red;">**!**</mark>**&#x20;text** - نص الرسالة المرسل في البريد الإلكتروني \
**attachment\_url** - رابط المرفق&#x20;

<mark style="background-color:blue;">**لإعادة توجيه مسودة بريد إلكتروني أو بريد مُرسل**</mark>

**send\_email\_template(mailing\_id, client\_email, email\_bot, date)**

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;mailing\_id** - معرّف قالب المراسلة (إما مسودة أو بريد إلكتروني جاهز)

<mark style="color:red;">**!**</mark>**&#x20;client\_email** - عنوان البريد الإلكتروني للمستلم

**email\_bot** - عنوان البريد الإلكتروني للمرسل؛ افتراضيًا، البريد الإلكتروني المتصل بالمشروع

**date** - تاريخ إرسال البريد الإلكتروني بالتنسيق ‘dd.mm.yyyy HH:mm’. إذا كان التاريخ في الماضي أو تم حذفه، فسيُرسل البريد الإلكتروني فورًا بعد استدعاء الدالة.

</details>

<details>

<summary>مثال</summary>

لإرسال رسالة بريد إلكتروني:

<div data-with-frame="true"><figure><img src="/files/caa89b7e1b7a8ead76384195c4b75672c081a2fb" alt=""><figcaption></figcaption></figure></div>

الإرسال عبر الروبوت

<div data-with-frame="true"><figure><img src="/files/9f730ab35a5586325553d132e98667358c6412ca" alt=""><figcaption></figcaption></figure></div>

مثال على إرسال بريد إلكتروني تم إرساله مسبقًا:

نأخذ المتغير من قائمة المراسلة - id.

في هذا المثال، هو 483، وسيُستخدم كـ mailing\_id.

نذهب إلى المُنشئ ونستدعي الدالة بالمعلمات التالية:

الخيار 1 – تحديد المعلمات بشكل صريح:

`e_letter = send_email_template('483', "test@mail.ru", '', '09.08.2022 15:00')`

الخيار 2 – تحديد المعلمات باستخدام المتغيرات:

`mailing_id = '483'`\
`client_email = 'test@mail.ru' # بريد إلكتروني للمستلم`\
`email_bot = ''`\
`date = '09.08.2022 15:00' # نظرًا لأن التاريخ أصبح في الماضي بالفعل وقت الإرسال، فسيُرسل البريد الإلكتروني فور استدعاء الدالة`\
`e_letter = send_email_template(mailing_id, client_email, email_bot, date)`

<div data-with-frame="true"><figure><img src="/files/07d2a9ab1dcd79b45d85f1758e764aeab1e7efa7" alt=""><figcaption><p>مثال على إعداد إرسال بريد إلكتروني</p></figcaption></figure></div>

ونتيجةً لذلك، عند استدعاء الدالة، تم إرسال قالب البريد الإلكتروني المُجهّز مسبقًا إلى <test@mail.com>.

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

```
send_email('john.smith@gmail.com', 'This is a title', 'And this is a text')

/*عبر الروبوت*/
mailing = send_email_from_bot('test_channel@test.com', 'test_client@gmail.com', 'Email subject. Just simple', 'Hi, I'm sending you my message', 'https://sun9-82.userapi.com/impg/L3ZYWHnlseIQsqZO')
```

</details>

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

confirm\_email\_subscription()

<details>

<summary>الوصف</summary>

**confirm\_email\_subscription(email, sender\_name, bot\_email, callback,client\_name)**

{% hint style="info" %}
تم تصميم هذه الدالة لجمع موافقة العملاء على إرسال حملات البريد الإلكتروني.

عندما يقدّم العميل عنوان بريده الإلكتروني عبر المراسلة، يتم أولًا إرسال طلب موافقة.&#x20;
&#x20;لا يتم إنشاء عميل البريد الإلكتروني إلا بعد أن يؤكد العميل موافقته.

ونتيجةً لذلك، تُعد عناوين البريد الإلكتروني التي تم تأكيد الموافقة عليها أكثر موثوقية، مما يساعد على تحسين قابلية تسليم البريد الإلكتروني وسمعة المُرسِل بشكل عام.
{% endhint %}

{% hint style="warning" %}
مهم!&#x20;

لا يمكنك إرسال مراسلات تحتوي على محتوى ترويجي محتمل دون موافقة العميل.

لا تتجاهل هذه المعلومات لتجنب العقوبات على المخالفات.
{% endhint %}

المعلمات:

**البريد الإلكتروني** - عنوان البريد الإلكتروني للعميل للتحقق والإضافة

**sender\_name** - اسم الشركة التي تطلب منها الموافقة على تلقي النشرات الإخبارية

**bot\_email** - عنوان البريد الإلكتروني للروبوت الذي سيتم ربط عميل بريد إلكتروني جديد به

**callback** - ما إذا كانت عمليات الاستدعاء (callbacks) مطلوبة أم لا للعملاء الذين يؤكدون عنوان بريدهم الإلكتروني ولعميل بريد إلكتروني جديد (الافتراضي: False)

**client\_name** - الاسم الذي سيُعيَّن لعميل البريد الإلكتروني

ستكون عمليات الاستدعاء المرسلة بالتنسيق التالي:

"client\_accept\_email\_subscription: #{email}" - استدعاء إلى عميل يؤكد عنوان بريده الإلكتروني

"email\_client\_accepted\_by ID:#{@client.id}" - استدعاء إلى عميل جديد (سيُخزَّن معرّف العميل المُؤكِّد في المتغير client\_father\_id)

أرسل رسالة للتحقق من العنوان بعد أن يقدّم المستخدم بريده الإلكتروني.

بعد أن يؤكد المستخدم موافقته على تلقي النشرات الإخبارية من الشركة، ستتم إضافة عميل بريد إلكتروني جديد إلى قائمتك.

بهذه الطريقة، لن يكون لديك أي "عملاء غير نشطين" في حملاتك، وستتكون قاعدة بيانات بريدك الإلكتروني فقط من عناوين العملاء المهتمين حقًا بمنتجاتك.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/chatbot/functions/alaalh-alhasbh/email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.