Quy tắc hiển thị

Kiểm soát khi nào và ở đâu chatbot xuất hiện

Phiên bản: 1.0 | Ngày: 2025-10-19 | Trạng thái: ✅ Hoàn thành

---

📋 Tổng Quan

Display Rules cho phép bạn kiểm soát tính hiển thị của chatbot trên website theo bối cảnh: luôn hiển thị, theo trang, theo vai trò người dùng, theo thời gian, hoặc ẩn khi hết hạn mức.

Vị trí: Manage → AI → Chatbots → Chọn chatbot → Settings → Display Rules

---

🔧 Cấu Hình Cơ Bản

• isVisible: Bật/tắt hiển thị widget

• displayPriority: Ưu tiên hiển thị (1-100). Số nhỏ = ưu tiên cao

• hideWhenLimitExhausted: Ẩn khi credits/hạn mức hết

Mẹo:

• Bật isVisible sau khi đã test xong

• Đặt displayPriority thấp cho chatbot quan trọng nhất

---

🧩 Quy Tắc Điều Kiện (Nâng Cao)

Bạn có thể đặt các điều kiện theo ngữ cảnh. Ví dụ cấu trúc JSON:

{
  "conditions": [
    { "type": "path", "pattern": "/help/*" },
    { "type": "role", "value": "employee" },
    { "type": "time", "range": "09:00-18:00" }
  ]
}

Các loại điều kiện phổ biến:

• path: Theo URL trang (hỗ trợ wildcard)

• role: Theo vai trò người dùng (vd: employee, manager)

• time: Theo khung giờ hoạt động

• pageTag: Theo thẻ/trang chuyên biệt của hệ thống

Lưu ý: Điều kiện phải khớp để widget hiển thị; nếu nhiều chatbot cùng khớp, displayPriority quyết định.

---

🧪 Ví Dụ Thực Tế

1) Hiển thị ở Trung tâm Trợ giúp

{
  "conditions": [
    { "type": "path", "pattern": "/help/*" }
  ],
  "isVisible": true,
  "displayPriority": 5
}

2) Chỉ cho Nhân viên đã đăng nhập

{
  "conditions": [
    { "type": "role", "value": "employee" }
  ],
  "isVisible": true
}

3) Ẩn khi hết hạn mức

{
  "isVisible": true,
  "hideWhenLimitExhausted": true
}

---

✅ Quy Trình Thiết Lập

1. Mở chatbot → Tab Settings

2. Mở phần Display Rules

3. Bật isVisible

4. Đặt displayPriority

5. (Tùy chọn) Thêm conditions

6. Lưu → Test trên staging → Deploy production

---

🧠 Best Practices

• Bắt đầu đơn giản (isVisible + priority), thêm conditions sau

• Dùng wildcard URL thận trọng; test kỹ các trang con

• Tài liệu hóa các quy tắc để tránh xung đột

• Nếu nhiều chatbot trùng điều kiện, dùng priority để phân giải

---

🧯 Khắc Phục Sự Cố

• Widget không xuất hiện:

  • isVisible = true

  • Điều kiện khớp URL/role/time

  • Không bị ẩn do hết hạn mức

  • Embed code đúng vị trí (</body>)

• Hiển thị sai chatbot:

  • Kiểm tra displayPriority

  • Kiểm tra xung đột điều kiện giữa các chatbot

---

🔗 Tài Liệu Liên Quan

• Configure Chatbot

• Widget Appearance

• Live Chat Widget

---

Phiên bản: 1.0 Cập nhật cuối: 2025-10-19 Trạng thái: ✅ Hoàn thành