Conversation Rating

Conversation Rating vous permet de collecter les retours des visiteurs sur leur expérience avec l’AI Agent. Lorsqu’elle est activée, les visiteurs sont invités à la fin de leur conversation à évaluer leur expérience — fournissant un signal direct et exploitable sur la performance de votre AI Agent.

Les évaluations apparaissent dans le Dashboard sous Conversations > Inbox à côté de chaque conversation, et sont incluses dans les exports de conversations. Utilisez ces données pour identifier les lacunes de connaissances, affiner la configuration de votre AI Agent et suivre les tendances de satisfaction dans le temps.

Correspond à Conversations > Inbox > Feedback settings dans le 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	Active la collecte des retours des visiteurs à la fin des conversations
conv_rating_popup_active boolean	Affiche une invite popup demandant un retour (doit correspondre à conv_rating_active)
conv_rating_question_codes array of strings	Types de questions de retour affichées. Par défaut : ["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 et conv_rating_popup_active doivent être définis à la même valeur.

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 — Retourne la configuration de conversation rating mise à jour.

---