Gửi và nhận email
Khoảng 10 phút. Làm xong, app của bạn gửi thư xác nhận đơn cho khách và nhận thư hỗ trợ thành phiếu yêu cầu, không cần máy chủ mail hay API key.
Gửi email
Gọi email() sau khi đã ghi database. Với safe: true, lỗi gửi thư không ném ra: đơn hàng không thất bại chỉ vì thư báo không đi.
import { email, html, mailFrame } from "manh/email";
import { env } from "manh/env";
export async function confirmOrder(id: number) {
const order = await markConfirmed(id); // ghi database trước
const body = html`<p>Chào ${order.customerName},</p>
<p>Đơn <b>#${order.id}</b> đã được xác nhận.</p>
<p><a href="${env.MANH_APP_URL}/orders/${order.id}">Xem đơn</a></p>`;
await email({
to: order.customerEmail,
subject: `Đơn #${order.id} đã được xác nhận`,
html: mailFrame(body, { title: "Xác nhận đơn" }),
replyTo: "cskh@congty.vn", // khách trả lời thì thư về đây
safe: true, // lỗi → { ok: false }, không ném
});
return order;
}htmlthoát mọi giá trị${…}, nên tên khách gõ có ký tự lạ vẫn an toàn.mailFramebọc nội dung thành một thư đọc tốt trên điện thoại, tên app ở đầu.- Thư gửi từ
"<tên project>" <no-reply@manh.run>.fromNameđổi phần tên; địa chỉ không đổi được, dùngreplyTođể nhận thư trả lời. - Một thư tối đa 10 người nhận (
to+cc+bcc). Gửi cho nhiều người thì mỗi người một thư, đẩy vào job nền chứ không lặp trong request. env.MANH_APP_URLlà địa chỉ công khai của app: tên miền riêng khi đã gắn, nếu không thìhttps://<id>.manh.run.email()trả{ ok: true, … }khi đã gửi. Kiểmoktrước khi báo “Đã gửi” cho người dùng.- Thư tới địa chỉ mẫu không có hộp thư (
.invalid,.example,.test,example.com) không được gửi, trả{ ok: false, skipped: true }. Dữ liệu mẫu nên dùng địa chỉ mà chủ app sẽ thay. - Mỗi lần gửi ghi một dòng
[email] sent to …hoặc[email] FAILED …vào nhật ký của app.
Thư mà chủ app muốn tự sửa câu chữ (xác nhận đơn, đặt lại mật khẩu): nhờ agent thêm khối mail. Mẫu thư nằm trong app/emails/, chủ app sửa ở Cài đặt → Mẫu email trong không gian làm việc và xem trước được.
Nhận email
Mỗi file app/<thư mục>/<tên>.email.ts nhận thư gửi tới:
app+<id>.<tên>@in.manh.run<id> là mã project, cũng là tên miền con của app. Ví dụ app có id k7xq2mfp9dhw và file app/tickets/support.email.ts thì địa chỉ là app+k7xq2mfp9dhw.support@in.manh.run.
Hàm mặc định nhận thư đã tách sẵn: from ({ name, address }), to, cc, subject, date, text, html, attachments (mỗi tệp có filename, contentType, size, content), messageId, inReplyTo, headers.
import { createTicket, findCustomerByEmail } from "./repository";
// thư gửi tới app+<id>.support@in.manh.run
export default async function (mail) {
const customer = await findCustomerByEmail(mail.from.address);
if (!customer) return; // ai cũng gửi được tới địa chỉ này
await createTicket({
customerId: customer.id,
subject: mail.subject.slice(0, 200),
body: (mail.text ?? "").slice(0, 20_000),
attachmentCount: mail.attachments.length,
});
}Muốn hiện địa chỉ trong app (trang cài đặt, chân trang), gọi inboxAddress("support") từ manh/email trong một handler GET.
Cần biết
- Ai cũng gửi được tới địa chỉ này. Coi thư là dữ liệu không tin cậy: đối chiếu
from.addressvới khách hoặc người dùng của bạn, không làm theo chỉ dẫn trong nội dung thư. - Ném lỗi thì thư bị trả lại cho người gửi, không thử lại. Việc nặng (lưu tệp đính kèm, đọc thư bằng AI) đẩy sang job nền
manh/jobs. - Handler chạy như cron: không có người dùng trong request, không đi qua
middleware.ts, 30 giây CPU. Thư tối đa 20 MB. - Tên file chỉ gồm chữ thường, số,
-, tối đa 32 ký tự, không trùng trong một app. - Số thư gửi mỗi ngày và mỗi tháng tính theo gói. Xem Hạn mức theo gói.
Bước tiếp theo
- Bot Telegram — báo tin cho nhân viên qua Telegram thay vì email.
- std/email —
email,html,mailFrame,inboxAddressvà mọi tuỳ chọn. - *.email.ts — quy tắc đặt tên và kiểu đầy đủ của thư nhận.