> 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

Giúp quản lý các mẫu template gắn với từng sự kiện (ví dụ: tạo đơn hàng, cập nhật đơn hàng), phục vụ tự động gửi tin cho khách hàng khi sự kiện xảy ra.

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

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F63etFjVGMyJabMquNjOv%2F1.png?alt=media&amp;token=bd89ac87-1287-4240-826f-438107809312" 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**
    * ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FYgI7Hpz0TFr5dTqqdQ36%2FScreenshot%202025-06-30%20at%2011.50.01.png?alt=media\&token=76300169-3729-4b7c-a036-ce8967841cab)**Chỉnh sửa**: Xem và chỉnh cấu hình template cho sự kiện.
    * ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FyEaWCynYjVTQqj5pZvjb%2FScreenshot%202025-06-30%20at%2011.50.14.png?alt=media\&token=66b6e6c5-c3ae-4138-98bd-8db8c26c6cd7)**Xóa**: Xóa cấu hình sau khi xác nhận.
* **Nút “**![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FXA9mcsF3kEWIPa1fZkwC%2FScreenshot%202025-07-08%20at%2011.14.40.png?alt=media\&token=8576d86a-ece3-4ef3-afa6-6247061b0659)**”**
  * Ở 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 ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FkiNxUVh0APqRlz1Tkilc%2FScreenshot%202025-07-08%20at%2011.14.40.png?alt=media\&token=082c90d6-a816-48de-ba4c-1e2b9eb6fab8) để thêm cấu hình mới.\
4️⃣ Bấm ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FlEsMdkfEbGAfBrsh8KUH%2FScreenshot%202025-06-30%20at%2011.50.01.png?alt=media\&token=d612e9e3-15b0-4b41-8ba5-4947f16e60ee) để chỉnh sửa chi tiết.\
5️⃣ Bấm ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FjtOikt4tjwbPDgpb5Qk9%2FScreenshot%202025-06-30%20at%2011.50.14.png?alt=media\&token=1b0370b0-166f-4aa5-96e0-7d1073a4b81f) để xóa (có popup xác nhận).

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

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FIF3S6aN34LJbvEywTUzy%2F2.png?alt=media&amp;token=462ea20e-1896-46c4-978d-d0c0fb74e83a" 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**
  * ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F4ny1Hf9toYV7SK8LiL6n%2FScreenshot%202025-07-08%20at%2012.11.01.png?alt=media\&token=a68c7b06-bf0f-4b7d-8f9c-f56e8b1b1436): Thoát form mà không lưu.
  * ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FfAa5SLJyWDewlJN8KTKE%2FScreenshot%202025-07-09%20at%2014.57.03.png?alt=media\&token=cd21c28b-b833-4ae9-b5af-e0273994bfa8): Reset form về mặc định.
  * ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FLLBMtJ0l6hAAvjebaekt%2FScreenshot%202025-07-08%20at%2011.15.25.png?alt=media\&token=ab46f034-33f6-4542-838e-eee938efc8eb): 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 ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FFfHnVnGm3l5pDsVUnvWl%2FScreenshot%202025-07-08%20at%2011.15.25.png?alt=media\&token=92566ede-dc7f-4d37-823b-02f7cd973f97) để hoàn tất.

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

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FkMp3vuDcuc0mG0Z2ST8z%2F3.png?alt=media&amp;token=ce48ef20-03b0-420d-a8fe-6fdb4c33bc0e" 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**
  * ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F70i54a6Qt4divPzU5k3G%2FScreenshot%202025-07-08%20at%2012.11.01.png?alt=media\&token=7718ed9c-6952-44ea-a9d5-d548bf1c348e): Thoát mà không lưu.
  * ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F2lAVvRfvIyOiI18Pa7jb%2FScreenshot%202025-07-08%20at%2011.15.25.png?alt=media\&token=c6d34479-5455-4a7d-9166-d3a289069562): 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 ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FfJUefXGvqcpLH5auqwHf%2FScreenshot%202025-07-08%20at%2011.15.25.png?alt=media\&token=a629c5dc-9f66-4816-863e-f4183b99b1cd) để lưu thay đổi.

## Xoá cấu hình Template

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FeDNf7QPFqR4Pg85WtQj6%2F4.png?alt=media&amp;token=ffad2abd-d405-49a5-aa52-3e3199696e85" 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** ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2Fc9J4x766ctV1zTmYigSb%2FScreenshot%202025-07-08%20at%2012.11.14.png?alt=media\&token=ee182af5-963a-4137-a20a-becfcd65c819): Đóng popup mà không xóa.
* **Nút** ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FJmf9Ld5cgnfwqjRQZJYA%2FScreenshot%202025-07-08%20at%2011.15.58.png?alt=media\&token=5e018e7e-fe08-403d-93c8-582818ee19e6): Đồ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 ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FOHwvaUlIHXDrfqoVl3nk%2FScreenshot%202025-06-30%20at%2011.50.14.png?alt=media\&token=df29ec51-bdd3-4873-a556-3d072384e6ca) ở danh sách, popup sẽ xuất hiện.\
2️⃣ Đọc kỹ nội dung cảnh báo.\
3️⃣ Bấm ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FQ8Ahn5drwwrQqZX54LEe%2FScreenshot%202025-07-08%20at%2012.11.14.png?alt=media\&token=0d99b9e0-67cd-4160-9ce0-34c00af74c4f) để thoát mà không xóa.\
4️⃣ Bấm ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FjoG64xgJPac7L8qGU4aU%2FScreenshot%202025-07-08%20at%2011.15.58.png?alt=media\&token=bb9324de-e656-459a-9d47-6f5058757b8d) để thực hiện xóa.
