Giao diện
@digiforce-nc/plugin-workflow-notification
Plugin đăng ký node gửi thông báo qua notification-manager trong workflow, mở rộng plugin-workflow. Gửi thông báo đến người dùng qua bất kỳ kênh nào đã đăng ký (in-app, email, SMS, ...).
Plugin này làm gì?
Node Notification sử dụng notification-manager để gửi thông báo qua các kênh đã cấu hình. Khác với node Mailer (chỉ SMTP) hoặc Telegram (chỉ Telegram), Notification gửi qua hệ thống thông báo tập trung - hỗ trợ đa kênh và quản lý thống nhất.
Ưu điểm so với gửi trực tiếp (Mailer, Telegram):
- Đa kênh: Một node gửi qua nhiều kênh cùng lúc
- Quản lý tập trung: Tất cả thông báo đi qua notification-manager
- Mở rộng: Thêm kênh mới mà không sửa workflow
Cấu hình
| Tham số | Kiểu | Mô tả |
|---|---|---|
recipients | array | Danh sách user/role nhận thông báo |
channels | array | Kênh gửi: in-app, email, sms, ... |
title | string | Tiêu đề thông báo (hỗ trợ template biến) |
content | string | Nội dung thông báo (hỗ trợ template biến) |
sendAll | boolean | Gửi qua tất cả kênh đã đăng ký |
Input / Output
| Hướng | Dữ liệu | Mô tả |
|---|---|---|
| Input | recipients | Người nhận (user ID, role, hoặc biến workflow) |
| Input | title, content | Nội dung thông báo (template với biến) |
| Output | sent | Số thông báo đã gửi thành công |
| Output | failed | Số thông báo gửi thất bại |
| Output | channels | Chi tiết kết quả theo từng kênh |
Tính năng chính
| # | Tính năng | Chi tiết |
|---|---|---|
| 1 | Đa kênh | Gửi qua in-app, email, SMS, và các kênh custom |
| 2 | Template | Nội dung sử dụng biến từ workflow context |
| 3 | Notification Manager | Tích hợp hệ thống thông báo tập trung |
| 4 | Chọn kênh | Cấu hình gửi qua kênh cụ thể hoặc tất cả |
| 5 | Không chặn | Gửi thông báo rồi tiếp tục, không chờ phản hồi |
Trường hợp sử dụng
| # | Kịch bản | Mô tả |
|---|---|---|
| 1 | Thông báo đa kênh | Gửi cả in-app lẫn email khi đơn hàng được tạo |
| 2 | Cảnh báo hệ thống | Push notification cho admin khi phát hiện bất thường |
| 3 | Nhắc nhở deadline | Gửi notification cho assignee trước deadline 1 ngày |
| 4 | Welcome notification | Gửi thông báo chào mừng user mới qua in-app |
Lưu ý quan trọng
- Yêu cầu
plugin-notification-managerphải được cài và cấu hình - Kênh phải được đăng ký trong notification-manager trước khi dùng
- Gửi đa kênh là fire-and-forget - lỗi 1 kênh không ảnh hưởng kênh khác
- Template biến giống nhau cho tất cả kênh - không tùy chỉnh nội dung theo kênh
- Để gửi email phức tạp (attachment, HTML), dùng Mailer node thay vì Notification
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/plugin-workflow | Workflow engine (peer) |
@digiforce-nc/plugin-notification-manager | Quản lý kênh thông báo (peer) |
@digiforce-nc/server | Server framework (peer) |