Quản lý nhiều hộp thư email cho AI: đọc đúng, cấp quyền đủ

Hộp thư hợp nhất có gộp các tài khoản thành một không?

Không. Hộp thư hợp nhất hiển thị thư từ nhiều tài khoản trong một nơi, nhưng mỗi thư vẫn thuộc hộp thư nguồn. Gmail và Outlook không trở thành một tài khoản hay một địa chỉ gửi chung.

Ba khái niệm dễ bị lẫn có mục tiêu khác nhau:

Trong Mailera, mục Hộp thư chung là giao diện quan sát thư từ các hộp thư đã kết nối. MCP và REST API là đường để ứng dụng hoặc AI agent đọc, tìm và thao tác với thư. Tổng quan Mailera mô tả các cách kết nối này; bài dùng email hiện có cho AI agent giải thích cách đưa hộp thư đang dùng vào công việc của agent.

Bạn sẽ đọc và tóm tắt thư trong nhóm hộp thư thử của mình. Mỗi kết quả cần giữ mailbox_id cùng id của thư. Đọc đúng nội dung nhưng làm mất hộp thư nguồn vẫn có thể dẫn đến thao tác sai tài khoản.

Cần chuẩn bị gì trước khi cho AI đọc thư?

Chỉ kết nối hộp thư bạn sở hữu hoặc được uỷ quyền sử dụng. Bắt đầu bằng một nhóm hộp thư thử, chưa cấp quyền gửi. Người thêm hộp thư cần có vai trò Admin hoặc Leader.

Bạn có thể chốt phạm vi theo bảng sau:

Với Outlook và Microsoft 365, chọn OAuth; không dùng mật khẩu ứng dụng. Với Gmail trong Mailera, cách kết nối hiện tại dùng mật khẩu ứng dụng (app password).

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 cần bật xác minh 2 bước. Google khuyến nghị dùng “Sign in with Google” trong phần lớn trường hợp, nhưng Mailera hiện chưa kết nối Gmail theo cách đó. Với Google Workspace, bạn cũng cần kiểm tra quản trị viên có cho phép cách kết nối này không.

Đừng đưa mật khẩu, token hoặc nội dung thư thật vào ảnh chụp hướng dẫn. Dùng thư thử có tiêu đề dễ nhận diện, chẳng hạn thu-thu-agent, để đối chiếu giữa giao diện và API.

Kết nối và kiểm tra giao diện hợp nhất ra sao?

1. Mở Danh sách hộp thư → Thêm hộp thư.
2. Với Microsoft, chọn Đăng nhập Microsoft rồi hoàn tất đăng nhập và chấp thuận quyền tại Microsoft. Với Gmail, chọn Một hộp thư, nhập Địa chỉ email; Mailera sẽ tự nhận diện nhà cung cấp. Nếu chưa nhận diện được, bạn chọn thủ công ở mục Hoặc chọn nhà cung cấp, rồi chọn Tiếp tục.
3. Với Gmail, màn hình sẽ hiện hướng dẫn Cách lấy mật khẩu ứng dụng và mục Cần chuẩn bị, rồi đến Thông tin kết nối. Nhập mật khẩu ứng dụng vào trường Mật khẩu, không nhập mật khẩu đăng nhập thông thường. Bạn có thể điền Tên hiển thị nếu cần, rồi chọn Nhóm quản lý dành cho thử nghiệm.
4. Chọn Kiểm tra & kết nối. Thao tác này kiểm tra kết nối, không gửi email thật. Nếu nhận được nhưng chưa gửi được, bạn có thể chọn Lưu ở chế độ Chỉ nhận cho bài toán đọc và tóm tắt.
5. Trở lại danh sách, kiểm tra số thư chưa đọc trong thư đến và Thư rác của hộp thư. Sau đó mở Hộp thư chung để tìm thư thử.

Nếu cần hướng dẫn từng màn hình, xem bài kết nối hộp thư đầu tiên với Mailera.

Đối chiếu cả hộp thư nguồn, người gửi và tiêu đề, không chỉ xem có một thư trông giống thư thử hay không. Kiểm tra cả thư đến lẫn Thư rác. Danh sách hộp thư có số thư chưa đọc ở từng thư mục này; không thấy thư trong thư đến chưa đủ để kết luận thư chưa tới.

Trước khi nối agent, bạn cần tìm được thư thử và biết nó thuộc hộp thư nào. Chỉ sau đó mới kiểm tra cùng thư qua MCP hoặc REST API.

Cho AI đọc qua MCP hoặc REST API như thế nào?

Tạo khoá giới hạn trước

1. Mở Cài đặt, vào phần khoá API và chọn Tạo key.
2. Đặt Tên gợi nhớ, chọn nhóm thử trong Phạm vi hộp thư. Admin có thể chọn tất cả nhóm, nhưng bài toán này không cần phạm vi đó.
3. Chỉ chọn quyền read, đặt Thời hạn. Có thể dùng Giới hạn IP (tuỳ chọn) nếu môi trường gọi API phù hợp.
4. Lưu khoá ở nơi bảo mật. Khoá mới chỉ được hiển thị một lần.
5. Nếu dùng MCP, chọn Sao chép cấu hình MCP cho Claude, Cursor hoặc VS Code, rồi thêm cấu hình vào ứng dụng tương ứng.

Quyền cần đủ cho nhiệm vụ, không phải đủ cho mọi việc agent có thể làm về sau. Đây cũng là nguyên tắc quyền tối thiểu trong Microsoft Graph, theo tài liệu đọc ngày 25/10/2026.

Với MCP: xác định nguồn rồi mới đọc

Dùng list_mailboxes để xác định các hộp thư, search_messages để tìm thư thử, rồi get_message để đọc nội dung cần tóm tắt. Yêu cầu agent trả kết quả kèm hộp thư nguồn và định danh thư, thay vì chỉ trả một đoạn tóm tắt không rõ nguồn.

Trang kết nối MCP của Mailera trình bày cách tích hợp; bài các công cụ MCP theo từng tác vụ giúp chọn công cụ đúng việc. Không cần cho agent công cụ gửi chỉ để nó đọc thư.

Với REST API: đừng nhầm tìm kiếm với liệt kê

Các lệnh dưới đây dùng $MAILERA_API_KEY chứa khoá chỉ đọc. Dùng cùng khoá này để liệt kê hộp thư, tìm thư và đọc nội dung.

Liệt kê hộp thư để đối chiếu id, email, provider và group_id:

curl --get 'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'limit=20'

Trong mảng data, chọn hộp thư thử theo email, rồi lấy trường id của chính phần tử đó làm giá trị $MAILBOX_ID. Không dùng địa chỉ email thay cho định danh. Để kiểm tra nhà cung cấp, trạng thái và lần đồng bộ gần nhất, đọc provider, status và last_sync_at trong phần tử này.

Gọi GET /messages/search với q=thu-thu-agent bằng khoá chỉ đọc đã dùng để liệt kê hộp thư.

Trong kết quả, kiểm tra mailbox_id, mailbox_email, folder và id. Chọn thư thử có mailbox_id khớp với $MAILBOX_ID, rồi lấy id làm giá trị $MESSAGE_ID. Sau đó đọc nội dung bằng đúng cặp định danh:

curl "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages/$MESSAGE_ID" \
  --header "Authorization: Bearer $MAILERA_API_KEY"

Nội dung nằm trong data.body.text hoặc data.body.html. Chỉ chuyển phần cần thiết sang mô hình AI.

GET /messages/search tìm kiếm xuyên hộp thư; tham số mailbox giúp thu hẹp về một hộp thư. Ngược lại, GET /mailboxes/{id}/messages liệt kê thư của hộp thư được chỉ định. Một giao diện chung không có nghĩa mọi endpoint đều liệt kê tất cả thư.

Dùng thêm from, since và folder khi yêu cầu đã rõ. Danh sách hộp thư phân trang bằng limit và offset; danh sách thư và tìm kiếm dùng cursor, với next_cursor trong phản hồi. Tiếp tục lấy trang khi còn con trỏ, thay vì coi trang đầu là toàn bộ kết quả. Chi tiết endpoint nằm trong tài liệu REST API.

Làm sao tránh gửi nhầm hoặc xử lý lặp?

Bản tóm tắt nên ghi rõ nguồn, chẳng hạn “Hộp thư thử Outlook: thư có tiêu đề thu-thu-agent”. Ở lớp ứng dụng, giữ cả mailbox_id và định danh thư để bước tiếp theo không phải đoán lại nguồn từ tên người gửi hay tiêu đề.

Khi mở rộng sang thao tác ghi, dùng quy trình sau:

1. Nhận nhiệm vụ từ người dùng và xác định hộp thư được phép xử lý.
2. Tìm, đọc thư rồi đối chiếu hộp thư nguồn.
3. Đề xuất hành động nhưng chưa thực hiện.
4. Hiển thị hộp thư gửi, người nhận và toàn bộ nội dung để người dùng xác nhận.
5. Gọi công cụ được cấp quyền cho hành động đã duyệt.
6. Kiểm tra kết quả trước khi đánh dấu công việc hoàn tất.

Cấp quyền theo hành động:

Quyền gửi và khả năng gửi của hộp thư là hai điều kiện riêng. Hộp thư lưu ở chế độ chỉ nhận không trở thành hộp thư gửi được chỉ vì khoá có send. Bạn có thể đối chiếu capabilities.send trong thông tin hộp thư.

Với REST API, POST /mailboxes/{id}/send chọn hộp thư gửi ngay trong đường dẫn và hỗ trợ header Idempotency-Key, với cửa sổ chống lặp 24 giờ. Thiết kế ứng dụng gắn một khoá chống lặp với một yêu cầu gửi cụ thể; đừng tạo yêu cầu mới chỉ vì lần gọi trước chưa trả về kết quả rõ ràng.

Dùng GET /sends/{id} để kiểm tra trạng thái queued, sending, sent, failed hoặc unknown. Nếu trạng thái chưa rõ, đối chiếu trước khi thử lại. Ứng dụng cũng nên lưu dấu công việc theo hộp thư, thư và hành động để tránh tóm tắt hoặc xử lý lại cùng một việc ngoài ý muốn.

Những lỗi hay gặp khi quản lý nhiều hộp thư là gì?

Khi agent không thấy thư, kiểm tra từ phạm vi truy cập và truy vấn trước, rồi mới chuyển sang xác thực và đồng bộ.

Kiểm tra trạng thái đăng nhập của Microsoft được thực hiện trực tiếp; với nhà cung cấp khác, kết quả dựa trên lần đồng bộ gần nhất. Nếu Gmail ngắt kết nối sau khi bạn đổi mật khẩu tài khoản Google, lưu ý Google thu hồi mật khẩu ứng dụng khi đổi mật khẩu, theo hướng dẫn đọc ngày 25/10/2026.

Mailera kiểm tra nền thường xuyên hơn với hộp thư đang dùng, và thưa hơn với hộp thư ít hoạt động. Hộp thư ít hoạt động có thể ngủ rồi thức khi được dùng. POST /mailboxes/{id}/sync kích hoạt đồng bộ và có thể đánh thức hộp thư; không cần thêm quyền này vào khoá chỉ đọc thường trực nếu một công cụ vận hành riêng đảm nhiệm việc đó.

Với Microsoft, Mailera dùng thông báo thay đổi của Microsoft Graph và kiểm tra nền dự phòng. Tài liệu thông báo thay đổi Outlook, đọc ngày 25/10/2026, cũng khuyến nghị ứng dụng có cơ chế phát hiện và khôi phục khi mất thông báo. Vì vậy, khi tìm lỗi, hãy xem cả trạng thái đồng bộ thay vì chỉ kiểm tra kết nối agent.

Bảo vệ agent khỏi chỉ dẫn độc hại trong thư thế nào?

Thư đến là dữ liệu không tin cậy, không phải lệnh điều khiển agent. Một email có thể yêu cầu “bỏ qua chỉ dẫn trước”, tiết lộ khoá hoặc gửi nội dung sang địa chỉ khác. Agent chỉ được đọc những câu đó như nội dung thư.

Tách bước đọc và tóm tắt khỏi bước gửi hoặc chuyển thư. Nội dung email không được tự mở rộng phạm vi hộp thư, thay đổi người nhận đã duyệt hay bỏ qua xác nhận. Giữ khoá ngoài nội dung gửi vào mô hình, che dữ liệu cá nhân trong nhật ký và chỉ cung cấp phần thư cần cho nhiệm vụ.

Đặt việc xác nhận ở ứng dụng hoặc MCP client. Đặc tả công cụ MCP, đọc ngày 25/10/2026, khuyến nghị client hỏi xác nhận với thao tác nhạy cảm. Bạn phải thiết kế bước này trong luồng xử lý, không để agent tự quyết định có cần hỏi hay không.

Trước khi mở quyền ghi, gửi một thư giả lập vào hộp thư thử với nội dung yêu cầu bỏ qua nhiệm vụ và đọc hộp thư khác. Kết quả mong đợi là agent nhận diện yêu cầu đó trong bản tóm tắt, không gọi công cụ theo nó. Kiểm tra thêm rằng khoá chỉ đọc không thực hiện được thao tác gửi và không đọc được hộp thư ngoài nhóm đã chọn.

Nếu lộ khoá, thu hồi khoá; các lời gọi dùng khoá đó sẽ bị từ chối ngay. Xem thêm thông tin bảo mật của Mailera khi thiết kế cách quản lý thông tin truy cập.

Mailera không thay bạn làm phần nào?

Mailera cung cấp kết nối và công cụ thao tác email. Lớp điều phối agent, quy tắc phê duyệt, lưu dấu công việc và cách xử lý chỉ dẫn độc hại trong thư vẫn là phần bạn phải thiết kế.

Mailera có thể chuyển thư khỏi Thư rác. Mailera không thể khiến nhà cung cấp tin tưởng người gửi và không bảo đảm thư vào hộp thư đến. Chuyển một thư không thay thế việc xử lý nguyên nhân khiến thư bị lọc.

Mailera hiện không hỗ trợ Proton Mail và Tuta; riêng Daum chỉ nhận thư, chưa gửi được. Với các hộp thư được hỗ trợ, hãy hoàn tất bài thử chỉ đọc trước khi mở quyền gửi cho agent.