Cách kết nối SupportCandy với Microsoft Exchange qua DavMail

Các phiên bản hiện đại của SupportCandy đã loại bỏ “Local Exchange” trình kết nối cũ và giờ chỉ cung cấp ba tùy chọn piping—Basic IMAP, Gmail API và Microsoft Exchange API12. Nếu hộp thư của bạn nằm trên Exchange tại chỗ, Exchange hybrid hoặc tenant Office 365 nơi tuyến Exchange API bị chặn hoặc cần đăng ký Azure phức tạp, bạn vẫn có thể đưa mọi email hỗ trợ thẳng vào WordPress: chạy DavMail làm cầu IMAP và để SupportCandy dùng nó như bất kỳ máy chủ thư nào khác.

Dưới đây là hướng dẫn từng bước đầy đủ, tối ưu SEO, bạn có thể sao chép và dán vào blog công nghệ của mình.

Vì sao chọn DavMail?

1. Chuyển đổi giao thức – DavMail nói EWS/OWA ở phía sau và mở các cổng tiêu chuẩn (IMAP, POP, SMTP, CalDAV, LDAP) ở phía trước3.
2. Hoạt động với MFA & Modern Auth – Chế độ O365Modern và O365Interactive đăng nhập qua OAuth2, nên các tenant Office 365 dùng MFA vẫn được hỗ trợ45.
3. Chạy ở mọi nơi – Ứng dụng Java; chạy trên Windows, macOS, Linux hoặc trong vùng chứa Docker/LXC.
4. Giữ SupportCandy đơn giản – SupportCandy chỉ thấy “localhost:1143” (hoặc 993 nếu bạn bật SSL) và nhập ticket qua màn hình IMAP quen thuộc6.

Điều kiện tiên quyết

Thành phần	Phiên bản tối thiểu	Ghi chú
WordPress	5.6+	SupportCandy yêu cầu7.
SupportCandy Core	3.x	Cộng thêm Email Piping tiện ích bổ sung.
Java Runtime	8+	Cần để chạy DavMail.
Exchange	2007+ (EWS) hoặc Office 365	URL OWA/EWS phải truy cập được từ máy chủ DavMail4.

Bước 1 – Tải & cài đặt DavMail

Windows

1. Tải bộ cài từ SourceForge (davmail-win64.exe).
2. Chạy với quyền Administrator; giữ các cổng mặc định (1143 IMAP, 1025 SMTP, 1080 CalDAV, v.v.) cho thiết lập trên máy trạm3.

Linux (dịch vụ toàn hệ thống)

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

Bước 2 – Cấu hình DavMail

Mở davmail.properties (GUI → Settings… hoặc /etc/davmail.properties).

Các mục cần thiết:

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

Lưu & khởi động lại DavMail.

Kiểm tra bằng Telnet:

bashtelnet localhost 1143
* OK IMAP4rev1 DavMail server ready

Bước 3 – Tăng cường bảo mật với SSL (tùy chọn nhưng nên làm)

1. Tạo keystore PKCS#12 hoặc nhập chứng chỉ 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. Thêm vào 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. Khởi động lại và kiểm tra lại: openssl s_client -connect localhost:993.

Bước 4 – Trỏ SupportCandy tới DavMail

1. Support → Settings → Email Piping → IMAP.
2. Điền vào biểu mẫu:

textEmail 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 giờ sẽ lấy mọi thư đến hộp thư Exchange và biến chúng thành ticket. Lưu ý rằng tài liệu ghi Exchange “không được phép” qua IMAP cơ bản6; DavMail lách được điều đó vì phía Exchange dùng EWS còn SupportCandy chỉ thấy IMAP tiêu chuẩn.

Bước 5 – Chạy DavMail như một dịch vụ

Ví dụ 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

Bảng tóm tắt xử lý sự cố

Triệu chứng	Nguyên nhân có thể	Cách khắc phục
Cổng đã được dùng trong log DavMail9	Tiến trình khác (hoặc phiên DavMail trước) đang chiếm 1143/1025	fuser -k -n tcp 1143 rồi khởi động lại dịch vụ.
Broken pipe hoặc timeout khi thư lớn10	Exchange giới hạn tần suất hoặc client nhàn rỗi	Tăng davmail.timeout (ms) trong tệp properties lên 120000.
Vòng lặp MFA trên O365	Dùng EWS trên tenant đã bật xác thực hiện đại	Chuyển sang O365Modern hoặc O365Interactive5.
SupportCandy không lấy được gì	Sai cổng/mã hóa	Khớp 1143→None hoặc 993→SSL. Kiểm tra thông tin đăng nhập hộp thư.
Email bị trùng hoặc không được đánh dấu đã đọc	Đặt “Leave a copy on server” trong SupportCandy thành tắt và bật “Mark message read after fetch”.

Kết luận

Cho đến khi SupportCandy giới thiệu lại trình kết nối Exchange on-prem chính hãng, DavMail là giải pháp thay thế nhanh nhất, không tốn chi phí để giữ hộp thư Microsoft Exchange hoặc Office 365 của bạn chảy vào WordPress. Kết hợp với khả năng quản lý ticket mạnh mẽ của SupportCandy và cổng tương thích OAuth của DavMail, bạn có tự động hóa helpdesk cấp doanh nghiệp không cần phí SaaS trả tiền hay quyền Azure phức tạp.

Cắm vào, bảo vệ nó, và để các tác nhân của bạn tập trung giải quyết ticket—không phải vật lộn với Exchange API.

Chúc kết nối vui vẻ!