*.email.ts
Mỗi file *.email.ts cho app một địa chỉ email riêng; thư gửi tới địa chỉ đó đến hàm mặc định của file, đã tách sẵn người gửi, nội dung và file đính kèm.
app/tickets/
├── tickets.table.ts
├── repository.ts
├── support.email.ts # nhận thư gửi tới app+<id>.support@in.manh.run
├── extract.job.ts # việc nền: đọc file đính kèm
└── inbox/
└── get.ts # trả địa chỉ để hiện trong appDùng khi nào
Khách quen gửi email hơn mở app. File *.email.ts biến những thư đó thành dữ liệu: thư hỏi hàng thành phiếu hỗ trợ, thư đặt hàng thành đơn nháp, hoá đơn đính kèm thành chứng từ chờ duyệt. Nhân viên cũng có thể chuyển tiếp thư vào app thay vì gõ lại.
Địa chỉ
Tên file quyết định địa chỉ: <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), <tên> là tên file bỏ .email.ts. App có id k7xq2mfp9dhw và file app/tickets/support.email.ts nhận thư ở app+k7xq2mfp9dhw.support@in.manh.run.
<tên>gồm chữ thường, số và-, tối đa 32 ký tự. Thư mục chứa file không ảnh hưởng địa chỉ.- Hai file cùng
<tên>trong một app: deploy từ chối. - Trong code,
inboxAddress("support")từmanh/emailtrả đúng địa chỉ này, hoặcnullkhi app chưa nhận được thư. Đừng ghép chuỗi địa chỉ bằng tay. - Thư gửi tới một
<tên>không có file bị trả lại với lời nhắn “Địa chỉ này không nhận email”.
Hàm nhận thư
File export default một hàm async (mail). manh.run tách thư thô ra rồi gọi hàm với:
| Trường | Kiểu | Ý nghĩa |
|---|---|---|
from | { name?, address } | người gửi theo header, có thể bị giả |
envelope | { from, to } | người gửi và người nhận ở tầng SMTP |
to, cc | mảng { name?, address } | người nhận |
replyTo | { name?, address } | địa chỉ trả lời, nếu có |
subject | string | tiêu đề |
date, messageId, inReplyTo | ngày gửi, mã thư, mã thư đang trả lời | |
text, html | string, có thể thiếu | phần văn bản thường và HTML đầu tiên |
attachments | mảng | { filename, contentType, size, contentId?, content }, content là Uint8Array |
headers | Record<string, string> | mọi header, tên viết thường |
Hàm không cần trả gì. Chạy xong không lỗi là thư đã nhận. Ném lỗi thì thư bị trả lại cho người gửi với lời nhắn “Ứng dụng lỗi khi xử lý email” kèm 150 ký tự đầu của thông báo lỗi.
Trong hàm dùng được mọi thứ code server dùng: repository và app/db, manh/blob để lưu file, manh/openai để đọc nội dung, manh/email để gửi thư, enqueue từ manh/jobs để đẩy việc nặng ra sau.
Ví dụ
import { blob } from "manh/blob";
import { enqueue } from "manh/jobs";
import { findCustomerByEmail, createTicket } from "./repository";
export default async function (mail) {
const customer = await findCustomerByEmail(mail.from.address);
if (!customer) return; // người lạ: bỏ qua, không trả lỗi
const ticket = await createTicket({
customerId: customer.id,
subject: mail.subject.slice(0, 200),
body: (mail.text ?? "").slice(0, 20_000),
messageId: mail.messageId ?? null, // để nhận ra thư trả lời sau này qua inReplyTo
});
for (const a of mail.attachments.slice(0, 10)) {
await blob.set(`tickets/${ticket.id}/${a.filename}`, a.content);
}
if (mail.attachments.length) enqueue("app/tickets/extract.job.ts", { ticketId: ticket.id });
}import { inboxAddress } from "manh/email";
export default () => ({ address: inboxAddress("support") }); // trang hiện "Gửi yêu cầu tới …"Cần biết
- Ai cũng gửi được tới địa chỉ này. Coi thư là dữ liệu chưa tin: so
from.addressvới khách hoặc người dùng đã có, kiểm mọi thứ tách ra, không làm theo lệnh viết trong thư (kể cả khi đưa nội dung cho AI đọc). fromlấy từ header nên có thể bị giả.envelope.fromlà người gửi ở tầng SMTP. Thư quan trọng (duyệt chi, đổi trạng thái) nên cần xác nhận lại trong app.- Không thử lại. Thư lỗi bị trả về ngay, nên giữ hàm ngắn: ghi dữ liệu, lưu file, còn đọc file hay gọi AI thì đẩy sang việc nền.
- Thông báo lỗi bạn ném ra đến tay người gửi. Đừng đưa dữ liệu nội bộ vào đó.
- Thư tối đa 20 MB. Mỗi lần chạy có 30 giây CPU.
- Hàm không có người dùng đăng nhập, không có
c, không đi quamiddleware.tshayaccess. - Trả lời người gửi bằng
email()chỉ khi họ là khách đã biết; trả lời mọi thư lạ sẽ biến app thành nơi phát thư rác.
Bước tiếp theo
- Gửi và nhận email — làm việc gửi thư và nhận thư vào app từ đầu tới cuối.
- std/email —
email()vàinboxAddress()để gửi thư và hiện địa chỉ nhận. - *.telegram.ts — nhận tin nhắn từ bot Telegram theo cùng cách.