Đánh giá cuộc trò chuyện

Đánh giá cuộc trò chuyện cho phép thu thập phản hồi của khách về trải nghiệm AI Agent. Khi bật, khách được nhắc đánh giá khi cuộc trò chuyện kết thúc, cung cấp tín hiệu trực tiếp và hữu ích về hiệu quả AI Agent.

Đánh giá xuất hiện trong bảng điều khiển tại Cuộc trò chuyện > Hộp thư đến cạnh mỗi cuộc trò chuyện và được đưa vào bản xuất. Dùng dữ liệu để phát hiện thiếu hụt kiến thức, tinh chỉnh cấu hình AI Agent và theo dõi xu hướng hài lòng theo thời gian.

Cấu hình tính năng tại Cuộc trò chuyện > Thông tin chuyên sâu > Đánh giá cuộc trò chuyện trong bảng điều khiển.

Lấy cấu hình đánh giá cuộc trò chuyện

Phạm vi: read_all

GET https://app.quickchat.ai/v1/api/conversation_ratings/configuration

Shell

curl https://app.quickchat.ai/v1/api/conversation_ratings/configuration \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/conversation_ratings/configuration",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Phản hồi 200 OK

{
  "conv_rating_active": true,
  "conv_rating_popup_active": true,
  "conv_rating_question_codes": ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]
}

Trường	Mô tả
conv_rating_active boolean	Bật thu thập phản hồi của khách khi kết thúc cuộc trò chuyện
conv_rating_popup_active boolean	Hiện cửa sổ bật lên yêu cầu phản hồi (phải khớp conv_rating_active)
conv_rating_question_codes mảng chuỗi	Loại câu hỏi phản hồi hiển thị. Mặc định: ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]

Cập nhật cấu hình đánh giá cuộc trò chuyện

Phạm vi: write_all

PATCH https://app.quickchat.ai/v1/api/conversation_ratings/configuration

Ghi chú

conv_rating_active và conv_rating_popup_active phải được đặt cùng giá trị.

Shell

curl -X PATCH https://app.quickchat.ai/v1/api/conversation_ratings/configuration \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "conv_rating_active": true,
  "conv_rating_popup_active": true
}'

Python

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/conversation_ratings/configuration",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "conv_rating_active": True,
        "conv_rating_popup_active": True,
    },
)
data = response.json()

Phản hồi 200 OK: trả về cấu hình đánh giá cuộc trò chuyện đã cập nhật.

---