Skip to Content

email

Gửi email từ code server của app bằng manh/email, không cần API key.

Cách dùng

app/bookings/repository.ts
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ý

manh/email
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 đề.
  • html hoặc text: 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: true thì 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, hay example.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: true thì 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:

app/tickets/inbox/get.ts
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

Cập nhật