Giao diện
@digiforce-nc/plugin-workflow-send-email
Plugin đăng ký node gửi email qua notification-email channel trong workflow, mở rộng plugin-workflow. Sử dụng hệ thống notification-email đã cấu hình để gửi email, không cần cấu hình SMTP trực tiếp.
Plugin này làm gì?
Node Send Email gửi email thông qua notification-email channel đã đăng ký trong hệ thống. Khác với node Mailer (kết nối SMTP trực tiếp), Send Email sử dụng channel email đã cấu hình sẵn - đơn giản hơn và tận dụng template email có sẵn.
So sánh Send Email vs Mailer:
- Send Email: Dùng notification-email channel, đơn giản, dùng template có sẵn
- Mailer: Kết nối SMTP trực tiếp, linh hoạt hơn, hỗ trợ attachment
Cấu hình
| Tham số | Kiểu | Mô tả |
|---|---|---|
to | string/array | Địa chỉ người nhận |
cc | string/array | Địa chỉ CC |
bcc | string/array | Địa chỉ BCC |
subject | string | Tiêu đề email (template biến) |
content | string | Nội dung email (HTML, template biến) |
templateId | string | ID template email có sẵn (thay cho content) |
Input / Output
| Hướng | Dữ liệu | Mô tả |
|---|---|---|
| Input | to, cc, bcc | Người nhận (có thể từ biến workflow) |
| Input | subject, content | Nội dung (template hoặc nội dung trực tiếp) |
| Output | status | sent / failed |
| Output | messageId | ID email từ server |
| Output | error | Chi tiết lỗi nếu gửi thất bại |
Tính năng chính
| # | Tính năng | Chi tiết |
|---|---|---|
| 1 | Email channel | Sử dụng channel đã cấu hình, không cần setup SMTP mỗi node |
| 2 | Template có sẵn | Dùng email template đã tạo trong hệ thống |
| 3 | Template biến | Nội dung và tiêu đề sử dụng biến workflow |
| 4 | CC / BCC | Hỗ trợ đầy đủ CC và BCC |
| 5 | Tích hợp notification | Thống nhất quản lý qua notification-manager |
Trường hợp sử dụng
| # | Kịch bản | Mô tả |
|---|---|---|
| 1 | Email chào mừng | Gửi welcome email khi user mới đăng ký |
| 2 | Xác nhận đơn hàng | Gửi email chi tiết đơn hàng cho khách |
| 3 | Reset mật khẩu | Gửi link reset password qua email |
| 4 | Thông báo phê duyệt | Email thông báo đơn đã được duyệt / từ chối |
Lưu ý quan trọng
- Yêu cầu
plugin-notification-managervới email channel được cấu hình - Template có sẵn (
templateId) được ưu tiên hơncontentnếu cả hai được cung cấp - Người nhận có thể là email address trực tiếp hoặc user ID (hệ thống tự lấy email)
- Không hỗ trợ file đính kèm - dùng Mailer node nếu cần attachment
- Email gửi thất bại không dừng workflow (soft fail) - kiểm tra output
status
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/plugin-workflow | Workflow engine (peer) |
@digiforce-nc/plugin-notification-manager | Notification manager (peer) |
@digiforce-nc/server | Server framework (peer) |