Gửi email từ code server của app bằng manh/email, không cần API key.
Cách dùng
import { email, html, raw, mailFrame } from "manh/email";
export async function confirmBooking(b: Booking, customer: Customer) {
// … ghi database trước
const body = html`<p>Chào ${customer.name},</p><p>Lịch hẹn của bạn đã được xác nhận.</p>`;
await email({
to: customer.email,
subject: "Xác nhận lịch hẹn",
html: mailFrame(body, { title: "Lịch hẹn", footer: raw("Hotline 1900 1234") }),
safe: true, // lỗi gửi không làm hỏng việc đặt lịch
});
}Chỉ dùng trong file .ts. Gửi thư sau khi đã ghi database.
Chữ ký
function email(o: {
to: string | string[];
subject: string;
html?: string;
text?: string;
cc?: string | string[];
bcc?: string | string[];
replyTo?: string;
fromName?: string;
safe?: boolean;
}): Promise<{ ok: boolean; id?: string | null; skipped?: boolean; test?: boolean; error?: string }>;
function html(strings: TemplateStringsArray, ...values: unknown[]): Html;
function raw(s: string): Html;
function mailFrame(body: Html | string, o?: { title?: string; footer?: Html | string; color?: string; appName?: string }): Html;
function inboxAddress(name: string): string | null;Tham số
email(o):
to: người nhận, bắt buộc. Tối đa 10 địa chỉ cho cảto,cc,bcc.subject: tiêu đề.htmlhoặctext: nội dung, cần ít nhất một.cc,bcc: người nhận thêm.replyTo: địa chỉ nhận thư trả lời.fromName: tên người gửi hiện ra, mặc định là tên project, tối đa 64 ký tự. Địa chỉ gửi luôn làno-reply@manh.run.safe:truethì không bao giờ ném lỗi.
html là tagged template: mọi giá trị ${…} được escape. Lồng một html khác hoặc raw(…) khi cần chèn markup bạn tin được. mailFrame(body, o) bọc nội dung thành một thư đầy đủ, đọc tốt trên điện thoại, có tên app ở đầu.
Trả về
email trả Promise của một object có ok:
- Gửi được:
{ ok: true, id }. - Địa chỉ giả không có hộp thư (đuôi
.invalid,.example,.test, hayexample.com): thư không gửi, trả{ ok: false, skipped: true, error }. - Tài khoản thử theo vai (
…@test.manh.invalid): thư không ra ngoài, chỉ vào nhật ký, trả{ ok: true, test: true }. - Lỗi khác: promise bị từ chối; với
safe: truethì trả{ ok: false, error }.
Kiểm ok trước khi báo người dùng “Đã gửi”. Link tương đối trong thư (/khach-hang/12) được đổi thành link đầy đủ theo tên miền của app. Mỗi lần gửi ghi một dòng vào nhật ký của app ([email] sent to … hoặc [email] FAILED to …), nên nhật ký cũng là hộp thư đi. Thư tới tài khoản thử còn ghi thêm đoạn đầu nội dung (chữ thuần, link kèm địa chỉ) để test outbox kiểm được.
inboxAddress(name) trả địa chỉ nhận thư của file name.email.ts, hoặc null khi app chưa bật nhận thư.
Ví dụ
Nhận thư không dùng email(). Thư gửi tới địa chỉ của app đi vào một file *.email.ts, xem Nhận email: *.email.ts. Lấy địa chỉ để hiện cho người dùng:
import { inboxAddress } from "manh/email";
export default () => ({ address: inboxAddress("support") }); // nhận thư cho support.email.ts- Hạn mức gửi theo gói, tính theo số người nhận, dùng chung cho mọi app của tài khoản. Vượt hạn mức thì lỗi 429
BUILTIN_QUOTA_EXCEEDED; app vẫn chạy. Không thử lại 429 trong vòng lặp. - Gửi cho nhiều người thì mỗi thư một lượt, đưa vào việc chạy nền thay vì lặp trong request.
- Gói Free thêm ” via manh.run” sau tên người gửi.
Bước tiếp theo
- Email, AI, kho file: các dịch vụ có sẵn dùng cùng nhau trong một app.
- Nhận email: *.email.ts: nhận thư gửi tới địa chỉ của app.
- env:
MANH_APP_URLcho link trong thư.