> ## 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، وتتبع الطلبات والفواتير، وأدر وصول البوابة، ونظّم العملاء بالفئات.

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

<Note>
  تحتاج إلى دور **المسؤول الرئيسي** أو **المسؤول** لإنشاء أو تعديل أو استيراد أو إعداد ملفات شخصية للعملاء. يمكن للمديرين الاطلاع على تفاصيل العملاء وسجلات النشاط.
</Note>

## إنشاء ملف شخصي للعميل

عند إضافة عميل جديد، ينشئ AgencyHandy له حساباً في البوابة ويرسل دعوة تسجيل دخول آمنة.

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

  <Step title="افتح نموذج الإنشاء">
    انقر فوق **+ إنشاء عميل** في الزاوية العلوية اليمنى. يفتح نموذج.
  </Step>

  <Step title="أدخل معلومات العميل">
    أملأ تفاصيل العميل:

    * **الاسم الأول / الاسم الأخير** *(إلزامي)*
    * **البريد الإلكتروني** *(إلزامي — يُستخدم لإرسال دعوة البوابة)*
    * **اسم الشركة**
    * **رقم الهاتف**
    * **البلد والولاية والمدينة والرمز البريدي**
    * **الفئة** — عيّن فئة إعداد حالية إن كانت مناسبة
  </Step>

  <Step title="احفظ الملف الشخصي">
    انقر فوق **إنشاء**. يُضاف الملف الشخصي إلى قائمة عملائك فوراً.
  </Step>
</Steps>

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

## استيراد العملاء من CSV

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

<Steps>
  <Step title="انقر فوق استيراد">
    من قائمة العملاء، انقر فوق زر **استيراد** في أعلى اليمين.
  </Step>

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

    * اسم العميل *(مطلوب)*
    * البريد الإلكتروني *(مطلوب)*
    * اسم الشركة
    * البلد
    * الولاية
    * المدينة
    * الرمز البريدي
  </Step>

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

  <Step title="معاينة وتأكيد">
    راجع جدول المعاينة لاكتشاف أي مشكلات في التنسيق قبل حفظ البيانات.
  </Step>

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

<Tip>
  إذا تطابقت رؤوس أعمدة جدول البيانات الخاص بك تماماً مع أسماء حقول AgencyHandy (مثلاً "email" أو "company name")، يُملأ أداة التعيين تلقائياً — دون الحاجة إلى تطابق يدوي.
</Tip>

## تصدير العملاء

قم بنسخ قاعدة بيانات عملائك احتياطياً أو شاركها مع أصحاب المصلحة بتصديرها إلى CSV أو Excel.

<Steps>
  <Step title="انقر فوق تصدير">
    من قائمة العملاء، انقر فوق زر **تصدير** في أعلى اليمين.
  </Step>

  <Step title="خصص تصديرك">
    اختر الأعمدة التي ستُضمَّن — اختر **جميع الأعمدة** للتصدير الكامل، أو اختر حقولاً محددة مثل الاسم وبيانات الاتصال والشركة والعنوان.
  </Step>

  <Step title="اختر صيغة">
    اختر **CSV** أو **XLSX** وفقاً للاستخدام المقصود.
  </Step>

  <Step title="نزّل الملف">
    انقر فوق **تصدير**. يُنشأ الملف ويُنزَّل على جهازك. احفظه بأمان لحماية بيانات العملاء.
  </Step>
</Steps>

## تعديل ملف شخصي للعميل

<Steps>
  <Step title="اختر العميل">
    في قائمة العملاء، انقر فوق مربع الاختيار بجانب العميل الذي تريد تحديثه، أو انقر مباشرةً على اسمه لفتح ملفه الشخصي.
  </Step>

  <Step title="ادخل وضع التعديل">
    انقر فوق زر **تعديل** في الزاوية العلوية اليمنى من الملف الشخصي للعميل. يظهر نموذج التعديل.
  </Step>

  <Step title="حدّث المعلومات">
    عدّل أي حقول — الاسم والبريد الإلكتروني والهاتف والعنوان والشركة أو الفئة.
  </Step>

  <Step title="احفظ تغييراتك">
    انقر فوق **تحديث**. تؤكد رسالة تأكيد حفظ الملف الشخصي بنجاح.
  </Step>
</Steps>

## البحث والفرز والتصفية

تمنحك قائمة العملاء عدة أدوات للعثور على العميل الصحيح بسرعة:

<CardGroup cols={2}>
  <Card title="البحث بالاسم" icon="magnifying-glass">
    اكتب اسم العميل في شريط البحث لتصفية القائمة فوراً.
  </Card>

  <Card title="تصفية حسب الشركة" icon="building">
    قلّص القائمة لتعرض العملاء المرتبطين بشركة محددة.
  </Card>

  <Card title="تصفية حسب البريد الإلكتروني" icon="envelope">
    تحديد موقع العميل عندما تعرف عنوان بريده الإلكتروني لكنك لا تعرف اسمه.
  </Card>

  <Card title="تصفية حسب الحالة" icon="circle-check">
    عرض العملاء النشطين أو غير النشطين أو المدعوين فقط.
  </Card>

  <Card title="فرز أبجدياً" icon="arrow-down-a-z">
    فرز قائمة العملاء الكاملة من أ إلى ي أو من ي إلى أ للرجوع السريع.
  </Card>

  <Card title="تصفية حسب الفئة" icon="tag">
    عرض العملاء المعيَّنين لفئة إعداد محددة فقط.
  </Card>
</CardGroup>

## تتبع نشاط العميل

داخل كل ملف شخصي للعميل ستجد علامات تبويب تمنحك صورة حية عن تفاعل ذلك العميل مع وكالتك:

<Accordion title="الطلبات الأخيرة">
  اعرض سجل جميع الطلبات التي قدّمها العميل، بما فيها اسم الخدمة والباقة والحالة والتاريخ. يمنحك هذا لمحة سريعة عن تاريخ مشترياته دون مغادرة إدارة علاقات العملاء.
</Accordion>

<Accordion title="التذاكر الأخيرة">
  اطّلع على جميع تذاكر الدعم أو الخدمة التي قدّمها العميل. استخدم هذا العرض لتحديد أولويات الردود وضمان عدم إغفال أي طلب.
</Accordion>

<Accordion title="الفواتير الأخيرة">
  اطّلع على سجل جميع الفواتير المُنشأة للعميل، بما فيها حالة الدفع. يساعدك هذا على مراقبة الأرصدة المستحقة وسجل الفواتير في مكان واحد.
</Accordion>

## إعداد العميل (الفئات)

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

<Steps>
  <Step title="افتح الإعداد">
    من قسم العملاء، انقر فوق زر **الإعداد**.
  </Step>

  <Step title="أنشئ فئة جديدة">
    انقر فوق **+ إنشاء فئة**.
  </Step>

  <Step title="أدخل تفاصيل الفئة">
    * **اسم الفئة** — تسمية فريدة ووصفية (مثلاً، *عملاء المؤسسات*)
    * **وصف مختصر** — ملاحظة موجزة توضح غرض الفئة
    * **اللون** — اختر لوناً مميزاً للتعرف البصري السريع
  </Step>

  <Step title="احفظ الفئة">
    انقر فوق **إنشاء**. أصبحت الفئة متاحة للتعيين عند تعديل ملفات شخصية للعملاء.
  </Step>

  <Step title="عيّن العملاء إلى الفئة">
    افتح أي ملف شخصي للعميل، وانقر فوق **تعديل**، واختر حقل **الفئة**، وحدد الفئة ذات الصلة. انقر فوق **تحديث** للحفظ.
  </Step>
</Steps>

<Tip>
  استخدم اصطلاحات ألوان متسقة عبر الفئات — مثلاً الأحمر للعملاء ذوي الأولوية العالية والأخضر للحسابات المُدرَجة بالكامل — لجعل القائمة قابلة للمسح البصري في لحظة.
</Tip>

## سجل نشاط العميل

يسجّل سجل النشاط كل حدث تسجيل دخول وخروج لحساب بوابة العميل، مما يمنحك مسار تدقيق واضح لتفاعله.

**لعرض السجل:**

1. انتقل إلى **العملاء** وافتح الملف الشخصي لعميل محدد.
2. انقر فوق علامة تبويب **سجل النشاط** في شريط التنقل العلوي للملف الشخصي.
3. راجع القائمة الزمنية لأحداث المصادقة.

**ما يُظهره السجل:**

* التاريخ والطابع الزمني الدقيق لكل عملية **تسجيل دخول**
* التاريخ والطابع الزمني الدقيق لكل عملية **تسجيل خروج**
* سجل متواصل لجميع أحداث المصادقة

يتحدث السجل في الوقت الفعلي ولا يمكن تعديله أو حذفه. لا يمكن للعملاء الاطلاع على سجل نشاطهم الخاص — وهو مخصص للرقابة الإدارية والامتثال فحسب.

<Note>
  في هذه المرحلة، يلتقط سجل النشاط أحداث المصادقة فقط (تسجيل الدخول والخروج). الإجراءات المتخذة داخل البوابة — كعرض الطلبات — لم تُسجَّل هنا بعد.
</Note>

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

يمكنك إرسال بريد إلكتروني لأي عميل مباشرةً من ملفه الشخصي دون مغادرة AgencyHandy. افتح الملف الشخصي للعميل واستخدم خيار **البريد الإلكتروني** لكتابة رسالتك. حقل **إلى** مُملأ مسبقاً بعنوان بريد العميل الإلكتروني.

## انتحال هوية العميل

يمكن للمسؤولين انتحال هوية حساب عميل لرؤية ما يراه العميل بالضبط في بوابته — وهو أمر مفيد لاستكشاف مشكلات الوصول أو إرشاد العميل عبر عملية ما أثناء مكالمة دعم. ابحث عن خيار **انتحال الهوية** داخل الملف الشخصي للعميل.

<Warning>
  استخدم انتحال الهوية لأغراض الدعم فقط. أي إجراءات تُتخذ أثناء انتحال هوية العميل تُنفَّذ نيابةً عنه وستنعكس في حسابه.
</Warning>

## حسابات الشركات (B2B)

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