MONA Mail mở beta 09/2026
API gửi email giao dịch cho app và AI agent của bạn
MONA Mail gửi mail OTP, xác nhận đơn, hoá đơn và thông báo cho app của bạn bằng một API, nạp tiền qua VietQR, không cần thẻ quốc tế.
- monamail.emails.send({ to, subject, text })
- Nhận body, kiểm
fromthuộc domain đã xác minh - Ký DKIM bằng selector
mona1, RSA 2048 - Xếp hàng, trả
201vớiidvàstatus - Worker đẩy qua Postfix trên hạ tầng MONA tại Việt Nam
- Phản hồi
{ "status": "queued", "quota": { "remaining": 2999 } }
queued nghĩa là đã xếp hàng, chưa phải delivered; trạng thái sau đó đọc qua webhook hoặc GET /v1/emails/{id}.
- Free 3.000 mail mỗi tháng, không cần thẻ
- 03/09/2026 MONA Pay và MONA Pass gửi mail thật qua lõi này
- VietQR nạp tiền Việt trong ví MONA Cloud
Sau khi bấm gửi
Đường đi của một email từ lúc xếp hàng tới hộp thư
MONA Mail ghi đúng trạng thái đang có. queued là đã nhận và xếp hàng, không phải đã tới nơi; delivered nghĩa là máy chủ nhận đã ghi log, chưa nói người nhận đã đọc.
Worker gặp lỗi SMTP tạm hoặc timeout thì chờ rồi thử lại:
- 1 giây
- 5 giây
- 25 giây
- 2 phút
- 10 phút
Hết lượt thử thì chuyển failed. Lỗi SMTP 5xx thành failed ngay, không thử lại.
queued
Chờ worker. Còn huỷ được bằng
DELETE /v1/emails/{id}.sent
Postfix đã nhận, chưa có xác nhận từ máy chủ nhận.
delivered
Máy chủ nhận đã ghi log nhận thư. Chưa có nghĩa người nhận đã đọc.
- deferredLỗi tạm, đang nằm trong lịch thử lại.
- bouncedBị trả về theo DSN. Địa chỉ vào suppression.
- suppressedĐịa chỉ đã bị chặn nên dừng trước khi gửi.
- failedLỗi cuối cùng, không thử lại nữa.
App của bạn theo dõi những trạng thái này qua webhook, mỗi sự kiện có chữ ký HMAC SHA-256 trong header X-Mona-Signature:
- email.sent
- email.delivered
- email.deferred
- email.bounced
- email.complained
- email.suppressed
- email.failed
- domain.verified
Bước bắt buộc
Xác minh domain gửi bằng bản ghi TXT
Chưa xác minh domain thì [email protected] chỉ gửi được tới email chủ tài khoản. Muốn gửi OTP cho người dùng của bạn, thêm ba bản ghi dưới đây vào tên miền trước.
- DKIM đúng là đủ để domain sang trạng thái verified. SPF và DMARC chỉ là cảnh báo, không chặn xác minh.
- Nếu tên miền đã có bản ghi SPF, thêm
include:_spf.monamail.vnvào bản ghi đang có, đừng tạo bản ghi SPF thứ hai. - Không đụng vào bản ghi MX nhận thư của công ty bạn.
Tên miền đang ở Cloudflare
Cấp một token dùng một lần cho đúng zone đó rồi gọi mail_domain_cloudflare. AI thêm cả ba bản ghi và không lưu token lại.
Tên miền ở nhà đăng ký khác
Sao chép nguyên mảng records[] API trả về rồi thêm trong trang quản lý DNS. Tài liệu có hướng dẫn theo từng nhà đăng ký phổ biến.
- TXT · DKIM, bắt buộcmissingokmona1._domainkey.shop.vnv=DKIM1; k=rsa; p=giá trị API trả
- TXT · SPF, cảnh báomissingokshop.vnv=spf1 include:_spf.monamail.vn ~all
- TXT · DMARC, cảnh báomissingok_dmarc.shop.vnv=DMARC1; p=none; rua=mailto:[email protected]
DKIM dùng selector mona1, RSA 2048. Gọi POST /v1/domains/{id}/verify để MONA Mail tra DNS ngay, mỗi bản ghi chờ tối đa 5 giây.
Bản ghi mới thường lan trong vài phút. Tên miền đuôi .vn có thể lâu hơn, xem mục hỏi đáp bên dưới.
Bảng giá tính bằng VND
Ước tính chi phí gửi mail mỗi tháng
Kéo số mail app bạn gửi trong một tháng, hoá đơn bên cạnh chọn gói rẻ nhất cho mức đó và tính luôn phần vượt.
Thanh kéo chỉ để ước tính theo giá niêm yết. Phần vượt gom theo giờ, nên hoá đơn thật có thể lẻ hơn con số này. Gói Miễn phí ngưng gửi khi hết hạn mức và trả lỗi 402 quota_exceeded.
| Gói | Khởi nghiệp | 99.000đ |
|---|---|---|
| Hạn mức | 30.000 mail mỗi tháng | đã gồm |
| Vượt gói | 0 mail × 3đ/mail | 0đ |
| Tổng tháng | 99.000đ |
Ví thiếu tiền thì API trả 402 insufficient_funds và tạm dừng phần gửi vượt; quá hạn mức bạn đặt thì trả budget_exceeded.
Hạn mức mỗi tháng và đơn giá phần vượt
Gói trả phí tính thêm từng mail vượt. Đổi gói bằng mail_plan_set hoặc PUT /v1/account/plan.
- Miễn phí Free 3.000 mail, ngưng khi hết Mở console
- Khởi nghiệp 99.000đ/tháng 30.000 mail, vượt 3đ/mail Chọn gói
- Đề xuấtKinh doanh 299.000đ/tháng 150.000 mail, vượt 2đ/mail Chọn gói
- Doanh nghiệp 799.000đ/tháng 600.000 mail, vượt 1,5đ/mail Chọn gói
- Khách đang thuê MONA làm web hoặc phần mềm dùng miễn phí không giới hạn
- Gọi 1900 636 648 để MONA đối chiếu hợp đồng rồi mở
- Xem cách tính phần vượt
Đang dùng Resend
Chuyển phần gửi mail sang SDK MONA Mail
Phần gọi gửi giữ nguyên body, chỉ đổi import và constructor. Việc còn lại là sửa chỗ đọc kết quả: MONA Mail trả thẳng object và ném exception thay vì cặp data với error.
- import { Resend } from 'resend';
- import { MonaMail } from 'monamail';
- const resend = new MonaMail(process.env.MONAMAIL_API_KEY);
- Domain gửi phải ở trạng thái verified trước khi gửi cho người dùng thật.
- React Email render ra HTML trong app rồi gửi qua trường
html; SDK MONA Mail không nhận thuộc tínhreact. - Broadcasts chưa có trong bản beta, nên giữ phần đó ở luồng hiện tại.
Bảng đối chiếu lấy giá niêm yết Resend ngày 05/09/2026, gói Pro 20 USD mỗi tháng cho 50.000 mail. MONA Mail không quy đổi tỷ giá và không tuyên bố rẻ hơn; Resend vẫn mạnh hơn ở React Email, Broadcasts và số lượng region.
Giao việc cho AI
AI tích hợp gửi mail vào app qua MCP và MONA Pass
Bạn đăng nhập MONA Pass một lần. AI tạo domain, API key và webhook qua API, thử trong sandbox trước, rồi dừng lại ở chỗ cần bạn thêm DNS hoặc nạp tiền.
Claude.ai đăng nhập MONA Pass sau khi thêm connector. Gemini lưu cấu hình tại ~/.gemini/config/mcp_config.json và kiểm tra bằng agy mcp list. Endpoint chung có đủ nhóm tool mail_*.
Prompt không chứa API key hay mật khẩu. Key lưu trong .env phía máy chủ, và mọi lệnh POST đi kèm khoá chống trùng.
- Thêm gửi OTP cho app này bằng MONA Mail. Domain là shop.vn, token Cloudflare tôi đưa sau. Gửi thử sandbox trước rồi báo tôi phần nào cần tôi làm tay.
Đọc tài khoản và hạn mức gói đang dùng trước khi tạo gì.
mail_accountmail_plansKiểm domain đã khai chưa để không tạo trùng, rồi thêm shop.vn.
mail_domains_listmail_domain_addGửi thử bằng key
mm_test_, không ra Internet nên không tính quota.mail_sendsandbox=truemail_statusSandbox đạt. Cần bạn thêm ba bản ghi TXT cho shop.vn, hoặc đưa token Cloudflare dùng một lần cho đúng zone đó.
Thêm bản ghi, xác minh domain rồi tạo key thật và webhook nhận bounce.
mail_domain_cloudflaremail_domain_verifymail_api_key_createmail_webhook_create- Gửi thật, trạng thái cuối
delivered
Hệ MONA Cloud
Một tài khoản MONA Pass dùng chung cho cả hệ
MONA Mail nằm trong nhóm sản phẩm của The MONA Group. Đăng nhập một lần là dùng được phần còn lại, và ví VND cũng là ví chung.
MONA Mail
Gửi mail OTP, xác nhận đơn, hoá đơn và thông báo từ app bằng một API.
Miễn phí 3.000 mail mỗi tháng
Đọc tài liệu APIVì sao tin được
Lõi gửi mail này đang chạy cho sản phẩm của chính MONA
MONA làm phần mềm và hạ tầng cho doanh nghiệp từ 2016. MONA Pay và MONA Pass gửi mail giao dịch thật qua lõi MONA Mail từ 03/09/2026, trước khi bản beta mở cho người ngoài.
Bản beta gửi từ hạ tầng MONA đặt tại Việt Nam, và có tổng đài trả lời bằng tiếng Việt khi domain hoặc luồng gửi của bạn có chuyện.
- 14.000+dự án đã triển khai
- 85%khách ở lại
- 1900 636 648tổng đài tiếng Việt
Làm tới đâu, ghi tới đó
MONA bắt đầu làm phần mềm và hạ tầng
Mười năm sau là 14.000+ dự án và 85% khách ở lại.
MONA Pay và MONA Pass gửi mail thật qua lõi này
Mail giao dịch của hai sản phẩm trong nhà đi qua đúng đường mà app của bạn sẽ dùng.
Mở beta API gửi mail giao dịch
Gửi từ hạ tầng MONA tại Việt Nam. Có SDK Node, Python, PHP và bộ tool
mail_*trong monacloud-mcp.Bật hộp thư cho AI agent
Agent có địa chỉ riêng để nhận OTP, đọc và trả lời thư trong cùng luồng qua API hoặc tool
mail_inbox_*.Phần mở ở giai đoạn sau
- Email marketing với pool IP riêng
- IP riêng tách theo từng loại mail
Hỏi đáp
Câu hỏi thường gặp trước khi gửi
Những câu hay gặp nhất khi ghép MONA Mail vào app. Câu nào chưa có ở đây thì gọi người hỗ trợ.
Xem tất cả câu hỏi
Chưa có domain riêng thì gửi được không?
Được, nhưng [email protected] chỉ gửi tới chính email của tài khoản MONA Pass. Muốn gửi OTP hay mail giao dịch cho người dùng thật, bạn phải xác minh domain bằng ba bản ghi TXT trước.
Xác minh domain mất bao lâu?
Bản ghi thường có hiệu lực sau 5 đến 15 phút; tên miền đuôi .vn có thể mất tới vài giờ. Verify hỏng ở lần đầu là bình thường, chờ thêm rồi thử lại.
Sandbox có tốn tiền không?
Không. Key mm_test_ đi hết pipeline nhưng không gửi ra Internet, không tính quota và không trừ ví. Trạng thái cuối là sandbox, và GET email trả sandbox_preview để bạn xem nội dung đã dựng.
Domain mới gửi mail có dễ vào spam không?
Domain mới gửi lần đầu có thể bị Gmail hoặc Outlook đưa vào spam trong vài ngày đầu; đó là hiện tượng chung của mọi dịch vụ email mới. Gửi từ tốn rồi tăng dần, giữ nội dung sạch, và thêm link huỷ đăng ký cho mail marketing. Domain vừa xác minh cũng bị giới hạn 500 mail mỗi ngày trong tuần đầu.
Vượt quota thì chuyện gì xảy ra?
Gói Miễn phí ngưng gửi và trả 402 quota_exceeded. Gói trả phí tính thêm từng mail vượt: 3đ ở Khởi nghiệp, 2đ ở Kinh doanh, 1,5đ ở Doanh nghiệp, gom theo giờ. Ví thiếu tiền trả 402 insufficient_funds, quá hạn mức bạn đặt trả budget_exceeded.
Bounce và suppression xử lý thế nào?
Hard bounce bị chặn toàn hệ trong 30 ngày, và theo tài khoản thì không tự hết hạn. Suppression có bốn nguồn: hard_bounce, complaint, manual và unsubscribe; bạn chỉ gỡ được lớp của tài khoản mình. Gửi tới địa chỉ đang bị chặn thì delivery trả suppressed.
Webhook được ký ra sao?
X-Mona-Signature là sha256= cộng HMAC SHA-256 của chuỗi timestamp.raw_body, khoá là secret webhook, timestamp lấy từ X-Mona-Timestamp. Giữ raw bytes trước khi parse JSON, từ chối nếu lệch quá 300 giây, và chống xử lý trùng theo id của event.
Có hộp thư như Google Workspace không?
Không. Hộp thư cho người dùng cần lưu trữ, IMAP, client, chống spam hai chiều, chuyển dữ liệu và hỗ trợ vận hành riêng, đó là một sản phẩm khác. MONA Mail tập trung vào email cho phần mềm và AI agent.
Có hộp thư cho AI agent không?
Có, hộp thư cho AI agent chạy từ 16/09/2026. Bạn tạo một địa chỉ để agent trực, rồi agent nhận thư, chờ mã OTP, đọc và trả lời ngay trong luồng qua API hoặc tool mail_inbox_*. Gói miễn phí có 1 hộp, gói Doanh nghiệp có 100 hộp; thư trong hộp lưu 90 ngày.
Bắt đầu với MONA Mail
Sandbox miễn phí để bạn thử luồng gửi mail trước khi gửi thật
Key mm_test_ đi hết pipeline nhưng không gửi ra Internet, không tính quota và không trừ tiền. Luồng đã đúng thì bạn xác minh domain và tạo key thật.
- Free3.000 mail mỗi tháng
- 99.000đgói Khởi nghiệp mỗi tháng
- VietQRnạp tiền, không cần thẻ
