---
title: "Quản lý nhiều hộp thư email cho AI: đọc đúng, cấp quyền đủ"
description: "Gom Gmail, Outlook để AI đọc qua MCP hoặc REST API. Hướng dẫn giới hạn quyền, giữ đúng hộp thư gửi và kiểm tra khi chưa thấy thư mới."
url: https://mailera.app/blog/quan-ly-nhieu-hop-thu-email-cho-ai
published: 2026-10-25
updated: 2026-10-25
---

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

Gom Gmail, Outlook và các hộp thư hiện có để AI đọc và tóm tắt. Giữ nguồn thư rõ ràng, bắt đầu bằng quyền chỉ đọc và kiểm tra trạng thái trước khi cho phép gửi.

## 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:

| Khái niệm | Nguồn dữ liệu | Cách sử dụng |
| --- | --- | --- |
| Hộp thư hợp nhất | Nhiều hộp thư email | Quan sát và xử lý thư mà vẫn giữ nguồn riêng |
| Hộp thư dùng chung | Một hộp thư dành cho nhiều người | Cùng xử lý thư của nhóm |
| Hộp thư đa kênh | Email và các kênh hội thoại khác | Tập trung hội thoại từ nhiều kênh |

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](https://mailera.app/product) mô tả các cách kết nối này; bài [dùng email hiện có cho AI agent](https://mailera.app/blog/ket-noi-email-voi-ai) giải thích cách đưa hộp thư đang dùng vào công việc của agent.

![Hộp thư chung hiển thị thư thử từ Gmail và Outlook, với hộp thư nguồn riêng cho từng thư.](https://mailera.app/media/4e7f5838ada9eca5/doc-ma-otp-tu-email-qua-api-de-kiem-thu-xac-minh-otp-vi-1200.jpg)
_Một danh sách để quan sát, nhưng từng thư vẫn thuộc hộp thư nguồn._

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:

| Hộp thư | Cách kết nối | Nhóm và quyền ban đầu | Người duyệt khi mở gửi |
| --- | --- | --- | --- |
| Outlook hoặc Microsoft 365 thử nghiệm | OAuth qua Microsoft Graph | Nhóm thử, `read` | Bạn hoặc người phụ trách hộp thư |
| Gmail thử nghiệm | Mật khẩu ứng dụng | Cùng nhóm thử, `read` | Người sở hữu hộp thư |
| Hộp thư trên máy chủ riêng | IMAP, thêm SMTP nếu cần gửi | Nhóm được uỷ quyền, `read` | Người vận hành được chỉ định |

Với [Outlook và Microsoft 365](https://mailera.app/providers/microsoft), chọn OAuth; không dùng mật khẩu ứng dụng. Với [Gmail trong Mailera](https://mailera.app/providers/gmail), 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](https://support.google.com/accounts/answer/185833), đọ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](https://mailera.app/blog/cach-ket-noi-email-voi-mailera).

![Danh sách hộp thư với số thư chưa đọc trong thư đến và Thư rác của từng hộp thư.](https://mailera.app/media/83a4bea678750a0c/quan-ly-nhieu-hop-thu-email-cho-ai-doc-dung-cap-quyen-vua-vi-1200.jpg)
_Kiểm tra cả số thư chưa đọc trong thư đến và Thư rác trước khi tìm thư thử._

Đố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.

![Khoá API giới hạn trong nhóm thử với quyền chỉ đọc và nút Sao chép cấu hình MCP.](https://mailera.app/media/1fbbd610a3bc1181/quan-ly-nhieu-hop-thu-email-cho-ai-doc-dung-cap-quyen-vua-vi-1200.jpg)
_Bắt đầu bằng một nhóm hộp thư và quyền read, chưa cấp quyền gửi._

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](https://learn.microsoft.com/en-us/graph/auth/auth-concepts), 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](https://mailera.app/mcp) trình bày cách tích hợp; bài [các công cụ MCP theo từng tác vụ](https://mailera.app/blog/cong-cu-mcp-mailera) 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`:

```bash
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:

```bash
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](https://mailera.app/docs).

## 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:

| Hành động | Quyền cần dùng |
| --- | --- |
| Tìm, đọc và tóm tắt | `read` |
| Chuyển thư sang thư mục khác | `move` |
| Đồng bộ chủ động | `sync` |
| Gửi, trả lời hoặc chuyển tiếp | `send` |

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ộ.

| Triệu chứng | Điều cần kiểm tra | Cách xử lý |
| --- | --- | --- |
| Giao diện có thư nhưng agent không thấy | Nhóm của khoá, `mailbox`, bộ lọc và phân trang | Đối chiếu hộp thư nguồn, nới bộ lọc phù hợp và đọc các trang còn lại |
| Không thấy thư trong thư đến | `folder` và Thư rác | Tìm cả `inbox` lẫn `junk`, không chỉ một thư mục |
| Hộp thư báo ngắt kết nối | Trạng thái đăng nhập | Dùng `get_mailbox_status` hoặc `GET /mailboxes/{id}/status`, rồi xử lý kết nối |
| Hộp thư ít dùng chưa cập nhật | Lần đồng bộ gần nhất, trạng thái ngủ | Dùng đồng bộ chủ động bằng khoá có `sync` khi cần |
| Đọc được nhưng không gửi được | Quyền `send`, `capabilities.send`, chế độ chỉ nhận | Kiểm tra quyền và kết nối gửi riêng, không cấp thêm mọi quyền |
| Công việc bị lặp hoặc kết quả gửi chưa rõ | Dấu công việc, `Idempotency-Key`, trạng thái gửi | Đối chiếu trước khi gửi lại |

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](https://learn.microsoft.com/en-us/graph/outlook-change-notifications-overview), đọ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](https://modelcontextprotocol.io/specification/2025-06-18/server/tools), đọ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](https://mailera.app/security) 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.

**Cho AI agent dùng hộp thư qua MCP** — Thêm máy chủ MCP của Mailera vào Claude, Cursor hoặc VS Code để agent đọc, phân loại và trả lời thư. [Xem cách dùng MCP](https://mailera.app/docs#mcp)