Valutazione della conversazione

La valutazione della conversazione permette di raccogliere il feedback dei visitatori sull’esperienza con l’agente AI. Quando è attiva, al termine della conversazione i visitatori ricevono una richiesta di valutazione: un segnale diretto e utilizzabile sulle prestazioni dell’agente AI.

Le valutazioni compaiono nella dashboard in Conversazioni > Posta in arrivo, accanto a ogni conversazione, e sono incluse nelle esportazioni. Usa questi dati per individuare lacune nella conoscenza, affinare la configurazione dell’agente AI e monitorare l’andamento della soddisfazione nel tempo.

Configura questa funzione in Conversazioni > Approfondimenti > Valutazione della conversazione nella dashboard.

Recuperare la configurazione della valutazione delle conversazioni

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

Risposta 200 OK

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

Campo	Descrizione
conv_rating_active booleano	Attiva la raccolta del feedback dei visitatori al termine delle conversazioni
conv_rating_popup_active booleano	Mostra un popup per richiedere feedback (deve corrispondere a conv_rating_active)
conv_rating_question_codes array di stringhe	Tipi di domande di feedback mostrate. Predefinito: ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]

Aggiornare la configurazione della valutazione delle conversazioni

Ambito: write_all

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

Nota

conv_rating_active e conv_rating_popup_active devono avere lo stesso valore.

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

Risposta 200 OK: restituisce la configurazione aggiornata della valutazione delle conversazioni.

---