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

# إعداد البريد الإلكتروني الصادر و SMTP وقوالب البريد الإلكتروني

> قم بإعداد عنوان بريد إلكتروني مخصص للمرسل، وربط خادم SMTP، وإضافة سجلات DKIM/SPF لضمان إمكانية التسليم، وتخصيص قوالب البريد الإلكتروني في AgencyHandy.

يتيح لك إعداد البريد الإلكتروني في AgencyHandy استبدال المرسل الافتراضي `noreply@agencyhandy.com` بعنوان بريد إلكتروني مخصص يحمل علامتك التجارية، وإعداد خادم SMTP مخصص لضمان موثوقية التسليم، وتخصيص القوالب المستخدمة لإشعارات العملاء والفواتير والعروض وغير ذلك. يضمن هذا الإعداد وصول رسائلك إلى صناديق بريد العملاء دون أن تُصنَّف كرسائل غير مرغوب فيها، كما يعكس كل رسالة هوية وكالتك.

<Note>
  يمكن لـ **المسؤولين الرئيسيين** و**المسؤولين** فقط إعداد إعدادات البريد الإلكتروني. انتقل إلى **إعداد مساحة العمل ← إعداد البريد الإلكتروني** للوصول إلى هذه الخيارات.
</Note>

***

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

<CardGroup cols={2}>
  <Card title="عنوان البريد الإلكتروني المخصص" icon="envelope">
    حدد اسم المرسل وعنوان البريد الإلكتروني الذي يراه العملاء عند تلقيهم الرسائل من مساحة عملك.
  </Card>

  <Card title="سجلات DKIM و SPF" icon="shield-check">
    أضف سجلات مصادقة DNS لإثبات شرعية رسائلك الإلكترونية ومنع تصنيفها كرسائل مزعجة.
  </Card>

  <Card title="خادم SMTP" icon="server">
    اربط خادم البريد الخاص بك (مثل Gmail أو Outlook أو خادم نطاق مخصص) لإرسال جميع رسائل البريد الصادرة من AgencyHandy.
  </Card>

  <Card title="قوالب البريد الإلكتروني" icon="file-lines">
    خصص المحتوى وسطور الموضوع والعلامة التجارية لكل رسالة بريد إلكتروني تلقائية يرسلها AgencyHandy إلى العملاء.
  </Card>
</CardGroup>

***

## الجزء الأول: إعداد عنوان بريد إلكتروني مخصص

قبل إعداد بريد المرسل، تحتاج إلى نطاق مسجّل مع استضافة بريد إلكتروني. تشمل الموفرون الشائعون Google Workspace وMicrosoft 365 وZoho Mail وCloudflare Email Routing.

<Steps>
  <Step title="سجّل نطاقاً وأعد استضافة البريد الإلكتروني">
    إذا لم تفعل ذلك بعد، سجّل نطاقاً لدى أحد مسجلي النطاقات (مثل GoDaddy أو Namecheap أو Cloudflare) واشترك في خدمة استضافة البريد الإلكتروني. تأكد من أنك قادر على إنشاء وإدارة عناوين البريد الإلكتروني على ذلك النطاق (مثلاً `hello@youragency.com`).
  </Step>

  <Step title="انتقل إلى إعداد البريد الإلكتروني في AgencyHandy">
    سجّل الدخول إلى AgencyHandy. انتقل إلى **إعداد مساحة العمل** في شريط التنقل الأيسر، ثم انقر فوق **إعداد البريد الإلكتروني**.
  </Step>

  <Step title="أدخل اسم المرسل والبريد الإلكتروني">
    في حقل **اسم المرسل**، اكتب الاسم الذي سيراه العملاء كمرسل (مثلاً `AgencyHandy Support` أو اسم وكالتك). في حقل **بريد المرسل الإلكتروني**، أدخل عنوان البريد المخصص (مثلاً `hello@youragency.com`). انقر فوق **حفظ**.
  </Step>

  <Step title="تحقق من عنوان بريدك الإلكتروني">
    يرسل AgencyHandy رابط تحقق إلى عنوان البريد الإلكتروني الذي أدخلته. افتح صندوق بريدك، وابحث عن رسالة التحقق، وانقر فوق الرابط لتأكيد ملكية العنوان.
  </Step>

  <Step title="إعداد سجلات DNS لـ DKIM و SPF و DMARC">
    بعد حفظ بريد المرسل، يوفر لك AgencyHandy سجلات DNS التي تحتاج إلى إضافتها:

    * **سجل SPF** (نوع TXT) — يُخوّل AgencyHandy بإرسال رسائل البريد نيابةً عن نطاقك.
    * **سجلات DKIM** (3 سجلات CNAME) — تضيف توقيعات تشفيرية على الرسائل الصادرة حتى تتمكن خوادم الاستقبال من التحقق من صحتها.
    * **سجل DMARC** — يحدد كيفية تعامل خوادم المستلمين مع الرسائل التي تفشل في اجتياز فحوصات المصادقة.

    أضف جميع هذه السجلات إلى إعدادات DNS للنطاق لدى مسجّلك. لسجلات CNAME الخاصة بـ DKIM، تأكد من **تعطيل وضع البروكسي** إذا كنت تستخدم Cloudflare.
  </Step>

  <Step title="تأكيد الحالة النشطة">
    عد إلى صفحة إعداد البريد الإلكتروني في AgencyHandy. بمجرد انتشار جميع سجلات DNS (قد يستغرق ذلك من دقيقتين إلى ساعتين)، تتغير حالة البريد الإلكتروني من **قيد الانتظار** إلى عرض علامة اختيار خضراء ✅. أصبح بريدك الإلكتروني المخصص نشطاً الآن.
  </Step>
</Steps>

<Tip>
  استخدم [MXToolbox](https://mxtoolbox.com/DKIM.aspx) أو [dmarcian's DKIM Validator](https://dmarcian.com/dkim-validator/) للتحقق من إعداد سجلات DKIM بشكل صحيح. حدّث صفحة إعداد البريد الإلكتروني بصفة دورية أثناء انتظار الانتشار.
</Tip>

***

## الجزء الثاني: إعداد DKIM و SPF (إعداد مستقل)

إذا احتجت إلى إنشاء أو إعادة إنشاء سجلات DKIM و SPF بشكل مستقل، اتبع هذا المسار:

**إعداد مساحة العمل ← رسائل البريد الإلكتروني ← إعداد DKIM و SPF ← إنشاء سجلات DKIM و SPF.**

ثم أضف السجلات إلى DNS الخاص بك:

| نوع السجل | نوع DNS | ما يجب إعداده                                                                    |
| --------- | ------- | -------------------------------------------------------------------------------- |
| SPF       | TXT     | انسخ **الاسم** و**القيمة** من AgencyHandy وأضف سجل TXT جديداً في DNS الخاص بك    |
| DKIM (×3) | CNAME   | انسخ كل زوج من **الاسم** و**القيمة**؛ أضف 3 سجلات CNAME منفصلة مع تعطيل البروكسي |

<Note>
  قد تستغرق سجلات DKIM و SPF ما بين **دقيقتين وساعتين** لتنتشر. إذا ظلت الحالة تُظهر "قيد الانتظار" بعد ساعتين، تحقق من إدخال السجلات دون أخطاء إملائية وأنه لا توجد سجلات متعارضة.
</Note>

***

## الجزء الثالث: إعداد SMTP

يتيح لك SMTP (بروتوكول نقل البريد البسيط) توجيه جميع رسائل البريد الصادرة من AgencyHandy عبر خادم البريد الموثّق الخاص بك، مما يمنحك تحكماً أكبر في إمكانية التسليم والعلامة التجارية.

<Note>
  يمكنك استخدام إما **بريد النطاق المخصص** أو **موفر SMTP** — وليس كليهما في آنٍ واحد. يمكنك التبديل بينهما في أي وقت، ولكنك ستحتاج إلى إعادة إدخال إعدادات البريد الإلكتروني عند العودة إلى البريد المخصص.
</Note>

<Steps>
  <Step title="افتح إعدادات خادم SMTP">
    انتقل إلى **إعداد مساحة العمل ← إعداد البريد الإلكتروني**، ثم انقر فوق **خادم SMTP**.
  </Step>

  <Step title="التبديل إلى موفر SMTP (إذا لزم الأمر)">
    إذا كان لديك بريد إلكتروني مخصص مُعدٌّ مسبقاً، تظهر نافذة تأكيد تسألك عما إذا كنت تريد التبديل. انقر فوق **التبديل إلى SMTP** للمتابعة. سيؤدي هذا إلى تعطيل إعداد البريد المخصص الحالي.
  </Step>

  <Step title="أدخل بيانات اعتماد SMTP">
    أملأ الحقول المطلوبة:

    | الحقل        | مثال على القيمة      | ملاحظات                                     |
    | ------------ | -------------------- | ------------------------------------------- |
    | اسم المضيف   | `smtp.gmail.com`     | عنوان خادم SMTP الخاص بموفر البريد          |
    | اسم المستخدم | `you@yourdomain.com` | عنوان بريدك الإلكتروني الكامل               |
    | كلمة المرور  | كلمة مرور التطبيق    | استخدم كلمة مرور خاصة بالتطبيق (انظر أدناه) |
    | المنفذ       | `465` أو `587`       | 465 لـ SSL، و587 لـ TLS                     |
    | TLS تلقائي   | تشغيل/إيقاف          | اختياري — يُمكّن ترقية TLS التلقائية        |

    انقر فوق **حفظ** عند الانتهاء.
  </Step>

  <Step title="إنشاء كلمة مرور تطبيق (مثال Gmail)">
    إذا كنت تستخدم Gmail مع تفعيل المصادقة الثنائية (مطلوبة لكلمات مرور التطبيق):

    1. انتقل إلى [myaccount.google.com/security](https://myaccount.google.com/security) وتأكد من تفعيل التحقق بخطوتين.
    2. زر [myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords).
    3. انقر فوق **اختيار التطبيق**، واختر **Mail** (أو أدخل اسماً مخصصاً)، ثم انقر فوق **اختيار الجهاز** وحدد إعدادك.
    4. انقر فوق **إنشاء** — يولّد Google كلمة مرور من 16 حرفاً.
    5. انسخ كلمة المرور والصقها في حقل **كلمة المرور** في إعدادات SMTP في AgencyHandy.

    <Warning>
      استخدم **كلمة مرور التطبيق**، وليس كلمة مرور حساب Google العادية. استخدام كلمة مرورك العادية سيفشل إذا كانت المصادقة الثنائية مفعّلة وقد يُثير تنبيهات أمنية.
    </Warning>
  </Step>

  <Step title="تأكيد الإعداد">
    بعد الحفظ، يعرض AgencyHandy رسالة نجاح تؤكد *"تم إنشاء SMTP بنجاح."* تظهر تفاصيل المضيف واسم المستخدم والمنفذ المحفوظة على صفحة إعدادات SMTP.
  </Step>

  <Step title="اختبار اتصال SMTP">
    انقر فوق زر **اختبار** وأدخل عنوان بريد إلكتروني للمستلم. يرسل AgencyHandy رسالة اختبار إلى ذلك العنوان. تحقق من صندوق الوارد للتأكد من رسالة التأكيد: *"هذا تأكيد على أن إعداد بريدك الإلكتروني في Agency Handy يعمل بشكل صحيح."*
  </Step>
</Steps>

<Tip>
  يمكن تفعيل إعداد SMTP واحد فقط لكل مساحة عمل في وقت واحد. بمجرد إعداد SMTP، سيتم إرسال جميع رسائل البريد الصادرة من AgencyHandy — الفواتير والعروض وإشعارات المهام — عبر خادم SMTP الخاص بك.
</Tip>

***

## الجزء الرابع: تخصيص قوالب البريد الإلكتروني

يتضمن AgencyHandy قوالب جاهزة لكل رسالة بريد إلكتروني تلقائية يرسلها. يمكنك تخصيص كل قالب ليتناسب مع أسلوب علامتك التجارية ويتضمن محتوى ديناميكياً ذا صلة.

**القوالب المتاحة تشمل:**

* تسجيل العميل
* إرسال العرض
* مراجعة المهمة
* إرسال الفاتورة
* تذكيرات الفاتورة والاشتراك
* إشعارات إنشاء التذكرة

<Steps>
  <Step title="افتح قوالب البريد الإلكتروني">
    انتقل إلى **إعداد مساحة العمل ← رسائل البريد الإلكتروني**، ثم اختر **قالب البريد الإلكتروني** من القائمة الفرعية.
  </Step>

  <Step title="اختر قالباً للتعديل">
    تُعرض القائمة الكاملة للقوالب المتاحة. انقر فوق أي قالب لفتح صفحة إعداده.
  </Step>

  <Step title="خصص حقول القالب">
    قم بتحديث ما يلي حسب الحاجة:

    * **بريد المرسل الإلكتروني:** اختر عنوان البريد الإلكتروني المُعدّ الذي يُرسل هذا القالب.
    * **الموضوع:** اكتب سطر موضوع واضحاً وموجزاً.
    * **النص:** عدّل محتوى الرسالة ليتناسب مع أسلوب وكالتك ورسالتها.
    * **المتغيرات الديناميكية:** أدرج عناصر نائبة مثل `{{client_name}}` أو `{{company_name}}` أو `{{invoice_id}}` لملء بيانات خاصة بكل عميل تلقائياً.
    * **روابط وسائل التواصل الاجتماعي:** أضف روابط إلى حسابات وكالتك الاجتماعية لتعزيز التفاعل.
  </Step>

  <Step title="أرسل بريد إلكتروني اختبارياً">
    انقر فوق **إرسال اختباري** لإرسال معاينة للقالب إلى صندوق بريدك. تحقق من التنسيق والمحتوى وأن جميع المتغيرات الديناميكية تُعبّأ بشكل صحيح.
  </Step>

  <Step title="احفظ تغييراتك">
    انقر فوق **حفظ التغييرات** لتطبيق القالب المحدّث. سيُستخدم الإصدار الجديد في جميع رسائل البريد التلقائية المستقبلية المطابقة لنوع هذا القالب.
  </Step>
</Steps>

***

## ملاحظات مهمة

* **SMTP والبريد المخصص متنافيان.** يمكن تفعيل طريقة واحدة فقط في وقت واحد لكل مساحة عمل.
* **أعد إدخال البريد عند التبديل.** إذا قمت بالتبديل من SMTP إلى إعداد بريد مخصص، يجب عليك إعادة إدخال بيانات اعتماد بريدك المخصص.
* **بيانات اعتماد SMTP الخاطئة تحجب جميع رسائل البريد الصادرة.** تحقق مرة أخرى من اسم المضيف والمنفذ واسم المستخدم وكلمة المرور إذا توقف إرسال الرسائل بعد تغيير SMTP.
* **ينتشر DKIM/SPF بمرور الوقت.** انتظر حتى ساعتين وحدّث صفحة إعداد البريد الإلكتروني قبل الاستنتاج بوجود خطأ.
* **المتغيرات الديناميكية حساسة لحالة الأحرف.** استخدمها بالضبط كما هي موضحة في محرر القوالب لضمان عبئها بشكل صحيح.