Giao diện
@digiforce-nc/plugin-workflow-mailer
Plugin đăng ký node gửi email trực tiếp qua SMTP trong workflow, mở rộng plugin-workflow. Gửi email với nội dung tùy chỉnh sử dụng SMTP transport được cấu hình sẵn.
Plugin này làm gì?
Node Mailer gửi email trực tiếp qua SMTP server. Khác với node Send Email (sử dụng notification-email channel), Mailer kết nối trực tiếp SMTP transport cho phép kiểm soát đầy đủ từ địa chỉ gửi, header, attachments đến HTML content.
Khi nào dùng Mailer thay vì Send Email:
- Cần kiểm soát SMTP transport cụ thể
- Cần gửi file đính kèm (attachment)
- Cần tùy chỉnh email headers
- Cần gửi qua SMTP khác với SMTP hệ thống
Cấu hình
| Tham số | Kiểu | Mô tả |
|---|---|---|
from | string | Địa chỉ email người gửi |
to | string/array | Địa chỉ người nhận (hỗ trợ nhiều địa chỉ) |
cc | string/array | Địa chỉ CC |
bcc | string/array | Địa chỉ BCC |
subject | string | Tiêu đề email (hỗ trợ template biến) |
html | string | Nội dung HTML (hỗ trợ template biến) |
transport | string | Tên SMTP transport đã cấu hình |
attachments | array | Danh sách file đính kèm |
Input / Output
| Hướng | Dữ liệu | Mô tả |
|---|---|---|
| Input | to, cc, bcc | Danh sách người nhận (có thể từ biến workflow) |
| Input | subject, html | Nội dung email (template với biến) |
| Output | messageId | ID email đã gửi từ SMTP server |
| Output | accepted | Danh sách địa chỉ đã nhận thành công |
| Output | rejected | Danh sách địa chỉ bị từ chối |
Tính năng chính
| # | Tính năng | Chi tiết |
|---|---|---|
| 1 | SMTP trực tiếp | Kết nối SMTP transport, kiểm soát đầy đủ |
| 2 | Template engine | Render HTML với biến từ workflow context |
| 3 | Nhiều người nhận | Hỗ trợ to, cc, bcc với nhiều địa chỉ |
| 4 | Attachments | Đính kèm file vào email |
| 5 | Kết quả chi tiết | Biết chính xác địa chỉ nào nhận/từ chối |
Trường hợp sử dụng
| # | Kịch bản | Mô tả |
|---|---|---|
| 1 | Email xác nhận đơn hàng | Gửi email HTML đẹp với chi tiết đơn hàng cho khách |
| 2 | Báo cáo định kỳ | Gửi email tổng hợp doanh thu cuối ngày cho quản lý |
| 3 | Email kèm file | Gửi hóa đơn PDF đính kèm cho khách hàng |
| 4 | Thông báo lỗi hệ thống | Gửi email cảnh báo cho team DevOps khi phát hiện lỗi |
Lưu ý quan trọng
- SMTP transport phải được cấu hình trước trong hệ thống (Settings > Email)
- Gửi email hàng loạt cần cẩn thận rate limit của SMTP provider
- Template biến sử dụng cú pháp riêng của hệ thống (không phải Handlebars)
- Email bị reject không gây lỗi workflow - kiểm tra
rejectedarray trong output - Nội dung HTML nên inline CSS để đảm bảo hiển thị đúng trên mọi email client
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/plugin-workflow | Workflow engine (peer) |
@digiforce-nc/server | Server framework (peer) |
nodemailer | SMTP transport library |