ربط SupportCandy بـ Microsoft Exchange عبر DavMail

الإصدارات الحديثة من SupportCandy أزالت “Local Exchange” الموصل القديم، وأصبحت توفر ثلاثة خيارات فقط لسحب البريد—Basic IMAP وGmail API وMicrosoft Exchange API12. وإذا كانت صناديق بريدك على Exchange محلي أو Exchange هجين أو مستأجري Office 365 حيث يكون مسار Exchange API محظورًا أو يتطلب تسجيلًا معقدًا في Azure، فلا يزال بإمكانك جلب كل رسائل بريد الدعم مباشرة إلى WordPress: شغّل DavMail كجسر IMAP ودع SupportCandy يستهلكه كأي خادم بريد آخر.

فيما يلي دليل كامل خطوة بخطوة محسّن لمحركات البحث يمكنك نسخه ولصقه في مدونتك التقنية.

لماذا DavMail؟

1. ترجمة البروتوكولات – يتحدث DavMail لغة EWS/OWA في الخلفية ويعرض منافذ قياسية (IMAP وPOP وSMTP وCalDAV وLDAP) في الواجهة3.
2. يعمل مع MFA & المصادقة الحديثة – يتم تسجيل الدخول في وضعي O365Modern و O365Interactive عبر OAuth2، لذا يُغطّى مستأجرو Office 365 الذين يستخدمون MFA.45.
3. يعمل في أي مكان – تطبيق Java؛ يعمل على Windows وmacOS وLinux أو داخل حاوية Docker/LXC.
4. يبقي SupportCandy بسيطًا – لا يرى SupportCandy سوى “localhost:1143” (أو 993 إذا فعّلت SSL) ويستورد التذاكر عبر شاشة IMAP المألوفة6.

المتطلبات الأساسية

المكوّن	أدنى إصدار	ملاحظات
WordPress	5.6+	يتطلبه SupportCandy7.
SupportCandy Core	3.x	بالإضافة إلى إضافة Email Piping .
بيئة تشغيل Java	8+	مطلوبة لتشغيل DavMail.
Exchange	2007+ (EWS) أو Office 365	يجب أن يكون عنوان URL الخاص بـ OWA/EWS قابلاً للوصول من المضيف الذي يعمل عليه DavMail4.

الخطوة 1 – تنزيل DavMail & تثبيته

Windows

1. نزّل المثبّت من SourceForge (davmail-win64.exe).
2. شغّله كمسؤول؛ واترك المنافذ الافتراضية (1143 IMAP، 1025 SMTP، 1080 CalDAV، إلخ) لإعداد محطة عمل3.

Linux (خدمة على مستوى النظام)

bashsudo apt install davmail
sudo systemctl enable davmail

Docker one-liner

bashdocker run -d \
  -e DAVMAIL_URL=https://outlook.office365.com/EWS/Exchange.asmx \
  -e DAVMAIL_MODE=O365Modern \
  -p 1143:1143 -p 1025:1025 \
  --name davmail gatewayapps/davmail

الخطوة 2 – إعداد DavMail

فتح davmail.properties (الواجهة الرسومية → الإعدادات… أو /etc/davmail.properties).

الإدخالات الأساسية:

text# Talk to Exchange
davmail.url=https://outlook.office365.com/EWS/Exchange.asmx   # or on-prem OWA/EWS URL
davmail.mode=O365Modern                                       # O365Modern, O365Interactive or EWS[8][50]

# IMAP gateway
davmail.imapPort=1143                                         # switch to 993 if you want SSL[7]

# Run headless on a server
davmail.server=true

احفظ الإعدادات & أعد تشغيل DavMail.

اختبر باستخدام Telnet:

bashtelnet localhost 1143
* OK IMAP4rev1 DavMail server ready

الخطوة 3 – التحصين باستخدام SSL (اختياري لكن موصى به)

1. أنشئ مخزن مفاتيح PKCS#12 أو استورد شهادة CA8.

bash
keytool -genkey -storetype PKCS12 -keystore /opt/davmail.p12 \
        -keypass CHANGEIT -storepass CHANGEIT \
        -dname "CN=support.example.com,OU=IT,O=Company,L=City,C=US"

2. أضف إلى davmail.properties:

text
davmail.ssl.keystoreType=PKCS12
davmail.ssl.keystoreFile=/opt/davmail.p12
davmail.ssl.keyPass=CHANGEIT
davmail.ssl.keystorePass=CHANGEIT
davmail.imapPort=993            # secure IMAPS
davmail.smtpPort=465            # secure SMTPS[44]

3. أعد التشغيل وأعد الاختبار: openssl s_client -connect localhost:993.

الخطوة 4 – وجّه SupportCandy إلى DavMail

1. الدعم → الإعدادات → Email Piping → IMAP.
2. املأ النموذج:

نصEmail address:  [email protected]
Password:        <mailbox password or app-password>
Incoming server: 127.0.0.1
Port:            1143   (or 993 with SSL)
Encryption:      None   (or SSL)

سيجلب SupportCandy الآن كل بريد يصل إلى صندوق وارد Exchange ويحوّله إلى تذاكر. تذكّر أن الوثائق تنص على أن Exchange “غير مسموح” عبر IMAP الأساسي6؛ يتحايل DavMail على ذلك لأن جانب Exchange هو EWS بينما يرى SupportCandy بروتوكول IMAP القياسي.

الخطوة 5 – تشغيل DavMail كخدمة

مثال Systemd (/etc/systemd/system/davmail.service)

text
[Unit]
Description=DavMail Exchange Gateway
After=network.target

[Service]
ExecStart=/usr/bin/davmail /etc/davmail.properties
SuccessExitStatus=143
Restart=always
User=davmail

[Install]
WantedBy=multi-user.target

bash
sudo systemctl daemon-reload
sudo systemctl start davmail
sudo systemctl enable davmail

ورقة مرجعية لاستكشاف الأخطاء وإصلاحها

العرض	السبب المحتمل	الحل
المنفذ مستخدم بالفعل في سجلات DavMail9	عملية أخرى (أو نسخة سابقة من DavMail) مرتبطة بالمنفذ 1143/1025	fuser -k -n tcp 1143 ثم أعد تشغيل الخدمة.
خطأ Broken pipe أو انتهاء المهلة أثناء الرسائل الكبيرة10	تقييد Exchange أو خمول العميل	زيادة davmail.timeout (ms) في ملف الخصائص إلى 120000.
حلقة MFA في O365	استخدام وضع EWS على مستأجر تُفرض عليه المصادقة الحديثة	بدّل إلى O365Modern أو O365Interactive5.
SupportCandy لا يجلب شيئًا	منفذ أو تشفير خاطئ	طابِق 1143→None أو 993→SSL. تحقّق من بيانات اعتماد صندوق البريد.
تكرار رسائل البريد أو عدم تعليمها كمقروءة	اضبط “Leave a copy on server” في SupportCandy على إيقاف وفعّل “Mark message read after fetch”.

خلاصة القول

إلى أن تعيد SupportCandy إضافة موصل Exchange محلي من تطويرها، فإن DavMail هو أسرع حل بديل مجاني للحفاظ على تدفّق صناديق بريد Microsoft Exchange أو Office 365 إلى WordPress. ومع إدارة التذاكر القوية في SupportCandy وبوابة DavMail المتوافقة مع OAuth، تحصل على أتمتة مكتب مساعدة بمستوى المؤسسات دون رسوم SaaS المدفوعة أو أذونات Azure المعقدة.

وصّله وأمّنه، ودع وكلاءك يركّزون على حل التذاكر—لا على المصارعة مع واجهات Exchange API.

جسرًا موفّقًا!