Conversation Rating

O Conversation Rating permite coletar feedback dos visitantes sobre a experiência com o Agente de IA. Quando habilitado, os visitantes são convidados, ao final da conversa, a avaliar sua experiência — fornecendo um sinal direto e acionável sobre o desempenho do seu Agente de IA.

As avaliações aparecem no painel em Conversas > Caixa de entrada ao lado de cada conversa, e são incluídas nas exportações de conversas. Use esses dados para identificar lacunas de conhecimento, refinar a configuração do seu Agente de IA e acompanhar tendências de satisfação ao longo do tempo.

Configure esse recurso em Conversas > Insights > Avaliação de Conversas no painel.

Get Conversation Rating Configuration

Escopo: 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	Habilitar a coleta de feedback dos visitantes ao final das conversas
conv_rating_popup_active boolean	Exibir um popup solicitando feedback (deve corresponder a conv_rating_active)
conv_rating_question_codes array of strings	Tipos de perguntas de feedback exibidas. Padrão: ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]

Update Conversation Rating Configuration

Escopo: write_all

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

Nota

conv_rating_active e conv_rating_popup_active devem ser definidos com o mesmo 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 — Retorna a configuração de conversation rating atualizada.

---