Оценка разговора

Оценка разговора позволяет собирать отзывы посетителей об опыте общения с 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 логическое значение	Включить сбор отзывов посетителей в конце разговоров
conv_rating_popup_active логическое значение	Показывать всплывающий запрос отзыва (должно совпадать с conv_rating_active)
conv_rating_question_codes массив строк	Типы отображаемых вопросов. По умолчанию: ["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: возвращает обновлённые настройки оценки разговора.

---