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

# ربط نطاق مخصص بمساحة عمل AgencyHandy

> اربط نطاقك الفرعي الخاص (مثل portal.yourcompany.com) بـ AgencyHandy عن طريق إضافة سجل CNAME في مزود DNS — دون الحاجة إلى أي برمجة.

بشكل افتراضي، تكون مساحة عمل AgencyHandy الخاصة بك متاحة على نطاق فرعي تحت `agencyhandy.com`. يُتيح لك ربط نطاق مخصص استبدال ذلك الرابط الافتراضي بعنوانك الخاص ذي العلامة التجارية — على سبيل المثال `portal.youragency.com` — مما يُوفّر للعملاء تجربة سلسة واحترافية تعزز علامتك التجارية منذ أول صفحة يصلون إليها.

<Note>
  يمكن لـ **المسؤولين الفائقين** و**المسؤولين** فقط تهيئة نطاق مخصص. يجب أن تمتلك النطاق أيضاً وأن يكون لديك وصول إلى إعدادات DNS الخاصة به في مزود تسجيل النطاق لإتمام هذا الإعداد.
</Note>

***

## كيف يعمل

عند إضافة نطاق مخصص في AgencyHandy، تُوفّر لك المنصة **سجل CNAME**. تُضيف هذا السجل إلى إعدادات DNS لنطاقك في مزود التسجيل (GoDaddy أو Namecheap أو Cloudflare وما إلى ذلك)، ويتحقق AgencyHandy من الاتصال بمجرد انتشار DNS.

***

## الإعداد خطوة بخطوة

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

  <Step title="أضف نطاقك المخصص">
    انقر على زر **+ إضافة نطاق مخصص**. في حقل الإدخال الذي يظهر، أدخل النطاق الفرعي الذي تريد استخدامه — على سبيل المثال `portal.youragency.com`.

    <Warning>
      لا **تستخدم** `www` كنطاق فرعي (أي تجنب `www.youragency.com`). قد يتسبب بادئة `www` في تعارضات في الإعداد ويمنع التحقق الناجح. استخدم نطاقاً فرعياً مختلفاً مثل `portal` أو `client` أو `app` أو `hub`.
    </Warning>
  </Step>

  <Step title="انسخ تفاصيل سجل CNAME">
    بعد إرسال نطاقك، يعرض AgencyHandy سجل DNS الذي تحتاج إلى إضافته:

    | الحقل      | القيمة                         |
    | ---------- | ------------------------------ |
    | **النوع**  | CNAME                          |
    | **الاسم**  | نطاقك الفرعي (مثل `portal`)    |
    | **القيمة** | الهدف المُقدَّم من AgencyHandy |

    انسخ هذه القيم بعناية — ستحتاجها في الخطوة التالية.
  </Step>

  <Step title="أضف سجل CNAME في مزود تسجيل DNS">
    سجّل الدخول إلى لوحة تحكم مزود تسجيل نطاقك (مثل GoDaddy أو Namecheap أو Cloudflare). انتقل إلى قسم إدارة DNS لنطاقك وأضف سجل CNAME باستخدام النوع والاسم والقيمة المنسوخة من AgencyHandy.

    انظر الإرشادات الخاصة بـ Cloudflare أدناه.
  </Step>

  <Step title="احفظ النطاق في AgencyHandy">
    عد إلى AgencyHandy وانقر على **حفظ النطاق**. ستظهر الحالة في البداية كـ **غير متصل** — وهذا متوقع أثناء انتشار DNS.
  </Step>

  <Step title="انتظر انتشار DNS وتحقق منه">
    قد تستغرق تغييرات DNS من بضع دقائق إلى **48 ساعة** للانتشار على مستوى العالم، اعتماداً على مزود التسجيل وإعدادات TTL. انقر على **تحديث** بشكل دوري للتحقق من حالة الاتصال.

    بمجرد اكتمال الانتشار، تتغير الحالة إلى **متصل** ✅.
  </Step>
</Steps>

<Warning>
  قد يستغرق انتشار DNS ما يصل إلى **48 ساعة**. إذا كان نطاقك لا يزال يُظهر **غير متصل** بعد 48 ساعة، تحقق مرة أخرى من صحة سجل CNAME وعدم وجود سجلات DNS متعارضة لنفس النطاق الفرعي.
</Warning>

***

## تعليمات خاصة بـ Cloudflare

إذا كان نطاقك مُدار من خلال Cloudflare، فهناك إعداد حيوي واحد يجب ضبطه بشكل صحيح:

<Steps>
  <Step title="سجّل الدخول إلى Cloudflare واختر نطاقك">
    افتح [لوحة تحكم Cloudflare](https://dash.cloudflare.com) وانقر على النطاق الذي تربطه بـ AgencyHandy.
  </Step>

  <Step title="انتقل إلى إعدادات DNS">
    انقر على تبويب **DNS** في شريط التنقل العلوي في لوحة إعدادات النطاق.
  </Step>

  <Step title="أضف سجل CNAME">
    انقر على **+ إضافة سجل** وامل الحقول:

    * **النوع:** CNAME
    * **الاسم:** نطاقك الفرعي (مثل `portal`)
    * **الهدف/المحتوى:** القيمة المُقدَّمة من AgencyHandy
    * **TTL:** اضبطه على **دقيقتين** (أو أدنى خيار متاح) أثناء الإعداد الأولي
  </Step>

  <Step title="تعطيل وكيل Cloudflare (أمر حيوي)">
    في عمود **حالة الوكيل**، تأكد من ضبط التبديل على **DNS فقط** (يجب أن تظهر أيقونة السحابة رمادية، لا برتقالية).

    <Warning>
      إذا كان وكيل Cloudflare **مفعّلاً** (أيقونة سحابة برتقالية)، لن يتم حل سجل CNAME بشكل صحيح ولن يتمكن AgencyHandy من التحقق من نطاقك. يجب ضبطه على **DNS فقط** لكي يعمل الاتصال.
    </Warning>
  </Step>

  <Step title="احفظ السجل">
    راجع جميع القيم للتأكد من دقتها وانقر على **حفظ**.
  </Step>
</Steps>

<Tip>
  استخدم [dnschecker.org](https://dnschecker.org) لمراقبة انتشار سجل CNAME عبر مناطق مختلفة في العالم. ابحث عن علامات الاختيار الخضراء في جميع المناطق قبل توقع أن يؤكد AgencyHandy الاتصال.
</Tip>

***

## مراقبة حالة الاتصال

بعد الحفظ، عد إلى **Workspace Config ← النطاق المخصص** في AgencyHandy لمتابعة الحالة:

| الحالة       | المعنى                                                                          |
| ------------ | ------------------------------------------------------------------------------- |
| **غير متصل** | لم ينتشر سجل DNS بعد أو يحتوي على خطأ                                           |
| **متصل**     | النطاق مُتحقَّق منه ونشط — يمكن للعملاء الوصول إلى مساحة عملك عبر الرابط المخصص |

***

## تحديث أو حذف النطاق المخصص

* **لتحديث نطاقك:** احذف الإدخال الموجود وأضف النطاق الجديد باستخدام نفس خطوات الإعداد أعلاه.
* **لحذف نطاقك:** انقر على زر **حذف** بجوار نطاقك في لوحة النطاق المخصص وأكّد الحذف. ستعود مساحة عملك إلى رابط AgencyHandy الافتراضي. يمكنك إعادة إضافة أي نطاق في أي وقت.

***

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

* **استخدم نطاقاً فرعياً، لا نطاقاً جذرياً:** تتطلب النطاقات المخصصة في AgencyHandy نطاقاً فرعياً (مثل `portal.youragency.com`)، وليس نطاقاً جذرياً (مثل `youragency.com`).
* **تجنب `www`:** قد يتسبب النطاق الفرعي `www` في مشاكل أثناء التحقق. استخدم اسم نطاق فرعي مخصصاً بدلاً من ذلك.
* **سجلات دقيقة مطلوبة:** أدخل نوع CNAME والاسم والقيمة تماماً كما هو موضح في AgencyHandy. أي خطأ إملائي أو حرف مفقود يمنع الاتصال.
* **يجب إيقاف وكيل Cloudflare:** اضبط دائماً سجلات Cloudflare على **DNS فقط** للتحقق من النطاق المخصص في AgencyHandy.
* **وصول المسؤولين فقط:** يمكن للمسؤولين الفائقين والمسؤولين فقط إضافة إعدادات النطاق المخصص وتعديلها أو حذفها.