Gửi email giao dịch từ Node.js và Next.js

Cài @hatang/sdk, xác minh tên miền gửi một lần, rồi gọi emails.send từ code phía server. API tương thích Resend, và dùng được cả SMTP.

npm install @hatang/sdk

import { Hatang } from "@hatang/sdk";

const hatang = new Hatang(); // đọc HATANG_API_KEY

const { data, error } = await hatang.emails.send(
  {
    from: "Acme <[email protected]>", // tên miền đã xác minh ở Email → Tên miền
    to: "[email protected]",
    subject: "Đơn hàng #1024 đã được xác nhận",
    html: "<p>Chào Lan, đơn hàng <strong>#1024</strong> của bạn đã được xác nhận.</p>",
    text: "Chào Lan, đơn hàng #1024 của bạn đã được xác nhận.",
  },
  { idempotencyKey: "order-1024-confirmation" }, // gửi lại không bao giờ thành hai email
);
if (error) throw new Error(`${error.name}: ${error.message}`);
console.log(data.id);

Trong Next.js, gọi từ Server Action hoặc Route Handler, không bao giờ từ client component: API key là bí mật.

Các bước

1. Tạo API key có scope email:send ở Cài đặt → API Keys và đặt vào HATANG_API_KEY.
2. Thêm và xác minh tên miền: thêm các bản ghi DKIM, SPF và return-path được liệt kê. Xem Tên miền.
3. Gửi. Theo dõi trạng thái bằng emails.get(id) hoặc webhook email.delivered, email.bounced.

Tìm hiểu thêm

• Mọi trường, tệp đính kèm, hẹn giờ và gửi hàng loạt: Gửi email
• Template dùng lại có biến: Template
• Component React Email: truyền react: <WelcomeEmail /> thay cho html (SDK Node.js)
• Chuyển từ Resend, SendGrid hay Postmark: Chuyển từ Resend