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

# Cấu hình đánh giá CSAT

## 1. Giới thiệu

**Đánh giá CSAT (CSAT Rating)** là tính năng cho phép Builder cấu hình khảo sát mức độ hài lòng của khách hàng (Customer Satisfaction) ngay trong luồng trò chuyện với AI Agent **dưới dạng hiển thị Webview** (Builder vẫn có thể cấu hình Đánh giá CSAT dưới dạng kịch bản hội thoại cho người dùng tương tác với Agent theo cơ chế cũ).

**Cách hoạt động:** Builder cấu hình 1 bộ nội dung Đánh giá CSAT duy nhất cho Agent → Gắn cấu hình này vào một **Nhắc nhở (Reminder)** để kích hoạt khảo sát sau khoảng thời gian khách hàng không hoạt động → Agent gửi thông điệp kèm nút bấm dẫn tới webview đánh giá → Khách hàng chọn số sao, nhập nhận xét (nếu muốn) và gửi đánh giá → Hệ thống ghi nhận kết quả vào báo cáo và hiển thị lời cảm ơn trên webview.

<Note>
  * Mỗi Agent chỉ có 1 cấu hình Đánh giá CSAT tại một thời điểm.
  * Thang đánh giá cố định ở dạng 5 sao, không thể thay đổi sang kiểu khác.
  * Mỗi hội thoại (conversation) chỉ được ghi nhận 1 kết quả đánh giá; sau khi đã đánh giá, khách hàng không thể đánh giá lại trong cùng hội thoại đó.
  * Liên kết webview đánh giá có thời hạn sử dụng; sau khi hết hạn, hệ thống sẽ hiển thị thông báo hết hạn nếu khách hàng cố mở lại liên kết.
  * Liên kết webview được hiển thị tốt trên các kênh Zalo (bản Mobile), Facebook, LiveChat, Preview & Test.
</Note>

## 2. Hướng dẫn sử dụng

### 2.1. Truy cập tính năng

Vào menu **Cài đặt** > **Đánh giá CSAT** trên thanh điều hướng bên trái của màn hình Xây dựng Agent.

**Vai trò được phép truy cập:** Tenant Admin, Agent Admin, Agent Builder.

Tại góc trên bên phải màn hình, người dùng có thể:

* Nhấn **biểu tượng biểu đồ** để chuyển sang màn hình xem báo cáo thống kê kết quả đánh giá.
* Nhấn **nút bật/tắt (Toggle)** để bật hoặc tắt tính năng Đánh giá CSAT cho Agent. Mặc định khi mới truy cập, hệ thống tắt tính năng, người dùng cần nhấn Bật và gắn vào Reminder (Nhắc nhở) để sử dụng.

### 2.2. Bật/tắt và cấu hình Đánh giá CSAT

Nút bật/tắt mặc định ở trạng thái **TẮT (OFF)**. Khi ở trạng thái OFF, toàn bộ các trường cấu hình không thể chỉnh sửa.

* **Khi bật lần đầu:** hệ thống tự động áp dụng các giá trị mặc định cho toàn bộ trường cấu hình, Builder có thể chỉnh sửa lại theo nhu cầu.
* **Khi tắt OFF:** cấu hình đã thiết lập vẫn được giữ nguyên, không bị xóa; chỉ luồng đánh giá không được kích hoạt.

**Cảnh báo khi tắt cấu hình đang sử dụng:** Nếu Đánh giá CSAT đang được gắn vào một hoặc nhiều Nhắc nhở (Reminder) đang ở trạng thái ON, khi Builder tắt OFF, hệ thống hiển thị cảnh báo:

> *"Rating này đang được sử dụng bởi Reminder \[tên Reminder]. Nếu tắt, các Reminder liên quan sẽ bị lỗi."*

Builder có thể chọn **Hủy** để giữ nguyên trạng thái ON, hoặc **Xác nhận tắt** để chuyển sang OFF.

<Warning>
  Khi xác nhận tắt, các Reminder liên quan sẽ chuyển sang trạng thái lỗi cho đến khi Đánh giá CSAT được bật lại.
</Warning>

<img src="https://mintcdn.com/fpt-62e894b4/T5CrquTXhwlPBsXF/images/csat1.png?fit=max&auto=format&n=T5CrquTXhwlPBsXF&q=85&s=b612c1dd53e051430506529a8b3253de" alt="Imagecsat1" width="505" height="344" data-path="images/csat1.png" />

### 2.3. Cấu hình Webview

#### Thông tin đánh giá

Nhóm thông tin này thiết lập nội dung Agent gửi trong khung chat, trước khi dẫn khách hàng sang webview đánh giá.

<img src="https://mintcdn.com/fpt-62e894b4/T5CrquTXhwlPBsXF/images/csat2.png?fit=max&auto=format&n=T5CrquTXhwlPBsXF&q=85&s=0b9cdd5ded629d1ff298518fd1fe26c6" alt="Imagecsat2" width="576" height="125" data-path="images/csat2.png" />

| Trường               | Quy tắc / Ràng buộc         | Giá trị mặc định                                                          | Mô tả                                                                              |
| -------------------- | --------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| **Tên đánh giá**     | Bắt buộc, tối đa 50 ký tự.  | Default CSAT Survey                                                       | Tên dùng để Builder nhận diện cấu hình; cũng là tên hiển thị khi gắn vào Reminder. |
| **Thông điệp chính** | Bắt buộc, tối đa 245 ký tự. | Thank you for reaching out! Please take a moment to rate your experience. | Nội dung Agent gửi kèm nút bấm trong khung chat, không hiển thị trong webview.     |
| **Tiêu đề nút**      | Bắt buộc, tối đa 100 ký tự. | Rate this conversation                                                    | Tên hiển thị trên nút bấm để khách hàng mở webview đánh giá.                       |

#### Nội dung webview

Nhóm thông tin này thiết lập toàn bộ nội dung hiển thị trong webview đánh giá mà khách hàng nhìn thấy sau khi bấm nút.

<img src="https://mintcdn.com/fpt-62e894b4/T5CrquTXhwlPBsXF/images/csat3.png?fit=max&auto=format&n=T5CrquTXhwlPBsXF&q=85&s=3e88e5942e8adf95d458e14b5dd4a8b8" alt="Imagecsat3" width="609" height="237" data-path="images/csat3.png" />

| Trường                 | Quy tắc / Ràng buộc                                          | Giá trị mặc định                                              | Mô tả                                                                                                        |
| ---------------------- | ------------------------------------------------------------ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Tiêu đề webview**    | Bắt buộc, tối đa 100 ký tự.                                  | How would you rate your experience?                           | Tiêu đề chính hiển thị đầu webview.                                                                          |
| **Mô tả webview**      | Bắt buộc, tối đa 245 ký tự.                                  | Your conversation has been resolved. Let us know how it went! | Mô tả ngắn phía dưới tiêu đề webview.                                                                        |
| **Thang đánh giá**     | Cố định 5 sao, không cho phép thay đổi kiểu thang đo.        | 5 sao                                                         | Khách hàng bắt buộc chọn số sao trước khi có thể bấm **Submit**.                                             |
| **Nhận xét (Comment)** | Không bắt buộc với khách hàng. Placeholder tối đa 100 ký tự. | Share more about your experience...                           | Hiển thị 1 ô nhập văn bản áp dụng chung cho tất cả mức sao; khách hàng có thể bỏ qua mà vẫn **Submit** được. |
| **Lời cảm ơn**         | Bắt buộc, tối đa 245 ký tự.                                  | Thank you for your valuable feedback!                         | Hiển thị trong webview ngay sau khi khách hàng Submit đánh giá thành công.                                   |
| **Thông báo hết hạn**  | Bắt buộc.                                                    | Rating period expired!                                        | Hiển thị khi khách hàng mở liên kết webview sau khi đã hết thời hạn đánh giá.                                |

<Note>
  Toàn bộ nội dung mặc định nêu trên có thể được Agent Builder chỉnh sửa lại cho phù hợp với ngữ cảnh nghiệp vụ trước khi lưu cấu hình.
</Note>

### 2.4. Gắn Đánh giá CSAT vào Nhắc nhở (Reminder)

Đánh giá CSAT chỉ được kích hoạt gửi tới khách hàng thông qua một Nhắc nhở (Reminder) sau khoảng thời gian khách hàng không hoạt động trong hội thoại.

1. Tại màn hình cấu hình Đánh giá CSAT, nhấn liên kết **"Nhắc nhở"** ở cuối trang để chuyển sang màn hình cấu hình Reminder.
2. Tại màn hình Reminder, chọn loại trigger **Đánh giá CSAT** trong danh sách lựa chọn của trường **Thực thi nhiệm vụ**. Do hệ thống chỉ cho phép 1 cấu hình Đánh giá CSAT, tên đánh giá sẽ được tự động tải vào.
3. Thiết lập thời gian không hoạt động tại trường **Sau khoảng thời gian** (giờ/phút) để kích hoạt gửi khảo sát, sau đó nhấn **Lưu** để hoàn tất cấu hình Reminder.

<Note>
  Khi cấu hình Đánh giá CSAT được thay đổi và lưu lại, nội dung sẽ tự động đồng bộ vào các Reminder đang gắn cấu hình này, Builder không cần thao tác lại.
</Note>

<img src="https://mintcdn.com/fpt-62e894b4/T5CrquTXhwlPBsXF/images/csat4.png?fit=max&auto=format&n=T5CrquTXhwlPBsXF&q=85&s=819c689b9e7de800963407318083e642" alt="Imagecsat4" width="605" height="388" data-path="images/csat4.png" />

### 2.5. Trải nghiệm phía khách hàng

* Khi Reminder được kích hoạt, Agent gửi tin nhắn chứa **Thông điệp chính** kèm nút có **Tiêu đề nút** đã cấu hình.
* Khách hàng bấm nút để mở webview đánh giá.
* Webview hiển thị **Tiêu đề webview**, **Mô tả webview**, thang đánh giá 5 sao và ô **Nhận xét** (nếu có cấu hình).
* Khách hàng chọn số sao (bắt buộc), có thể nhập thêm nhận xét, sau đó bấm **Submit**.
* Sau khi gửi thành công, webview hiển thị nội dung **Lời cảm ơn** đã cấu hình; kết quả được ghi nhận vào báo cáo theo hội thoại tương ứng.

<img src="https://mintcdn.com/fpt-62e894b4/T5CrquTXhwlPBsXF/images/csat5.png?fit=max&auto=format&n=T5CrquTXhwlPBsXF&q=85&s=1577b7a172132108d98795c9ae66a8e1" alt="Imagecsat5" width="214" height="439" data-path="images/csat5.png" />

<img src="https://mintcdn.com/fpt-62e894b4/T5CrquTXhwlPBsXF/images/csat6.png?fit=max&auto=format&n=T5CrquTXhwlPBsXF&q=85&s=2610c895c7154dc51e2c056e1fe73fb6" alt="Imagecsat6" width="211" height="437" data-path="images/csat6.png" />

<img src="https://mintcdn.com/fpt-62e894b4/T5CrquTXhwlPBsXF/images/csat7.png?fit=max&auto=format&n=T5CrquTXhwlPBsXF&q=85&s=4e700c5cb10e9a560d482494322f77a3" alt="Imagecsat7" width="216" height="443" data-path="images/csat7.png" />

<img src="https://mintcdn.com/fpt-62e894b4/T5CrquTXhwlPBsXF/images/csat8.png?fit=max&auto=format&n=T5CrquTXhwlPBsXF&q=85&s=91e34e147bd4701411d978fcaf85edaa" alt="Imagecsat8" width="238" height="488" data-path="images/csat8.png" />