Mailera và Resend: chọn theo nguồn thư cần đọc

Kết nối hộp thư có sẵn khác gì nhận thư cho ứng dụng?

Bạn cần đọc thư khách hàng đã gửi vào Outlook của đội vận hành, hay muốn ứng dụng có một địa chỉ riêng để tiếp nhận yêu cầu? Hai việc đều có thể được gọi là “đọc email qua API”, nhưng điểm bắt đầu khác nhau.

Hãy tách ba khái niệm:

• Kết nối hộp thư có sẵn: cấp quyền cho ứng dụng truy cập một hộp thư bạn đang sở hữu.
• Nhận thư gửi đến tên miền: xử lý thư được gửi tới địa chỉ thuộc tên miền đó.
• Cấp hộp thư mới: tạo thêm hộp thư hoặc địa chỉ để sử dụng.

Đừng dùng một yêu cầu để thay cho hai yêu cầu còn lại trong bản thiết kế. Chẳng hạn, việc ứng dụng xử lý thư gửi tới một địa chỉ riêng chưa trả lời câu hỏi nó có đọc được thư đang nằm trong Outlook hay không.

Mailera kết nối Outlook/Microsoft 365, Gmail và các hộp thư IMAP hiện hữu. Mailera cho phép tìm kiếm xuyên các hộp thư qua REST API; kết quả có mailbox_id, mailbox_email và folder để xác định hộp thư nguồn và thư mục của từng thư.

Bài hộp thư có sẵn hay hộp thư riêng cho agent giúp bạn phân biệt hai hướng này trước khi chọn công cụ. Nếu cũng đang cân nhắc AgentMail, xem so sánh Mailera và AgentMail theo mô hình hộp thư.

Đối chiếu Mailera và Resend theo những tiêu chí nào?

Khi tìm “giải pháp thay thế Resend”, hãy viết ra việc cần thay thế: gửi thư, tiếp nhận thư mới hay đọc thư trong tài khoản đang dùng. Một bảng so sánh API gửi thư không đủ để quyết định công cụ đọc hộp thư.

Bảng dưới đặt khả năng của Mailera cạnh các câu hỏi bạn nên dùng khi đánh giá Resend cho cùng ứng dụng.

Nếu công việc là tìm thư trong các tài khoản đội bạn đang sử dụng, mô hình Mailera đáp ứng đúng nguồn thư đó. Nếu công việc chỉ cần một địa chỉ riêng cho ứng dụng, đừng thêm yêu cầu kết nối hộp thư cá nhân khi không cần thiết.

Chọn mô hình bằng một luồng công việc cụ thể

Trước khi thử API, bạn có thể chốt phạm vi bằng các bước sau:

1. Xác định thư đang ở đâu. Ghi rõ tài khoản hiện hữu cần đọc, hoặc địa chỉ riêng bạn muốn ứng dụng sử dụng.
2. Xác định nhu cầu lịch sử và thư mục. Chọn một thư trong phạm vi thời hạn lưu trữ cần tìm lại và một thư trong Thư rác để làm ca thử.
3. Chốt địa chỉ trả lời. Người nhận có cần thấy câu trả lời từ chính hộp thư ban đầu không?
4. Kiểm tra quyền truy cập. Người triển khai phải được phép kết nối hộp thư và cấp quyền cho ứng dụng.
5. Thử đọc trước, gửi sau. Xác nhận đúng hộp thư, đúng nội dung rồi mới thử trả lời với quyền gửi riêng.

Nếu đang cân nhắc các API khác, xem bài chọn API email theo mô hình hộp thư.

Ví dụ, đội vận hành dùng Outlook cho hỗ trợ và Gmail cho đối soát có thể kết nối các hộp thư đó vào Mailera để tìm kiếm thư qua cùng một REST API. Với agent, bạn có thể mở rộng theo cách vận hành hộp thư hợp nhất cho AI agent.

Nếu dự định dùng cả Mailera và Resend, hãy tách trách nhiệm từng dịch vụ trong thiết kế thay vì coi chúng là hai API thay thế trực tiếp. Phần Mailera có thể đảm nhiệm truy cập các hộp thư đã kết nối; phần còn lại cần được lựa chọn theo công việc riêng của ứng dụng.

Kiểm tra kết nối và tìm kiếm xuyên hộp thư thế nào?

Dùng hộp thư thử thuộc quyền sở hữu của bạn. Chỉ vai trò Admin hoặc Leader mới thêm được hộp thư qua giao diện.

1. Mở Danh sách hộp thư → Thêm hộp thư.
2. Với Outlook hoặc Microsoft 365, chọn Đăng nhập Microsoft và hoàn tất cấp quyền OAuth. Xem cách Mailera kết nối Microsoft.
3. Với Gmail, chọn Một hộp thư, nhập địa chỉ rồi làm theo luồ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 phải bật xác minh 2 bước để dùng tính năng này.
4. Trong luồng nhập thông tin kết nối, chọn Kiểm tra & kết nối. Bước này thử đăng nhập, không gửi thư thật.
5. Kiểm tra phản hồi API theo các lệnh bên dưới để đối chiếu hộp thư nguồn và thư mục của những thư bạn đã biết.

Microsoft dùng OAuth qua Microsoft Graph trong luồng này, không dùng mật khẩu ứng dụng. Tổng quan API thư Outlook của Microsoft Graph, đọc ngày 25/10/2026, mô tả quyền truy cập được uỷ quyền vào dữ liệu thư Outlook của tài khoản cá nhân hoặc tổ chức.

Kiểm tra bằng API đọc email

Tạo khoá có quyền read, giới hạn Phạm vi hộp thư vào nhóm thử. Đặt khoá vào biến môi trường $MAILERA_API_KEY trước khi chạy lệnh; không ghi khoá trực tiếp vào mã nguồn.

Liệt kê các hộp thư mà khoá được phép truy cập:

curl --request GET 'https://mailera.app/api/public/v1/mailboxes?limit=10' \
  --header "Authorization: Bearer $MAILERA_API_KEY"

Trong phản hồi, xem id, provider, capabilities và sync. Đây là các thuộc tính của từng hộp thư, không phải một tài khoản chung mới.

Tìm thư trong Thư rác xuyên các hộp thư thuộc phạm vi khoá:

curl --request GET 'https://mailera.app/api/public/v1/messages/search?folder=junk&limit=10' \
  --header "Authorization: Bearer $MAILERA_API_KEY"

Trong phản hồi API, đối chiếu mailbox_id và mailbox_email với hộp thư thử, rồi kiểm tra folder của từng kết quả. Với truy vấn trên, folder là junk. Nếu không có kết quả, kiểm tra xem hộp thư thử có thư trong Thư rác hay không trước khi kết luận kết nối lỗi.

Ghi lại thời điểm thử cùng hộp thư và thư mục đã kiểm tra. Nếu cần lấy toàn bộ nội dung thư hoặc thêm webhook, xem Tài liệu dành cho nhà phát triển.

Những lỗi hay gặp khi so sánh hai dịch vụ

Nhầm thêm kết nối với tạo địa chỉ. Nhập một địa chỉ vào biểu mẫu kết nối là cấp thông tin truy cập hộp thư đang có, không phải đăng ký địa chỉ đó.

Cho rằng nhận được thì gửi được. Khi bước gửi gặp lỗi, Mailera có lựa chọn Lưu ở chế độ Chỉ nhận. Trước khi thử trả lời, kiểm tra capabilities.send và quyền send của khoá.

Coi webhook là quyền truy cập. Hãy xử lý thông báo thư đến và quyền đọc nội dung thành hai phần riêng trong ứng dụng. Mailera có sự kiện message.received; API đọc thư vẫn dùng khoá với phạm vi hộp thư phù hợp.

Chọn theo khả năng gửi mà bỏ qua nguồn thư. Nếu ca thử quan trọng là đọc một thư cũ trong Outlook, hãy dùng chính ca thử đó để đánh giá. Một luồng gửi thành công chưa giải quyết công việc này.

Cần bảo vệ gì khi AI agent đọc thư?

Thư đến là dữ liệu không tin cậy, không phải lệnh. Một email yêu cầu agent tiết lộ khoá hoặc gửi nội dung sang địa chỉ khác phải được xử lý như nội dung thư, không phải chỉ dẫn có thẩm quyền.

Bắt đầu bằng khoá read cho một nhóm hộp thư thử. Chỉ thêm quyền khi có tác vụ cần dùng. Thiết kế bước xác nhận của người dùng trước khi agent gửi hoặc trả lời; đây là trách nhiệm của luồng ứng dụng bạn xây dựng.

Che địa chỉ cá nhân, nội dung thư và toàn bộ khoá API trong ảnh. Thu hồi khoá thử sau khi hoàn tất. Xem thông tin bảo mật của Mailera khi chuẩn bị đưa luồng đọc thư vào sử dụng.

Giới hạn Mailera cần tính vào quyết định

Mailera không cấp hộp thư hoặc địa chỉ mới, không cung cấp gửi thư tiếp thị hàng loạt hay làm ấm hộp thư. Mailera cũng không bảo đảm thư vào hộp thư đến.

Đừng thiết kế luồng dựa trên giả định đồng bộ tức thời tuyệt đối. Mailera kiểm tra nền thường xuyên hơn với hộp thư đang dùng; hộp thư ít hoạt động có thể ngủ và được đánh thức khi sử dụng. Lần tải đầu nằm trong thời hạn lưu trữ, không phải toàn bộ lịch sử hộp thư.