Оцінка розмови

Оцінка розмови дає змогу збирати відгуки відвідувачів про досвід спілкування з AI-агентом. Коли функцію ввімкнено, наприкінці розмови їм пропонується оцінити досвід, надаючи прямий і корисний сигнал про якість роботи агента.

Оцінки відображаються в панелі керування в Розмови > Вхідні біля кожної розмови й входять до експорту. Використовуйте ці дані для пошуку прогалин у знаннях, удосконалення конфігурації AI-агента й відстеження задоволеності з часом.

Налаштуйте функцію в Розмови > Аналітика > Оцінка розмови на панелі керування.

Отримання конфігурації оцінки розмови

Область доступу: 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()

Відповідь 200 OK

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

Поле	Опис
conv_rating_active boolean	Увімкнення збору відгуків наприкінці розмов
conv_rating_popup_active boolean	Показ спливного запиту на відгук (має збігатися з conv_rating_active)
conv_rating_question_codes array of strings	Типи запитань для відгуку. За замовчуванням: ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]

Оновлення конфігурації оцінки розмови

Область доступу: write_all

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

Заувага

conv_rating_active і conv_rating_popup_active мають бути встановлені в однакове значення.

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()

Відповідь 200 OK. Повертає оновлену конфігурацію оцінки розмови.

---