> For the complete documentation index, see [llms.txt](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/omni-mini-tool/event-trigger-messaging.md).

# Event Trigger Messaging

## **Danh sách cài đặt template gửi tin**

<figure><img src="/files/QuPsgUtraWePfP575qqM" alt=""><figcaption><p>Danh sách cài đặt template gửi tin</p></figcaption></figure>

🔹 Thành phần chính

* **Bộ lọc tìm kiếm**
  * *Tìm theo tên*: Lọc nhanh theo tên sự kiện.
* **Bảng danh sách template**
  * **STT**: Số thứ tự.
  * **Tên sự kiện**: Tên hành động hoặc sự kiện được cấu hình (ví dụ: Order.Update, Order.Create).
  * **Mã template tham chiếu**: Mã template đã phê duyệt (ví dụ: OPTTEST, 228065).
  * **Ngày khởi tạo**: Ngày giờ tạo cấu hình.
  * **Trạng thái hoạt động**: Hiển thị bằng chấm màu (xanh = đang hoạt động).
  * **Thao tác**
    * ![](/files/WoIuUAE2tPbmcKQYHhvF)**Chỉnh sửa**: Xem và chỉnh cấu hình template cho sự kiện.
    * ![](/files/C7eiISDYkUIgqhMO5PDc)**Xóa**: Xóa cấu hình sau khi xác nhận.
* **Nút “**![](/files/pFC39QyOJ1MqHdY32THu)**”**
  * Ở góc trên bên phải, mở form thêm cấu hình mới.
* **Phân trang**
  * Chọn số dòng mỗi trang, điều hướng qua các trang.

***

#### 🛠️ Hướng dẫn sử dụng

1️⃣ Tìm nhanh template theo tên sự kiện bằng ô tìm kiếm.\
2️⃣ Xem danh sách cấu hình để biết template nào áp cho sự kiện nào.\
3️⃣ Bấm ![](/files/YZdHGKU8tfVPOJ252D8V) để thêm cấu hình mới.\
4️⃣ Bấm ![](/files/Yg6O6xU5sv4P0f5Kc4F0) để chỉnh sửa chi tiết.\
5️⃣ Bấm ![](/files/P7HgHoPmUzEKY0bVdQad) để xóa (có popup xác nhận).

## Thêm mới cài đặt

<figure><img src="/files/I68RiCN6fdgMtG3A6rRU" alt=""><figcaption><p>Thêm mới cài đặt</p></figcaption></figure>

#### 🎯 Mục đích

Cho phép admin cấu hình một sự kiện để tự động gửi tin nhắn với template cụ thể.

***

#### 🔹 Thành phần chính

* **Sự kiện**: Chọn hành động hệ thống (ví dụ: Tạo đơn hàng, Cập nhật đơn hàng).
* **Trạng thái hoạt động**: Đang hoạt động hoặc Ngưng hoạt động.
* **Loại tin**: Định nghĩa kiểu gửi tin (ví dụ: Zalo UID, Incom Omni).
* **Điều kiện thực thi**: Câu điều kiện lọc logic (ví dụ: Status = 1 or Status = 2).
* **Template Id**: Mã template đã được phê duyệt.
* **Người nhận**: Chọn nhóm người nhận tin (ví dụ: Người kích hoạt sự kiện).
* **Router rule**: Chọn kênh gửi ưu tiên (ví dụ: ZNS).
* **Danh sách tham số**
  * Hiển thị các tham số động trong template.
  * Chọn nguồn dữ liệu (ví dụ: Khách hàng, Đơn hàng).
  * Chọn trường dữ liệu cụ thể (ví dụ: Số điện thoại, Email khách hàng).
  * Giá trị mặc định (tuỳ chọn).
* **Nút hành động**
  * ![](/files/ndZU93IaGtHlC79Y45P3): Thoát form mà không lưu.
  * ![](/files/61NFwcBgy2LRAocXVvM5): Reset form về mặc định.
  * ![](/files/UCoVoNB6hQxGJLBOMRM9): Lưu thông tin cấu hình.

***

#### 🛠️ Hướng dẫn sử dụng

1️⃣ Chọn **Sự kiện** mà bạn muốn tự động gửi tin.\
2️⃣ Thiết lập **Trạng thái hoạt động**.\
3️⃣ Chọn **Loại tin** phù hợp (Zalo UID/Incom Omni).\
4️⃣ Nhập **Điều kiện thực thi** nếu cần lọc đối tượng.\
5️⃣ Chọn **Template Id** được duyệt.\
6️⃣ Chọn **Người nhận**.\
7️⃣ Chọn **Router rule** (ví dụ ZNS) làm kênh gửi.\
8️⃣ Thiết lập **Danh sách tham số**: chọn nguồn và trường dữ liệu cho từng biến.\
9️⃣ Bấm ![](/files/POb8VzU84niveu17ZWLW) để hoàn tất.

## Chỉnh sửa cài đặt

<figure><img src="/files/Hr7FTW3l5KAXnlewQmnE" alt=""><figcaption><p>Chỉnh sửa cài đặt</p></figcaption></figure>

#### 🎯 Mục đích

Cho phép admin xem và chỉnh sửa chi tiết cấu hình đã có.

#### 🔹 Thành phần chính

* Tất cả các trường giống như trong form **Thêm mới**, nhưng đã điền sẵn dữ liệu.
* **Danh sách tham số**: Hiển thị tham số động trong template với nguồn dữ liệu, trường dữ liệu và giá trị mặc định có thể chỉnh sửa.
* **Nút hành động**
  * ![](/files/qwuMKsLC9D10LBX8P5Mo): Thoát mà không lưu.
  * ![](/files/8M6y0pMxbKJrtCD6njD8): Lưu lại các chỉnh sửa.

#### 🛠️ Hướng dẫn sử dụng

1️⃣ Kiểm tra thông tin đã cấu hình.\
2️⃣ Chỉnh sửa các trường nếu cần.\
3️⃣ Thay đổi hoặc cập nhật **Danh sách tham số**.\
4️⃣ Bấm ![](/files/nxsN3rjmG6IVbZSd3Got) để lưu thay đổi.

## Xoá cấu hình Template

<figure><img src="/files/k21JmpPxfk9XzBqVOb3y" alt=""><figcaption><p>Xoá cấu hình template</p></figcaption></figure>

#### 🎯 Mục đích

Xác nhận thao tác xóa cấu hình template.

#### 🔹 Thành phần chính

* Thông báo: “Dữ liệu sẽ không được phục hồi với thao tác này!”
* **Nút** ![](/files/kDNXxVDrm7K6AAk5nJgb): Đóng popup mà không xóa.
* **Nút** ![](/files/wxTYuVzrgwodmUjPENWJ): Đồng ý và thực hiện xóa vĩnh viễn.

#### 🛠️ Hướng dẫn sử dụng

1️⃣ Khi bấm nút ![](/files/ELYUwJ1tBTaQniDOXJaG) ở danh sách, popup sẽ xuất hiện.\
2️⃣ Đọc kỹ nội dung cảnh báo.\
3️⃣ Bấm ![](/files/8kvF4CiDfkSCH9VyLgvw) để thoát mà không xóa.\
4️⃣ Bấm ![](/files/3FOcMyYvLFCaAxcvRRFG) để thực hiện xóa.
