--- title: "Kết nối hòm thư IMAP/SMTP" description: "Nối một hòm thư IMAP/SMTP vào console CloudFly Helpdesk: đoán cấu hình theo tên miền, sửa cổng và TLS khi cần, rồi thử kết nối trước khi lưu." updated: "2026-08-28" audience: [agent, administrator] source: "https://helpdesk-docs.svr1.feedapp.click/kenh/ket-noi-email" --- Console đọc và gửi thư qua IMAP/SMTP ở mục **Email**. Hòm thư được nối ở đó, không phải trong trình tạo kênh: màn hình **Chọn kênh** không có ô email. ## Mục tiêu [#mục-tiêu] Một hòm thư nối xong trong console: bạn đọc được thư đến và gửi được thư đi mà không rời cửa sổ làm việc. ## Trước khi bắt đầu [#trước-khi-bắt-đầu] * Địa chỉ thư và mật khẩu của chính hòm thư đó. * Mật khẩu ứng dụng, nếu nhà cung cấp yêu cầu. Khi đó mật khẩu tài khoản luôn bị từ chối. * Tên máy chủ IMAP và SMTP cùng số cổng, phòng khi console đoán sai theo tên miền. * Máy chủ thư phải có địa chỉ công khai. Địa chỉ nội bộ bị chặn ở phía máy chủ. > **Cảnh báo:** Hòm thư này thuộc về **một người**, không phải cả đội. Nó không sinh hội thoại > trong hàng đợi chung và không xuất hiện ở danh sách **Kênh**. Đồng nghiệp > không đọc được thư của bạn, và vai trò quản trị viên cũng không mở được hòm > thư của người khác. ## Các bước [#các-bước] 1. Ở cột trái bấm **Email**. Chưa nối hòm thư nào thì màn hình hiện **Chưa kết nối hộp thư nào**. 2. Bấm **Kết nối hộp thư**. Biểu mẫu kết nối mở ra ngay trong khung nội dung. ![Thẻ Kết nối hộp thư với ô Tài khoản email, ô Mật khẩu, đường mở Cài đặt nâng cao và hai nút Kiểm tra kết nối, Đăng nhập ở dưới](https://helpdesk-docs.svr1.feedapp.click/images/docs/kenh/ket-noi-email/02-bieu-mau-ket-noi-hop-thu.vi.webp) *Biểu mẫu kết nối hòm thư, trước khi mở phần cài đặt nâng cao.* 3. Điền địa chỉ vào **Tài khoản email**. Console đoán máy chủ theo tên miền và nói rõ đó là phỏng đoán. 4. Nhập mật khẩu vào **Mật khẩu**. Nhà cung cấp nào đòi mật khẩu ứng dụng thì con đường duy nhất là dán mật khẩu ứng dụng vào đây. 5. Phỏng đoán sai thì mở **Cài đặt nâng cao** và sửa **Máy chủ đến**, **Cổng IMAP**, **Máy chủ đi**, **Cổng SMTP**. 6. Đặt hai công tắc **Dùng TLS** cho khớp cổng: bật ở cổng 993 và 465, tắt ở cổng 143 và 587. 7. Điền **Tên đăng nhập** nếu nhà cung cấp đòi khác địa chỉ thư, và **Tên hiển thị** cho tên đứng trên thư bạn gửi. 8. Bấm **Kiểm tra kết nối**. Hai dòng **Thư đến (IMAP)** và **Thư đi (SMTP)** báo kết quả của từng chiều. 9. Cả hai dòng đều đạt thì bấm **Đăng nhập**. Console mở hòm thư và bắt đầu đồng bộ. > **Lưu ý:** Việc đồng bộ thư chạy trong một tiến trình nền và **chỉ được bật trên đúng > một tiến trình**, qua biến môi trường `MAIL_SYNC_ENABLED`. Nhân bản dịch vụ > API mà quên điều này thì nhiều tiến trình cùng đăng nhập một hòm thư mỗi > phút. Đây là phần vận hành, mô tả trong tệp `README.md` của bản cài đặt. ## Kiểm chứng [#kiểm-chứng] Sau khi bấm **Đăng nhập**, cây thư mục của hòm thư hiện ra ở cột trái của mục **Email** và thư trong hộp đến bắt đầu chảy về sau ít phút. Gửi cho chính mình một thư từ hòm thư đó bằng nút soạn thư. Thư gửi được nghĩa là chiều SMTP chạy; thư quay lại hộp đến nghĩa là chiều IMAP cũng chạy. ## Sự cố thường gặp [#sự-cố-thường-gặp] | Hiện tượng | Nguyên nhân | Cách xử lý | | ------------------------------------------------------ | ------------------------------------------------ | --------------------------------------------------------------------- | | Báo máy chủ từ chối tên đăng nhập và mật khẩu | Nhà cung cấp đòi mật khẩu ứng dụng | Tạo mật khẩu ứng dụng rồi dán vào ô **Mật khẩu** | | Báo không phân giải được tên máy chủ | Gõ nhầm tên máy chủ trong **Cài đặt nâng cao** | Kiểm tra lại từng ký tự của tên máy chủ | | Báo máy chủ này không được phép kết nối tới địa chỉ đó | Địa chỉ trỏ vào mạng nội bộ, bị chặn có chủ đích | Dùng tên máy chủ công khai của nhà cung cấp | | Báo không có gì lắng nghe ở cổng đó | Sai số cổng | Đặt lại 993 hoặc 143 cho IMAP, 465 hoặc 587 cho SMTP | | Báo cổng và thiết lập TLS không khớp | Công tắc **Dùng TLS** ngược với cổng | Bật TLS ở 993 và 465, tắt ở 143 và 587 | | Nối xong nhưng không thư nào về | Đồng bộ chưa được bật ở tiến trình nào | Nhờ người triển khai bật `MAIL_SYNC_ENABLED` trên đúng một tiến trình | | Không thấy hòm thư của đồng nghiệp | Hòm thư gắn với một người theo thiết kế | Nhờ chính người đó chuyển tiếp thư cần xử lý chung | ## Tiếp theo [#tiếp-theo] * [Các kênh được hỗ trợ](/kenh) * [Theo dõi và khắc phục kênh mất kết nối](/kenh/suc-khoe-ket-noi) * [Hộp thư chung và kênh kết nối](/khai-niem/inbox-va-kenh)