Conversation Rating

Conversation Rating te permite recopilar feedback de los visitantes sobre su experiencia con el Agente de IA. Cuando está activado, se invita a los visitantes a valorar su experiencia al final de la conversación, proporcionando una señal directa y accionable sobre el rendimiento de tu Agente de IA.

Las valoraciones aparecen en el Dashboard, en Conversations > Inbox, junto a cada conversación, y se incluyen en las exportaciones de conversaciones. Usa estos datos para identificar lagunas de conocimiento, refinar la configuración de tu Agente de IA y seguir las tendencias de satisfacción a lo largo del tiempo.

Corresponde a Conversations > Inbox > Feedback settings en el 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	Activar la recopilación de feedback del visitante al final de las conversaciones
conv_rating_popup_active boolean	Mostrar un aviso emergente pidiendo feedback (debe coincidir con conv_rating_active)
conv_rating_question_codes array of strings	Tipos de preguntas de feedback mostradas. Por defecto: ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]

Update Conversation Rating Configuration

Scope: write_all

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

Nota

conv_rating_active y conv_rating_popup_active deben establecerse con el mismo valor.

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 — Devuelve la configuración de conversation rating actualizada.

---