Skip to Content

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.

app/orders/repository.ts
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; }
  • html thoát mọi giá trị ${…}, nên tên khách gõ có ký tự lạ vẫn an toàn. mailFrame bọ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ùng replyTo để 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_URL là đị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ểm ok trướ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.

app/tickets/support.email.ts
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.address vớ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, inboxAddress và mọi tuỳ chọn.
  • *.email.ts — quy tắc đặt tên và kiểu đầy đủ của thư nhận.
Cập nhật