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

# Questionnaires

> Tạo và quản lý Questionnaires trong ChatbotX để thu thập câu trả lời, kiểm tra dữ liệu, chấm điểm và xem kết quả người tham gia.

**Questionnaires** giúp bạn tạo một chuỗi câu hỏi để thu thập thông tin từ người dùng trong Flow. Bạn có thể kiểm tra định dạng câu trả lời, chấm điểm, lưu dữ liệu vào Contact Field và xem kết quả trong Applicants.

Tính năng này phù hợp với form đặt hàng, khảo sát, bài kiểm tra, đăng ký tư vấn hoặc quy trình thu thập thông tin giao hàng.

## Truy cập và quản lý Questionnaires

<Steps>
  <Step title="Mở Tools">
    Từ menu bên trái, chọn **Tools**.
  </Step>

  <Step title="Chọn Questionnaires">
    Nhấn vào thẻ **Questionnaires** để mở trang quản lý.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/Gp92OcgDmOZQFYHv/images/tools_questionnaires_card.png?fit=max&auto=format&n=Gp92OcgDmOZQFYHv&q=85&s=577b6f34bf1ec99762a0252fcf920768" alt="Tools Questionnaires Card" width="3051" height="1547" data-path="images/tools_questionnaires_card.png" />
    </Frame>
  </Step>

  <Step title="Tạo questionnaire">
    Nhấn **Add**, đặt tên cho questionnaire, sau đó bắt đầu thêm câu hỏi.
  </Step>
</Steps>

Trang quản lý hiển thị tên questionnaire, số Applicants và menu Actions. Bạn có thể tìm questionnaire bằng ô **Search name...**.

Trong menu Actions, ChatbotX cung cấp các thao tác:

* **Applicants**: Xem người đã tham gia và kết quả trả lời.
* **Rename**: Đổi tên questionnaire.
* **Duplicate**: Tạo một bản sao để chỉnh sửa thành questionnaire mới.
* **Delete**: Xóa questionnaire.

<Frame>
  <img src="https://mintcdn.com/chatbotx/Gp92OcgDmOZQFYHv/images/questionnaires_management_page.png?fit=max&auto=format&n=Gp92OcgDmOZQFYHv&q=85&s=d6adf1fdab869022c84855b83c0d9af9" alt="Questionnaires Management Page" width="2600" height="916" data-path="images/questionnaires_management_page.png" />
</Frame>

## Tạo và cấu hình câu hỏi

Trang **Questions** gồm General settings và các khối câu hỏi. Bạn có thể thêm nhiều câu, sao chép, thay đổi thứ tự, tạm tắt hoặc xóa từng câu.

### Thiết lập General settings

| Thiết lập                                                       | Chức năng                                                                        |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| **Trigger the flow by completing the questionnaire (optional)** | Chọn Flow chạy sau khi người dùng hoàn thành questionnaire.                      |
| **Give points for each question answered**                      | Bật chấm điểm và hiển thị trường Points dưới mỗi câu hỏi hoặc phương án trả lời. |
| **Customize retry messages in case of reply failure**           | Kiểm tra câu trả lời và cho phép tùy chỉnh thông báo khi dữ liệu không hợp lệ.   |
| **Save data to custom fields**                                  | Cho phép lưu câu trả lời vào Custom Field hoặc System Field.                     |

Khi bật **Give points for each question answered**, bạn gán điểm cho câu trả lời đúng. ChatbotX cộng điểm của toàn bộ questionnaire và lưu tổng điểm vào System Field `{{last_points}}`.

**Customize retry messages in case of reply failure** kiểm tra các loại dữ liệu sau:

* Văn bản
* Số
* Email
* Số điện thoại
* Nút trả lời nhanh

### Cấu hình từng câu hỏi

Mỗi câu hỏi có các thành phần:

* **Question**: Nội dung Bot gửi cho người dùng.
* **Question Image**: Ảnh tùy chọn gửi kèm câu hỏi. Bạn có thể tải file hoặc chèn liên kết.
* **Active**: Bật hoặc tắt câu hỏi.
* **Response Type**: Kiểu dữ liệu mà người dùng cần trả lời.
* **Points**: Điểm của câu trả lời khi tính năng chấm điểm được bật.
* **Retry message if the reply is invalid**: Tin nhắn gửi lại khi câu trả lời không hợp lệ.
* **Save response to a custom or system field**: Trường dùng để lưu câu trả lời.

Các biểu tượng bên phải câu hỏi cho phép xóa, sao chép và thay đổi thứ tự. Nhấn **Add New** để thêm câu hỏi, sau đó nhấn **Save** để lưu questionnaire.

<Frame>
  <img src="https://mintcdn.com/chatbotx/Gp92OcgDmOZQFYHv/images/questionnaire_general_settings_and_questions.png?fit=max&auto=format&n=Gp92OcgDmOZQFYHv&q=85&s=6834d1d008a49fa27cc80ac87bfbee19" alt="Questionnaire General Settings And Questions" width="2810" height="1769" data-path="images/questionnaire_general_settings_and_questions.png" />
</Frame>

### Xử lý câu trả lời không hợp lệ

Khi câu trả lời không đúng Response Type, Bot gửi nội dung trong **Retry message if the reply is invalid** và yêu cầu người dùng nhập lại.

Người dùng có tối đa ba lần trả lời không hợp lệ. Sau lần thứ ba, ChatbotX thoát chuỗi câu hỏi và chạy block tiếp theo trong Flow.

## Các Response Type

Questionnaires hỗ trợ năm loại phản hồi:

* **Text**: Nhận nội dung văn bản.
* **Number**: Chỉ nhận dữ liệu dạng số.
* **Email**: Kiểm tra định dạng địa chỉ email.
* **Phone**: Kiểm tra định dạng số điện thoại.
* **Multiple choice**: Hiển thị các phương án dưới dạng nút trả lời nhanh.

Với **Multiple choice**, bạn có thể:

* Tạo nhiều phương án trong **Options**.
* Gán điểm riêng cho từng phương án.
* Dùng mũi tên lên hoặc xuống để thay đổi thứ tự.
* Xóa phương án không còn sử dụng.
* Nhấn **Add** để thêm phương án mới.

## Xem kết quả trong Applicants

Khi người dùng hoàn thành questionnaire, ChatbotX lưu kết quả vào **Applicants**. Khu vực tổng quan hiển thị:

* **Applicants**: Tổng số người đã tham gia.
* **Completed**: Số người đã hoàn thành.
* **Completion rate**: Tỷ lệ hoàn thành.

Bảng Applicants cho phép tìm theo tên và theo dõi **Name**, **Points**, **Status** và **Date**. Bạn cũng có thể sắp xếp theo các cột được hỗ trợ.

<Frame>
  <img src="https://mintcdn.com/chatbotx/Gp92OcgDmOZQFYHv/images/questionnaire_applicants_overview.png?fit=max&auto=format&n=Gp92OcgDmOZQFYHv&q=85&s=a20e8d12276da3258b1575ba9db6749c" alt="Questionnaire Applicants Overview" width="2606" height="1047" data-path="images/questionnaire_applicants_overview.png" />
</Frame>

Nhấn vào tên một người dùng để xem tổng điểm, từng câu trả lời và số điểm tương ứng.

Nhấn **Inbox** để mở cuộc trò chuyện với Applicant khi bạn cần tư vấn hoặc xử lý thông tin tiếp theo.

<Frame>
  <img src="https://mintcdn.com/chatbotx/Gp92OcgDmOZQFYHv/images/questionnaire_applicant_response_details.png?fit=max&auto=format&n=Gp92OcgDmOZQFYHv&q=85&s=583ea61d54cd2065800836d50b846a4d" alt="Questionnaire Applicant Response Details" width="2592" height="1425" data-path="images/questionnaire_applicant_response_details.png" />
</Frame>

## Sử dụng Questionnaires trong Flow

### Thêm Questionnaires Action

<Steps>
  <Step title="Mở Send Message">
    Trong Flow Builder, tạo hoặc mở một block **Send Message**.
  </Step>

  <Step title="Mở Actions">
    Nhấn **Create**, chọn **Actions**, sau đó chọn **Questionnaires**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/Gp92OcgDmOZQFYHv/images/select_questionnaires_action_in_flow_builder.png?fit=max&auto=format&n=Gp92OcgDmOZQFYHv&q=85&s=4b37b6c904f93a10a6698b7804601ccc" alt="Select Questionnaires Action In Flow Builder" width="3188" height="1887" data-path="images/select_questionnaires_action_in_flow_builder.png" />
    </Frame>
  </Step>

  <Step title="Chọn Mode">
    Mở **Edit** và chọn Mode phù hợp với mục đích của block.
  </Step>
</Steps>

Questionnaires Action có ba Mode:

| Mode                    | Chức năng                                                           |
| ----------------------- | ------------------------------------------------------------------- |
| **Start questionnaire** | Bắt đầu questionnaire đã chọn.                                      |
| **End questionnaire**   | Kết thúc questionnaire hiện tại và lưu kết quả vào Applicants.      |
| **Delete applicant**    | Xóa người dùng khỏi Applicants để họ có thể chạy lại questionnaire. |

<Frame>
  <img src="https://mintcdn.com/chatbotx/Gp92OcgDmOZQFYHv/images/configure_questionnaires_action_mode.png?fit=max&auto=format&n=Gp92OcgDmOZQFYHv&q=85&s=106eb9c702ca28a7e266f29971a9b3fe" alt="Configure Questionnaires Action Mode" width="3188" height="1887" data-path="images/configure_questionnaires_action_mode.png" />
</Frame>

### Ví dụ Flow thu thập thông tin giao hàng

Tạo một Send Message hỏi người dùng có muốn nhập thông tin giao hàng hay không. Nối nút **Enter information** với block chứa Action **Start questionnaire**.

Khi người dùng nhấn nút, Bot lần lượt gửi các câu hỏi về số điện thoại, địa chỉ, phương thức thanh toán và email.

## Logic hoạt động của Questionnaires

Questionnaires duy trì tiến độ trả lời của từng người dùng:

* Nếu người dùng đã trả lời câu đầu tiên và Flow quay lại block **Start questionnaire**, Bot tiếp tục từ câu chưa hoàn thành.
* Người dùng hoàn thành questionnaire sau khi trả lời hết các câu hỏi.
* Mode **End questionnaire** cũng kết thúc questionnaire và lưu kết quả vào Applicants.
* Người dùng đã có trong Applicants không thể chạy lại cùng questionnaire.
* Chạy **Delete applicant** để xóa kết quả cũ và cho phép người dùng bắt đầu lại.
* Nếu câu trả lời khớp một Keyword, ChatbotX ưu tiên kích hoạt Keyword ngay cả khi questionnaire đang chạy.
* Sau ba lần nhập dữ liệu không hợp lệ, ChatbotX thoát questionnaire và chạy block tiếp theo.

<Note>
  Chọn Contact Field phù hợp cho từng câu hỏi trước khi lưu. Điều này giúp bạn sử dụng lại số điện thoại, email hoặc địa chỉ trong các Flow khác.
</Note>

<Warning>
  Mode Delete applicant xóa kết quả questionnaire của người dùng. Chỉ dùng Mode này khi bạn muốn họ thực hiện lại toàn bộ câu hỏi.
</Warning>