إنتقل إلى المحتوى الرئيسي

خطوات التكوين

اتبع هذه الخطوات لإعداد اتصال صندوق الوارد الشخصي لوحدة Mailbox في Perfex CRM.

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

طرق المصادقة​

تدعم وحدة Mailbox طريقتين للمصادقة:

  1. مصادقة OAuth2 (موصى بها لـ Gmail و Outlook) - اتصال آمن بدون كلمة مرور
  2. مصادقة كلمة المرور - اتصال IMAP تقليدي يعتمد على كلمة المرور

الخيار أ: مصادقة OAuth2 (Gmail/Outlook)​

OAuth2 هي الطريقة الموصى بها لحسابات Gmail و Outlook/Microsoft 365. توفر مصادقة آمنة بدون كلمة مرور ومطلوبة من قبل العديد من مقدمي البريد الحديثين.

لمستخدمي Gmail​

  1. إعداد المسؤول (مرة واحدة، يقوم بها المسؤول):

    • انتقل إلى Setup → Settings → Mailbox Settings
    • مرر إلى قسم OAuth Settings
    • أدخل Gmail OAuth Client ID و Client Secret
    • انقر Save

  2. إعداد الموظف (كل موظف):

    • انتقل إلى Mailbox → Emails (أو Profile → Mailbox Config)
    • حدد OAuth كطريقة المصادقة
    • انقر زر Connect Gmail
    • قم بتفويض التطبيق في النافذة المنبثقة
    • سيتم ربط حساب Gmail تلقائيًا
تلميح

لتعليمات إعداد Gmail OAuth التفصيلية، راجع Gmail OAuth Setup.

لمستخدمي Outlook/Microsoft 365​

  1. إعداد المسؤول (مرة واحدة، يقوم بها المسؤول):

    • انتقل إلى Setup → Settings → Mailbox Settings
    • مرر إلى قسم OAuth Settings
    • أدخل Outlook OAuth Client ID و Client Secret و Tenant ID
    • انقر Save

  2. إعداد الموظف (كل موظف):

    • انتقل إلى Mailbox → Emails (أو Profile → Mailbox Config)
    • حدد OAuth كطريقة المصادقة
    • انقر زر Connect Outlook
    • قم بتفويض التطبيق في النافذة المنبثقة
    • سيتم ربط حساب Outlook تلقائيًا
تلميح

لتعليمات إعداد Outlook OAuth التفصيلية، راجع Outlook OAuth Setup.

معلومات

يتم تحديث tokens OAuth تلقائيًا قبل انتهاء الصلاحية. تحتاج فقط للتفويض مرة واحدة.

الخيار ب: مصادقة كلمة المرور​

لمقدمي البريد الإلكتروني الذين لا يدعمون OAuth2، أو إذا كنت تفضل مصادقة كلمة المرور:

1. أدخل معلومات حساب البريد الإلكتروني​

انتقل إلى قسم Mailbox Configuration Settings بتحديد "Emails" تحت قائمة "Mailbox" على اليسار.

أدخل اسم مستخدم حساب IMAP و كلمة المرور المرتبطة بعنوان بريدك الإلكتروني (مثلاً، إذا كنت مسجلاً كـ [email protected]، قم بإعداد [email protected] كصندوق واردك) ويمكنك إضافة توقيعك هناك اختياريًا.

لأغراض الأمان، لا يمكن لـ [email protected] إعداد اتصال لـ [email protected] في حساب CRM الخاص به. لإعداد [email protected]، أنشئ حساب موظف George في Perfex CRM، ثم قم بتكوين صندوق وارد بريد George من ملفه الشخصي. هذا يضمن عزل اتصالات البريد الإلكتروني لكل موظف وربطها بشكل آمن بحساب المستخدم الخاص به.

بعد إدخال بيانات اعتماد حساب البريد والتوقيع (اختياريًا)، اضغط Save لإتمام الاتصال.

2. إعداد تفاصيل خادم IMAP​

يمكنك تكوين إعدادات IMAP بطريقتين:

الطريقة 1: تكوين IMAP لكل موظف (موصى بها)

يمكن لكل موظف تكوين إعدادات خادم IMAP الخاصة به:

  1. انتقل إلى Mailbox → Emails (أو Profile → Mailbox Config)
  2. مرر إلى قسم IMAP Server Configuration
  3. أدخل IMAP Server (مثل imap.gmail.com)
  4. حدد Encryption Method (SSL أو TLS أو None)
  5. سيتم تحديث IMAP Port تلقائيًا بناءً على التشفير (993 لـ SSL، 143 لـ TLS)
  6. قم بتكوين Folder Mappings:
    • Folder to Scan (عادةً "INBOX")
    • Sent Folder (مثل "Sent"، "Sent Items")
    • Drafts Folder (مثل "Drafts")
    • Trash Folder (مثل "Trash"، "Deleted Items")
    • Spam Folder (مثل "Spam"، "Junk")
    • Archive Folder (مثل "Archive")
  7. انقر Save
تلميح

إذا تركت تخطيطات المجلدات فارغة، ستحاول الوحدة اكتشافها تلقائيًا.

الطريقة 2: إعدادات IMAP العامة (احتياطية)

إذا لم يتم تكوين إعدادات لكل موظف، ستستخدم الوحدة الإعدادات العامة:

  1. انقر على قائمة Setup في Perfex وحدد قسم Settings
  2. انتقل إلى الأسفل وابحث عن Mailbox Settings
  3. انقر عليه واملأ التفاصيل المطلوبة بناءً على إعدادات مقدم البريد الخاص بك.

التفاصيل الإلزامية:

  • IMAP Server (مثل imap.gmail.com)
  • Encryption Method (عادةً SSL)
  • Folder (المجلد المستخدم للمراقبة - عادةً "Inbox")
  • Check Every (تواتر مهمة جلب البريد، بالدقائق)

يمكنك اختياريًا تغيير بعض الخيارات المباشرة المستخدمة لتشغيل الوحدة في نفس الشاشة. تأكد من استخدام الإعدادات الصحيحة لمقدم الخدمة - التفاصيل غير الصحيحة ستمنع الاتصال الناجح.

3. تكوين التفضيلات الشخصية​

في صفحة Mailbox Config، يمكنك أيضًا تكوين:

  • Import Only Unread Emails: تفعيل لجلب البريد غير المقروء فقط (مزامنة أسرع)
  • Enable HTML Rendering: تفعيل لعرض البريد بـ HTML مع التنسيق
  • Auto-mark as Read on Preview: تحديد البريد كمقروء تلقائيًا عند العرض في لوحة المعاينة أو العرض الفردي
  • Sync Read Status to Email Server: مزامنة حالة القراءة مرة أخرى إلى خادم IMAP (يبقِي Gmail/Outlook متزامنين، لكن أبطأ)
معلومات

"Sync Read Status to Email Server" مفيد إذا أردت أن يبقى صندوق وارد Gmail/Outlook متزامنًا مع Perfex. عند التفعيل، قراءة البريد في Perfex ستحددها كمقروءة على خادم البريد.

4. أنت جاهز!​

بعد حفظ الإعدادات، ستحاول وحدة Mailbox الاتصال بصندوق الوارد، طالما أن مهام cron لـ Perfex CRM تعمل بشكل صحيح.

تلميح

يمكنك التحقق من عمل cron عن طريق التحقق من تنفيذ المهام المجدولة أو نشاط مزامنة الوحدة. يمكنك أيضًا استخدام زر Manual Sync في Settings → Mailbox Settings لاختبار الاتصال على الفور.

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

  • عند الاتصال الأول، إذا كان صندوق الوارد يحتوي على عدد كبير من البريد غير المقروء، سيتم استيرادها جميعًا إلى الوحدة وتخزينها في قاعدة بيانات Perfex.
  • هذا طبيعي تمامًا - وقد تستغرق المزامنة الأولية بضع دقائق.
  • إذا كان الخادم لديه موارد محدودة، قد يؤدي ذلك إلى انتهاء وقت مؤقت أثناء عملية المزامنة. انتظر ببساطة وقم بالتحديث بعد قليل.
  • مستخدمو OAuth: يتم تحديث tokens OAuth تلقائيًا قبل انتهاء الصلاحية. إذا رأيت أخطاء اتصال، جرّب قطع الاتصال وإعادة ربط حساب OAuth.
  • مستخدمو كلمة المرور: بالنسبة لـ Gmail و Outlook، قد تحتاج لاستخدام App Password بدلاً من كلمة مرورك العادية إذا تم تفعيل 2FA. راجع قسم Troubleshooting للتفاصيل.