> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Thuộc tính Bot toàn cục

> Hướng dẫn tạo và quản lý Bot Fields trong ChatbotX để quản lý các biến dữ liệu toàn cục dùng chung cho toàn bộ kịch bản và AI Agent.

**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](/docs/vi/automation/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

<Steps>
  <Step title="Vào mục Flows">
    Từ menu điều hướng bên trái giao diện ChatbotX, chọn **Flows** (1).
  </Step>

  <Step title="Chọn tab Custom Fields">
    Chuyển sang tab **Custom Fields** (2) trên thanh điều hướng ngang ở đầu trang.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/8-9G6kkt4zZfpjKf/images/bot_fields_management_dashboard.png?fit=max&auto=format&n=8-9G6kkt4zZfpjKf&q=85&s=b28a8b3ac47a57066fdd84a79acd1f40" alt="Bot Fields Management Dashboard" width="3075" height="1238" data-path="images/bot_fields_management_dashboard.png" />
</Frame>

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.