Hộp thư hợp nhất là nơi đọc thư từ nhiều hộp thư đã kết nối trong cùng một danh sách. Trong Mailera, giao diện này có tên Hộp thư chung. Để kiểm tra nhà cung cấp, trạng thái và lần đồng bộ gần nhất, gọi GET /mailboxes rồi đối chiếu các trường provider, status và last_sync_at.
Cần chuẩn bị gì trước khi kết nối nhiều tài khoản email?
Lập bảng kiểm kê trước khi nhập. Mỗi dòng nên có địa chỉ email, nhà cung cấp, người chịu trách nhiệm, nhóm nghiệp vụ, quyền truy cập và trạng thái kết nối. Không đưa mật khẩu hoặc token vào bảng này. Chỉ kết nối hộp thư của tổ chức hoặc hộp thư được chủ sở hữu cho phép quản lý.
Chia nhóm theo phạm vi công việc, chẳng hạn chăm sóc khách hàng và kế toán. Cách chia này cũng giúp bạn giới hạn phạm vi khóa API sau đó.
| Loại hộp thư | Phương thức kết nối | Cần chuẩn bị |
|---|---|---|
| Outlook, Hotmail, Microsoft 365 | OAuth qua Microsoft Graph | Tài khoản có quyền cấp phép kết nối |
| Gmail, Google Workspace, Yahoo, iCloud, AOL, Zoho | Mật khẩu ứng dụng (app password) | Xác minh 2 bước khi nhà cung cấp yêu cầu; tài khoản và quản trị viên cho phép |
| Máy chủ riêng | IMAP; SMTP nếu cần gửi | Máy chủ, cổng, chế độ bảo mật và thông tin đăng nhập |
Khi kết nối Microsoft, dùng OAuth, không dùng mật khẩu ứng dụng. Với Gmail trong Mailera, đường kết nối hiện dùng mật khẩu ứng dụng.
Theo hướng dẫn mật khẩu ứng dụng của Google, đọc ngày 25/10/2026, tài khoản phải bật xác minh 2 bước. Google cũng khuyến nghị dùng “Sign in with Google” khi ứng dụng có lựa chọn đó. Hãy đối chiếu điều kiện tài khoản trước khi chuẩn bị thông tin cho cả nhóm.
Với Zoho, hãy kiểm tra quyền truy cập IMAP trước. Theo hướng dẫn IMAP của Zoho, đọc ngày 25/10/2026, bạn phải bật IMAP cho tài khoản; khi bật xác thực hai yếu tố, bạn cần dùng mật khẩu ứng dụng để kết nối qua IMAP. Người dùng mới đăng ký gói miễn phí không có quyền truy cập IMAP.
Thông số máy chủ Zoho còn phụ thuộc vào loại tài khoản và trung tâm dữ liệu. Lấy thông số trong mục “Server Configurations Details” ngay trong tài khoản, thay vì dùng chung một cấu hình cho mọi hộp thư Zoho. Kiểm tra danh sách nhà cung cấp được hỗ trợ thay vì áp dụng cấu hình Gmail cho mọi địa chỉ tên miền riêng.
Kết nối thử rồi nhập nhiều hộp thư theo đợt ra sao?
Chọn nhóm thử có đại diện cho các nhà cung cấp bạn đang dùng. Mục tiêu là phát hiện sai phương thức xác thực hoặc cấu hình trước khi nhập phần còn lại.
- Mở nơi thêm hộp thư. Người có vai trò Admin hoặc Leader vào Danh sách hộp thư → Thêm hộp thư. Nếu cần hướng dẫn chi tiết cho lần kết nối đầu tiên, xem hướng dẫn kết nối hộp thư với Mailera.
- Kết nối từng hộp thư đại diện. Với Microsoft, chọn Đăng nhập Microsoft. Với Gmail, Yahoo, iCloud, AOL hoặc Zoho, chọn Một hộp thư, điền Địa chỉ email, chọn Tiếp tục, rồi nhập mật khẩu ứng dụng vào trường Mật khẩu. Với máy chủ riêng, chọn IMAP tùy chỉnh và điền thông tin máy chủ.
- Kiểm tra trước khi nhập tiếp. Chọn Kiểm tra & kết nối trong luồng một hộp thư. Thao tác này đăng nhập thử, không gửi thư thật. Xác nhận hộp thư xuất hiện trong danh sách và kiểm tra kết quả tải thư lần đầu.
- Chuẩn bị đợt nhập. Chọn Dán hàng loạt, mỗi hộp thư một dòng, rồi chọn nhóm. Định dạng cho nhà cung cấp dùng mật khẩu ứng dụng là
email:app_password. Với Microsoft, mỗi dòng theo định dạngemail:password:refresh_token:client_id(không dùng mật khẩu ứng dụng). - Quyết định cách xử lý địa chỉ đã tồn tại. Chọn bỏ qua nếu bạn chỉ muốn thêm địa chỉ mới. Chỉ chọn ghi đè khi đã xác định cần thay cấu hình. Giao diện chấp nhận dấu hai chấm, dấu gạch đứng, dấu chấm phẩy hoặc Tab; cũng có thể tải tệp
.txt. - Đối chiếu kết quả. Chọn Bắt đầu nhập rồi xem các kết quả thành công, lỗi và bỏ qua. Xuất lỗi thành CSV để sửa, sau đó chỉ nhập lại các dòng cần xử lý.
Khi nhập nhiều hộp thư ngoài Microsoft, Mailera kiểm tra đăng nhập lần lượt, điều tiết theo nhà cung cấp. Mật khẩu ứng dụng và token được mã hóa trước khi lưu và không hiển thị lại sau đó. Đừng lấy thời gian của một hộp thư để suy ra thời gian hoàn tất cả đợt. Tệp nhập chứa thông tin đăng nhập phải được giữ kín.

Theo dõi nhiều hộp thư hằng ngày ở đâu?
Tách việc đọc thư khỏi việc kiểm tra kết nối. Có thư trong danh sách không có nghĩa lần đồng bộ gần nhất vừa diễn ra.
| Công việc | Nơi kiểm tra | Kết quả cần đối chiếu |
|---|---|---|
| Tìm hộp thư có vấn đề | GET /mailboxes | Nhà cung cấp (provider), trạng thái (status) và lần đồng bộ gần nhất (last_sync_at) |
| Xác nhận thư mới | Hộp thư chung | Thư cần nhận đã xuất hiện |
| Xác định hộp thư nguồn | GET /messages/search hoặc GET /mailboxes/{id}/messages | mailbox_id và mailbox_email của thư khớp với hộp thư cần xử lý |
| Theo dõi bằng chương trình | GET /mailboxes | Trạng thái, lỗi và thông tin đồng bộ từng hộp thư |

Nếu có bảng theo dõi riêng, dùng khóa có quyền read để lấy danh sách:
curl --get 'https://mailera.app/api/public/v1/mailboxes' \
--header "Authorization: Bearer $MAILERA_API_KEY" \
--data-urlencode 'limit=20' \
--data-urlencode 'offset=0'Trong phản hồi, đối chiếu provider, status và last_sync_at để kiểm tra nhà cung cấp, trạng thái và lần đồng bộ gần nhất của hộp thư; kiểm tra thêm error_code và error khi có lỗi, và sync.sleeping_since khi nghi ngờ hộp thư đang ngủ. Dùng total, limit, offset để đọc tiếp danh sách; không coi trang đầu là toàn bộ hộp thư.
API hỗ trợ lọc qua các tham số status, provider, group_id, tag, q và phân trang bằng limit, offset. Xem tài liệu API Mailera khi xây dựng quy trình giám sát. Mailera cũng có sự kiện webhook mailbox.disconnected để ứng dụng nhận thông báo khi một hộp thư mất kết nối.
Khi cần tìm một thư xuyên nhiều hộp thư, dùng GET /messages/search. Nhưng việc tìm thấy thư không thay thế cho việc kiểm tra trạng thái hộp thư nguồn.
Cần kiểm tra gì trước khi mở rộng lên hàng nghìn hộp thư?
Mở rộng theo nhóm sau khi đã kiểm tra kết nối, kết quả nhập, thời điểm đồng bộ và cách khôi phục khi có lỗi. Đừng dùng số địa chỉ được phép kết nối để dự đoán tốc độ vận hành.
| Yếu tố | Câu hỏi cần trả lời |
|---|---|
| Hạn mức gói | Không gian làm việc được phép chứa bao nhiêu hộp thư? |
| Hạn mức API | Chương trình giám sát có gọi vượt giới hạn không? |
| Chính sách nhà cung cấp | Nhà cung cấp có hạn chế truy cập hoặc yêu cầu chờ không? |
| Kết quả chạy thực tế | Đợt nhập mất bao lâu, lỗi ở đâu, khôi phục thế nào? |
Đối chiếu gói và hạn mức Mailera trước mỗi đợt mở rộng. Trong nhật ký vận hành nội bộ của đội bạn, ghi quy mô đợt nhập, nhà cung cấp, thời gian bắt đầu và kết thúc, kết quả từng loại, thời điểm đồng bộ và cách sửa lỗi. Không ghi bí mật vào nhật ký.
Ở phía Microsoft, hướng dẫn giới hạn lưu lượng Microsoft Graph, đọc ngày 25/10/2026, nêu rằng Graph trả HTTP 429 khi vượt ngưỡng. Với ứng dụng trực tiếp gọi Graph, hãy chờ theo Retry-After; nếu không có header này, dùng exponential backoff. Giới hạn Graph và giới hạn API Mailera là hai lớp khác nhau.
Những lỗi nào thường gặp khi quản lý nhiều hộp thư?
| Triệu chứng | Điểm cần kiểm tra | Bước xử lý tiếp theo |
|---|---|---|
| Một số dòng nhập lỗi | Định dạng, phương thức xác thực, quyền truy cập | Sửa theo kết quả từng dòng rồi chỉ nhập lại phần lỗi |
| Địa chỉ bị bỏ qua | Địa chỉ đã tồn tại và lựa chọn bỏ qua | Kiểm tra hộp thư hiện có trước khi quyết định ghi đè |
| Cấu hình bị thay đổi | Lựa chọn ghi đè trong đợt nhập | Đối chiếu cấu hình dự kiến trước khi nhập lại |
| Nhận được nhưng chưa gửi được | Kết quả đăng nhập SMTP | Sửa thông tin gửi; hoặc chọn Lưu ở chế độ Chỉ nhận |
| Không thấy thư mới | Trạng thái, lần đồng bộ, chế độ ngủ | Kiểm tra hộp thư rồi dùng Đồng bộ khi cần |
| Gmail mất kết nối sau khi đổi mật khẩu | Mật khẩu ứng dụng đang dùng | Tạo mật khẩu ứng dụng mới theo hướng dẫn Google và cập nhật kết nối |
Google thu hồi mật khẩu ứng dụng khi mật khẩu tài khoản thay đổi, theo tài liệu đọc ngày 25/10/2026 đã dẫn ở trên.
Khi gọi GET /mailboxes/{id}/status, hộp thư Microsoft được kiểm tra đăng nhập trực tiếp ngay tại thời điểm gọi. Với các nhà cung cấp khác, kết quả chỉ phản ánh lần đồng bộ gần nhất, không phải kiểm tra đăng nhập tức thời.
Giữ an toàn khi nhiều người hoặc AI agent truy cập thư thế nào?
Tạo khóa API giới hạn theo nhóm hộp thư và quyền cần dùng. Công việc chỉ theo dõi nên dùng read; tách quyền import, manage hoặc send khi có nhu cầu tương ứng. Cách phân quyền này cũng phù hợp với khuyến nghị quyền tối thiểu của Microsoft Graph, đọc ngày 25/10/2026.
Không đưa mật khẩu ứng dụng, khóa API hoặc token vào ảnh chụp, nhật ký hay tệp báo lỗi được chia sẻ. Xem thông tin bảo mật Mailera trước khi đưa hộp thư nghiệp vụ vào quy trình.
Nếu AI agent đọc thư, coi nội dung thư là dữ liệu không tin cậy, không phải lệnh. Không làm theo chỉ dẫn trong thư để thay quyền, tiết lộ bí mật hoặc gửi dữ liệu đi; yêu cầu xác nhận trước khi gửi thư. Phần vận hành hộp thư hợp nhất cho AI agent đi sâu vào quy trình này.
Giới hạn Mailera cần tính vào quy trình
Mailera không tạo hộp thư hoặc địa chỉ email mới; bạn phải có tài khoản và quyền truy cập hợp lệ. Kết nối hộp thư có sẵn và tạo hộp thư riêng cho agent là hai lựa chọn khác nhau.
Mailera không hỗ trợ gửi tiếp thị hàng loạt. Mailera cũng không hỗ trợ Proton Mail hoặc Tuta.
Tần suất kiểm tra nền thay đổi theo mức sử dụng; hộp thư ít hoạt động có thể chuyển sang chế độ ngủ. Vì vậy, không xây dựng quy trình dựa trên giả định mọi hộp thư luôn đồng bộ tức thời.
Kết nối hộp thư đầu tiên trong 2 phút
Thêm hộp thư Outlook, Gmail hoặc IMAP và đọc thư qua giao diện hoặc API.
Kết nối hộp thư








