Chuyển thư rác về hộp thư đến hàng loạt trên nhiều hộp thư

Nên chuyển từng thư, theo người gửi hay toàn bộ thư rác?

Ưu tiên danh sách thư đã duyệt. Chỉ mở rộng sang một người gửi hoặc toàn bộ thư rác khi bạn đã kiểm tra phạm vi đó trong từng hộp thư.

Ở đây, “hàng loạt” là xử lý các thư đã nhận, không phải gửi email số lượng lớn. Mailera kết nối những hộp thư bạn đang có để đọc và thao tác qua giao diện, REST API hoặc MCP.

Nếu nghi địa chỉ người gửi bị giả mạo, đừng trả lời hoặc mở liên kết trước khi xác minh. Đây cũng là khuyến cáo trong hướng dẫn xử lý thư rác của Gmail, đọc ngày 25/10/2026.

Cần chuẩn bị gì trước khi chạy?

1. Chốt danh sách hộp thư thuộc quyền quản lý. Gọi GET /mailboxes, kiểm tra nhà cung cấp qua provider, trạng thái qua status và lần đồng bộ gần nhất qua last_sync_at trong phản hồi. Loại khỏi lô những hộp thư chưa sẵn sàng.
2. Tạo khoá API đúng phạm vi. Trong Cài đặt, mở tab API key và chọn Tạo key. Đặt Phạm vi hộp thư vào nhóm cần xử lý, cấp read và move. Công việc này không cần send.
3. Rà soát trong Hộp thư chung. Mở Hộp thư chung, vào thư mục thư rác, đọc mẫu thư và đối chiếu hộp thư gốc. Đừng chỉ nhìn tên người gửi hoặc tiêu đề.
4. Lưu danh sách đã duyệt ở chương trình điều phối. Ghi mã hộp thư, phạm vi xử lý và các thư liên quan. Yêu cầu người vận hành xác nhận trước khi gọi thao tác thay đổi.

Danh sách đã duyệt là phần bạn xây dựng ở chương trình điều phối. Hãy tách bước đọc và duyệt khỏi bước chuyển thư, thay vì vừa tìm thấy thư vừa chuyển ngay.

Thực hiện bằng API theo các bước nào?

Trang dành cho nhà phát triển giới thiệu cách dùng REST API với các hộp thư đã kết nối. Các lệnh dưới đây dùng khoá trong biến môi trường $MAILERA_API_KEY; $MAILBOX_ID là mã hộp thư bạn đã duyệt.

1. Lấy danh sách hộp thư

Bắt đầu bằng một trang nhỏ để xem cấu trúc phản hồi:

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

Đối chiếu id, group_id, status và last_sync_at. Khi lấy danh sách đầy đủ, dùng limit và offset, theo dõi total để không dừng sau trang đầu. Endpoint cũng hỗ trợ provider, group_id, tag, status và q để thu hẹp phạm vi.

2. Lập danh sách thư cần duyệt

Bạn có thể tìm thư rác trên các hộp thư trong phạm vi khoá:

curl --get 'https://mailera.app/api/public/v1/messages/search' \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'folder=junk' \
  --data-urlencode 'limit=1'

Mỗi kết quả có id, mailbox_id, folder, from, subject và received_at. Giữ cả mã thư lẫn mã hộp thư trong danh sách đã duyệt. Dùng next_cursor làm giá trị cursor để lấy trang tiếp theo khi còn kết quả.

Nếu liệt kê riêng từng hộp thư, dùng GET /mailboxes/{id}/messages. Endpoint hỗ trợ folder, from, since, q, unread, cùng cursor và limit. Không giới hạn ở thư chưa đọc nếu mục tiêu là tìm mọi thư bị phân loại nhầm.

3. Chọn thao tác phù hợp

Khi tích hợp thao tác chuyển thư, dùng nội dung yêu cầu của endpoint tương ứng trong tài liệu API Mailera.

Với phạm vi một người gửi, hãy dùng from ở bước liệt kê thư để lập danh sách, duyệt từng kết quả rồi chuyển các thư đã chọn. Cách này giữ phạm vi xử lý ở từng mã thư, thay vì chuyển cả thư mục rác. Trên giao diện, mở Hộp thư chung, vào thư mục thư rác của hộp thư tương ứng, mở từng thư đã duyệt rồi chọn Không phải spam.

Thử trên một phạm vi nhỏ đã duyệt trước khi mở rộng. Chỉ dùng thao tác xử lý toàn bộ thư rác khi bạn đã rà soát toàn bộ phạm vi trong hộp thư đó.

4. Lặp theo từng hộp thư

Các endpoint chuyển thư đều gắn với một {id} hộp thư. Chương trình điều phối cần lần lượt lấy các hộp thư đã xác nhận, gọi thao tác cho phạm vi đã duyệt rồi ghi kết quả riêng. Đây không phải một yêu cầu chung cho tất cả hộp thư.

Giới hạn nhịp gọi; nếu có phản hồi lỗi, dừng hoặc chờ theo phản hồi thực tế. Bài đọc và thao tác email bằng API cho AI agent giúp đặt bước chuyển thư vào luồng xử lý lớn hơn.

Làm sao biết thư đã được chuyển đúng?

Đọc lại thư mục nguồn và hộp thư đến sau thao tác. Ví dụ, kiểm tra hộp thư đến của hộp thư vừa xử lý:

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

Lệnh này chỉ lấy một trang nhỏ, không đủ đối chiếu cả lô. Khi kiểm tra đầy đủ, tiếp tục phân trang và đối chiếu các thư đã duyệt theo hộp thư, người gửi, tiêu đề và thời điểm nhận. Mở giao diện nhà cung cấp để kiểm tra mẫu khi cần.

Không chỉ dựa vào mã thư cũ ở phía nhà cung cấp. Tài liệu di chuyển thư của Microsoft Graph, đọc ngày 25/10/2026, mô tả thao tác tạo bản sao ở thư mục đích rồi xoá bản gốc.

Chương trình điều phối nên tạo bảng theo dõi như sau; đây là mẫu nhật ký, không phải kết quả một lượt chạy:

Số đếm thư rác giảm không đủ để kết luận. Danh sách hộp thư hiển thị số thư chưa đọc ở Inbox và Junk; việc đọc thư cũng có thể làm số này thay đổi. Khi kết quả chưa khớp, kiểm tra lần đồng bộ trước khi gọi lại thao tác chuyển.

Những lỗi hay gặp khi xử lý theo lô

Nếu dùng AI agent để rà soát thư thì cần bảo vệ gì?

Khi vận hành hộp thư hợp nhất cho AI agent, hãy coi thư đến là dữ liệu không tin cậy, không phải lệnh cho agent. Nội dung yêu cầu tiết lộ khoá, đổi nhóm hộp thư hoặc chuyển thêm thư ngoài phạm vi phải bị bỏ qua, kể cả khi nó tự nhận là chỉ dẫn của quản trị viên.

Dùng khoá ít quyền và yêu cầu người vận hành xác nhận danh sách trước khi chuyển. Không cấp send cho quy trình này. Nếu một quy trình khác cần gửi thư, đặt bước xác nhận trước khi gửi; bài mẫu phê duyệt qua email bàn riêng về cách tổ chức bước đó.

Che địa chỉ, nội dung riêng tư và thông tin xác thực trong ảnh hoặc nhật ký. Trang bảo mật Mailera là phần nên đọc khi thiết kế quyền truy cập cho agent.

Chuyển khỏi Spam không thay đổi điều gì?

Mailera chuyển được thư hiện có khỏi thư mục rác, nhưng không khiến nhà cung cấp tin cậy người gửi hoặc quyết định vị trí của thư tiếp theo. Mailera cũng không cung cấp chức năng gửi thư tiếp thị hàng loạt.

Gmail nêu rõ: thư của người gửi đã bị chặn vẫn tiếp tục bị đánh dấu là thư rác dù bạn đã lấy thư trước đó ra. Với tài khoản Google Workspace, quản trị viên tổ chức cũng có thể đặt thêm các kiểm soát phân loại thư rác.

Nếu thư của cùng một người gửi liên tục vào thư rác, cần xử lý nguyên nhân ở phía người gửi và chính sách nhà cung cấp. Yêu cầu xác thực đối với thư gửi đến tài khoản Gmail cá nhân, đọc ngày 25/10/2026, quy định SPF hoặc DKIM cho mọi người gửi, và SPF, DKIM cùng DMARC cho người gửi số lượng lớn. Chuyển thư đã nhận không thay thế các cấu hình đó.