استكشاف الأخطاء وإصلاحها
إذا كنت تواجه مشاكل في الاتصال بحساب بريدك الإلكتروني أو مزامنة البريد، اتبع قائمة التحقق هذه للتحقق من المشكلات الشائعة وحلها.
1. تحقق من سجل النشاط
انتقل إلى Utilities → Activity Log داخل Perfex CRM لعرض أي رسائل خطأ تتعلق بفشل اتصال IMAP أو المزامنة.
2. تفعيل وضع التصحيح
للحصول على إخراج خطأ أكثر تفصيلاً:
- افتح
index.phpفي جذر تثبيت Perfex CRM - حدد السطر:
define('ENVIRONMENT', 'production');
- غيّره إلى:
define('ENVIRONMENT', 'development');
- احفظ الملف وأعد تحميل الصفحة لرؤية رسائل الخطأ الخام
لا تنسَ تغييره مرة أخرى إلى production بعد الاختبار!
3. فحص سجلات أخطاء الاستضافة
إذا أصبحت الشاشة فارغة أو لم تظهر أي أخطاء في Perfex:
- انتقل إلى لوحة تحكم الاستضافة (مثل cPanel أو Plesk)
- ابحث عن "Error Log"، عادةً في قسم "Metrics" أو "Logs"
- افحص أخطاء حديثة مثل "memory exhausted" أو "timeout" أو مشاكل متعلقة بـ IMAP
4. تحقق مرة أخرى من إعداد Cron
تأكد من تشغيل مهام cron. بدونها، لا يمكن لوحدة Mailbox مزامنة البريد الإلكتروني.
راجع توثيق Perfex CRM أو مسؤول الخادم لاستكشاف مشاكل cron.
5. OAuth مقابل المصادقة بكلمة المرور
تدعم وحدة Mailbox طريقتين للمصادقة:
مصادقة OAuth2 (موصى بها)
لمستخدمي Gmail و Outlook، OAuth2 هي الطريقة الموصى بها. إنها أكثر أمانًا ولا تتطلب تخزين كلمات المرور.
مشاكل OAuth الشائعة:
| المشكلة | الحل |
|---|---|
| "OAuth connection failed" | تحقق من بيانات اعتماد OAuth في Setup → Settings → Mailbox Settings. تحقق من تكوين redirect URI. تأكد من أن تطبيق OAuth لديه النطاقات المطلوبة. |
| "Token expired" | يتم تحديث tokens OAuth تلقائيًا. جرّب قطع الاتصال وإعادة الاتصال. بالنسبة لـ Gmail: تنتهي صلاحية tokens بعد 7 أيام للتطبيقات غير المُتحقق منها. |
| "OAuth not available" | OAuth متاح فقط لـ Gmail و Outlook. استخدم مصادقة كلمة المرور لمقدمي خدمات البريد الآخرين. |
مصادقة كلمة المرور
لمقدمي البريد الإلكتروني الذين لا يدعمون OAuth2، استخدم مصادقة كلمة المرور.
تحقق مما إذا كان مقدم البريد يحتاج إلى كلمة مرور التطبيق
يتطلب بعض مقدمي البريد الإلكتروني مثل Gmail و Yahoo و Outlook استخدام كلمة مرور التطبيق بدلاً من كلمة مرور حساب البريد الفعلية - خاصةً إذا تم تفعيل 2FA (المصادقة الثنائية).
مثال: مستخدمو Gmail
- انتقل إلى https://myaccount.google.com/security
- قم بتفعيل 2-Step Verification إذا لم يكن مفعلاً
- في قسم "Signing in to Google"، حدد App Passwords
- أنشئ كلمة مرور تطبيق جديدة لـ "Mail"
- استخدم هذه الكلمة في Mailbox Config للوحدة بدلاً من كلمة مرور Gmail العادية
عدم استخدام كلمة مرور التطبيق عند الحاجة سيؤدي إلى أخطاء مصادقة أو محاولات تسجيل دخول محظورة.
بالنسبة لـ Gmail و Outlook، نوصي بشدة باستخدام OAuth2 بدلاً من كلمات مرور التطبيق لأمان أفضل وسهولة استخدام. راجع Gmail OAuth Setup أو Outlook OAuth Setup.
6. الإعدادات لكل موظف مقابل الإعدادات العامة
تدعم الوحدة كلاً من إعدادات IMAP لكل موظف والعامة:
- إعدادات لكل موظف: يمكن لكل موظف تكوين خادم IMAP والمنفذ والتشفير وتخطيطات المجلدات الخاصة به
- الإعدادات العامة: إعدادات احتياطية تُستخدم عندما لا يتم تكوين إعدادات لكل موظف
إذا لم تتم مزامنة البريد الإلكتروني:
- تحقق من صفحة Mailbox Config للإعدادات لكل موظف
- تحقق من صحة خادم IMAP والمنفذ والتشفير
- تحقق من تخطيطات المجلدات (خاصةً إذا كنت تستخدم أسماء مجلدات غير قياسية)
- راجع سجل النشاط لرسائل الخطأ المحددة
7. مشاكل مزامنة حالة القراءة
إذا قمت بتفعيل "Sync Read Status to Email Server" لكن التغييرات لا تنعكس في Gmail/Outlook:
- الرسائل القديمة: قد لا تحتوي الرسائل المستوردة قبل الإصدار 2.1.7 على UID مخزن. لن تتم مزامنة حالة القراءة إلا للرسائل الجديدة.
- UID مفقود: تحقق من سجل النشاط لرسائل "Email ID XXX has no UID stored" (هذا طبيعي للرسائل القديمة).
- يتطلب OAuth: تعمل مزامنة حالة القراءة بشكل أفضل مع مصادقة OAuth.
- المزامنة اليدوية: استخدم زر Manual Sync في Settings لاختبار الاتصال.
لا تزال بحاجة إلى مساعدة؟
إذا كنت عالقًا أو غير قادر على حل المشكلة، فريق الدعم لدينا هنا للمساعدة. يرجى فتح تذكرة عبر Themesic Support Portal، وسنساعدك في أقرب وقت ممكن.