Skip to main content
Bot Fields (Thuộc tính toàn cục) là các biến dữ liệu cấp không gian làm việc (Workspace-level) dùng chung cho toàn bộ chatbot. Khác với Custom Fields (lưu giá trị riêng cho từng khách hàng), tất cả khách hàng, kịch bản Flow và AI Agent đều dùng chung một giá trị duy nhất cho mỗi Bot Field. Khi bạn thay đổi giá trị của một Bot Field tại bảng quản trị, tất cả các tin nhắn, kịch bản Flow và câu trả lời AI đang tham chiếu đến Bot Field đó sẽ tự động cập nhật giá trị mới tức thì.

Các định dạng dữ liệu hỗ trợ (Data Types)

Bot Fields hỗ trợ 6 định dạng dữ liệu tiêu chuẩn:
  • Short Text: Chuỗi văn bản ngắn một dòng. Thích hợp lưu số hotline, địa chỉ công ty, email hỗ trợ, tên thương hiệu hoặc mã voucher tuần.
  • Long Text: Văn bản dài nhiều dòng có hỗ trợ xuống dòng. Thích hợp lưu giới thiệu doanh nghiệp, tóm tắt chính sách hoặc tài liệu ngữ cảnh cho AI Agent.
  • Number: Dữ liệu số nguyên hoặc số thập phân. Dùng để lưu tỷ lệ giảm giá, số lượng suất quà tặng hoặc giới hạn đăng ký toàn hệ thống.
  • Date: Định dạng ngày tháng (Ngày/Tháng/Năm). Thường dùng cho ngày bắt đầu hoặc kết thúc chiến dịch.
  • Datetime: Định dạng bao gồm cả ngày, tháng, năm và giờ, phút. Phù hợp cho thời điểm chính xác hết hạn ưu đãi hoặc lịch diễn ra sự kiện trực tuyến.
  • Boolean: Giá trị logic Đúng/Sai (True/False). Dùng để bật/tắt các trạng thái toàn hệ thống như Dang_Mo_Cua, Che_Do_Nghi_Le, hoặc Bao_Tri_He_Thong.

Hướng dẫn tạo và quản lý Bot Fields

Bạn có thể tạo và quản lý Bot Fields trong mục Flows của ChatbotX:

Các bước tạo Bot Field

1

Vào mục Flows

Từ menu điều hướng bên trái giao diện ChatbotX, chọn Flows (1).
2

Chọn tab Custom Fields

Chuyển sang tab Custom Fields (2) trên thanh điều hướng ngang ở đầu trang.
3

Nhấn Create Bot Field

Cuộn xuống khu vực Bot Fields và nhấn nút + Create Bot Field (3) màu xanh ở góc phải.
4

Thiết lập thông số thuộc tính

Điền Name (Tên thuộc tính), chọn Type (Loại dữ liệu) và nhập giá trị khởi tạo vào ô Value, sau đó nhấn Save.
Bot Fields Management Dashboard

Các trường hợp sử dụng thực tế của Bot Fields

Bot Fields giúp bạn tiết kiệm thời gian vận hành và hạn chế tối đa sai sót khi thông tin chung của doanh nghiệp có sự thay đổi:

1. Đồng bộ thông tin thương hiệu và liên hệ

  • Các thuộc tính đề xuất: Hotline, Company_Address, Support_Email, Website_URL, Brand_Name.
  • Ứng dụng: Chèn các thuộc tính này vào tin nhắn chào mừng, menu hỗ trợ hoặc chữ ký tin nhắn. Khi doanh nghiệp đổi số tổng đài hoặc chuyển trụ sở, bạn chỉ cần sửa giá trị ở Bot Field 1 lần duy nhất thay vì mở từng Flow để sửa thủ công.

2. Quản lý chiến dịch khuyến mãi toàn hệ thống

  • Các thuộc tính đề xuất: Current_Voucher_Code, Discount_Rate, Promotion_End_Date.
  • Ứng dụng: Khi chạy chương trình ưu đãi mới theo tuần hoặc tháng, chỉ cần cập nhật mã voucher mới vào Bot Field Current_Voucher_Code (ví dụ: đổi từ SUMMER20 sang FALL30). Mọi kịch bản tặng mã tự động sẽ lập tức phát mã mới cho khách hàng.

3. Điều hướng theo trạng thái mở cửa hoặc bảo trì

  • Các thuộc tính đề xuất: Is_Store_Open (Boolean), Maintenance_Notice (Short Text).
  • Ứng dụng: Kết hợp Bot Field Is_Store_Open với khối Condition trong Flow. Khi đến dịp nghỉ lễ hoặc đóng cửa đột xuất, quản trị viên chỉ cần chuyển giá trị thuộc tính sang False, chatbot sẽ tự động gửi thông báo tạm nghỉ mà không làm gián đoạn luồng chat.

4. Cung cấp ngữ cảnh dùng chung cho AI Agent

  • Các thuộc tính đề xuất: Company_Introduction, Return_Policy_Summary, Warranty_Rules.
  • Ứng dụng: Sử dụng Bot Field định dạng Long Text để lưu trữ tóm tắt chính sách đổi trả hoặc giới thiệu dịch vụ. Bạn có thể chèn trực tiếp thuộc tính {{Bot_Field_Name}} vào System Prompt của AI Agent, giúp AI luôn nắm bắt chính xác quy định mới nhất.

5. Kiểm soát giới hạn số lượng suất ưu đãi

  • Các thuộc tính đề xuất: Remaining_Gift_Slots (Number).
  • Ứng dụng: Sử dụng trong các chiến dịch giới hạn quà tặng. Mỗi khi một khách hàng hoàn tất đăng ký nhận quà, Flow sẽ dùng Action giảm giá trị Bot Field đi 1. Khi giá trị về 0, khối Condition sẽ tự động khóa luồng đăng ký.

Cách sử dụng Bot Fields trong Flow

Sau khi tạo, bạn có thể áp dụng Bot Fields vào quá trình xây dựng kịch bản chatbot:

1. Cập nhật giá trị tự động (Set Bot Field Action)

Sử dụng Action Set Bot Field để cập nhật giá trị thuộc tính toàn cục từ một kịch bản quản trị hoặc thao tác vận hành tự động.

2. Phân nhánh kịch bản bằng khối Condition

So sánh giá trị của Bot Field với các điều kiện logic (bằng, chứa, lớn hơn, nhỏ hơn, đúng/sai) để điều hướng kịch bản dựa trên trạng thái toàn hệ thống.

3. Hiển thị giá trị dùng chung trong tin nhắn

Chèn trực tiếp tên thuộc tính vào nội dung tin nhắn theo cú pháp {{ten_bot_field}}. ChatbotX sẽ tự động thay thế bằng giá trị toàn cục thực tế của hệ thống khi gửi tin nhắn.