Conversation Rating

Conversation Rating lets you collect visitor feedback on their AI Agent experience. When enabled, visitors are prompted at the end of their conversation to rate their experience — providing direct, actionable signal on how well your AI Agent is performing.

Ratings appear in the Dashboard under Conversations > Inbox alongside each conversation, and are included in conversation exports. Use this data to identify knowledge gaps, refine your AI Agent’s configuration, and track satisfaction trends over time.

Corresponds to Conversations > Inbox > Feedback settings in the Dashboard.

Get Conversation Rating Configuration

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

Response 200 OK

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

Field	Description
conv_rating_active boolean	Enable visitor feedback collection at the end of conversations
conv_rating_popup_active boolean	Show a popup prompt asking for feedback (must match conv_rating_active)
conv_rating_question_codes array of strings	Types of feedback questions shown. Default: ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]

Update Conversation Rating Configuration

Scope: write_all

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

Note

conv_rating_active and conv_rating_popup_active must be set to the same value.

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

Response 200 OK — Returns the updated conversation rating configuration.

---