# Conversation Rating

> Collect visitor feedback on their AI Agent experience, with visitors prompted to rate the conversation at the end.

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**

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

**Python**

```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`

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

| Field | Description |
|-------|-------------|
| `conv_rating_active` <br/> boolean | Enable visitor feedback collection at the end of conversations |
| `conv_rating_popup_active` <br/> boolean | Show a popup prompt asking for feedback (must match `conv_rating_active`) |
| `conv_rating_question_codes` <br/> 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**

```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**

```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.

---