Nút notification

Nút notification gửi thông báo theo mẫu sự kiện đã chọn từ mô-đun Events. Các kênh, ngôn ngữ và người nhận được lấy từ cài đặt mẫu, và nút truyền các giá trị biến vào mẫu.

Nút nằm ở thanh bên trái bên cạnh các nút telegram và whatsapp. Nó có một đầu vào và một đầu ra.

---

Cài đặt nút notification

1. Tên

Trường để chỉ định tên của nút.
Tên hiển thị trong không gian làm việc và giúp dễ dàng xác định nút.
Nếu để trống, nút sẽ được gọi là notification.

Ví dụ:

• Tên nút: gửi mã đơn hàng

---

2. Mẫu sự kiện

Phần trong đó chọn mẫu sự kiện và đặt dữ liệu cho nó.

Mẫu

Danh sách thả xuống các mẫu. Trong đó hiển thị các sự kiện của mô-đun Events, được đánh dấu là mẫu cho quy trình (tích chọn Sử dụng như một mẫu cho quy trình trong cài đặt sự kiện), — tối đa 100 cái. Tên được lấy theo ngôn ngữ giao diện hiện tại.

Khi chưa chọn mẫu, trường sẽ ghi — chọn mẫu —. Có thể đặt lại lựa chọn bằng cách nhấn vào dấu x trong trường.

thông tin

Khi thay đổi mẫu, các giá trị biến và đường dẫn đến người nhận sẽ bị xóa — cần phải điền lại.

Thông tin về mẫu

Sau khi chọn, dưới danh sách sẽ xuất hiện thẻ mẫu:

• Tên mẫu — tên của mẫu.
• Kênh — các kênh gửi, được bao gồm trong mẫu: Email, Push, WebSocket.
• Người nhận — ai sẽ nhận thông báo từ mẫu.
• Ngôn ngữ — các ngôn ngữ mà mẫu được điền.

Các giá trị có thể cho Người nhận:

Giá trị	Ai sẽ nhận thông báo
Tất cả người dùng	tất cả người dùng
Người đăng ký	người đăng ký
Nhóm người dùng	nhóm người dùng
Người dùng mục tiêu	người dùng mục tiêu
Đã đăng ký	đã đăng ký
Mọi người	tất cả
ID người dùng từ quy trình	người dùng, ID của họ được truyền bởi quy trình
Địa chỉ email từ quy trình	địa chỉ email, được truyền bởi quy trình

Nếu có vấn đề với mẫu đã chọn, biểu mẫu sẽ cảnh báo về điều đó:

• Không thể tải danh sách mẫu. — danh sách mẫu không được tải.
• Không tìm thấy mẫu. Có thể nó đã bị xóa. — không tìm thấy mẫu, có thể nó đã bị xóa.
• Sự kiện đã chọn không còn là mẫu. — sự kiện đã chọn không còn được đánh dấu là mẫu.

---

3. Người nhận

Khối này chỉ xuất hiện nếu trong mẫu người nhận là ID người dùng từ quy trình hoặc Địa chỉ email từ quy trình. Trong đó có một trường với đường dẫn đến mảng người nhận trong thông điệp quy trình, theo định dạng Mustache:

• Đường dẫn đến ID người dùng trong thông điệp — cho ID người dùng từ quy trình, gợi ý trong trường: {{msg.payload.userIds}};
• Đường dẫn đến địa chỉ email trong thông điệp — cho Địa chỉ email từ quy trình, gợi ý trong trường: {{msg.payload.emails}}.

Ví dụ:

{{msg.payload.userIds}}

---

4. Biến mẫu

Khối này xuất hiện nếu trong mẫu có các biến tùy chỉnh. Đối với mỗi biến — một trường riêng, được ghi nhãn bằng tên biến (hoặc nhãn của nó, nếu không có tên).

Giá trị — biểu thức Mustache hoặc chuỗi thông thường.

Ví dụ:

{{msg.payload.code}}

Nếu biến bị xóa khỏi mẫu, nhưng trong nút vẫn lưu giá trị cho nó, biểu mẫu sẽ hiển thị cảnh báo Những biến này không còn được sử dụng trong mẫu: với danh sách các biến như vậy và giá trị của chúng.

---

Tham số trong sơ đồ JSON

Trong sơ đồ JSON của quy trình, cài đặt của nút được lưu trữ như sau:

• name (string) - tên của nút
• eventId (number | null) - ID của mẫu sự kiện đã chọn
• variables (object) - giá trị của các biến mẫu: khóa — nhãn của biến, giá trị — biểu thức Mustache hoặc chuỗi
• recipientsPath (string) - đường dẫn đến mảng người nhận trong thông điệp

---

Ví dụ sử dụng

Ví dụ 1: Thông báo cho người dùng, được truyền bởi quy trình

Nhiệm vụ:
Gửi mã đơn hàng cho một số người dùng, ID của họ được quy trình tính toán.

Quy trình:

[inject] ---> [function] ---> [notification]

Mã của nút function:

msg.payload = {
  userIds: [12, 15],
  code: "A-1024"
};
return msg;

Cài đặt của nút notification:

• Mẫu: mẫu sự kiện, mà người nhận là ID người dùng từ quy trình, và trong văn bản có biến với nhãn code
• Đường dẫn đến ID người dùng trong thông điệp: {{msg.payload.userIds}}
• Trường biến code trong Biến mẫu: {{msg.payload.code}}

Kết quả:
Thông báo sẽ được gửi đến người dùng có ID 12 và 15 qua các kênh được bao gồm trong mẫu, và thay vì biến code, văn bản sẽ được thay thế bằng A-1024.