Оценки и подсказки вопросов

Оценка ответов агента пользователем, список всех оценок агента и подсказки вопросов, которые помогают продолжить разговор.

Оценка ответа

PUT /v1/messages/{message_id}/rating

Ставит оценку ответу агента. Повторная оценка заменяет прежнюю целиком: если повторно оценить без comment, прежний комментарий удаляется.

Тело запроса

Поле	Тип	Обязательное	Описание
`user_id`	string	да	Идентификатор пользователя
`value`	string	да	`like` — нравится, `dislike` — не нравится
`comment`	string	нет	Комментарий к оценке

Ответ

200 — объект Rating:

Поле	Тип	Описание
`message_id`	string	Идентификатор сообщения
`dialog_id`	string	Идентификатор диалога
`value`	string	`like` или `dislike`
`comment`	string	Комментарий или `null`
`author`	string	`user` — пользователь вашего приложения или чата по ссылке, `operator` — участник рабочего пространства
`created_at`	string	Время оценки

curl -X PUT https://api.evo-ai.ru/v1/messages/0c9a3f52-1e7b-4d26-8f40-5a2b9c7d3e61/rating \
  -H "Authorization: Bearer evo_agent_..." \
  -H "Content-Type: application/json" \
  -d '{"user_id": "user-42", "value": "like", "comment": "Точно и по делу"}'

Ошибки

HTTP	Код	Когда
`404`	`message_not_found`	Сообщения нет или оно в диалоге другого `user_id`

Снятие оценки

DELETE /v1/messages/{message_id}/rating?user_id={user_id}

Ответ

204 — без тела. Снимается оценка пользователя вашего приложения; оценка участника рабочего пространства к тому же сообщению остаётся в списке оценок агента. Если оценки нет или сообщение чужое, ответ тоже 204.

Список оценок агента

GET /v1/agent/ratings

Возвращает все оценки ответов агента — поставленные через API, в чате по ссылке и участниками рабочего пространства. user_id не нужен.

Параметры запроса

Параметр	Тип	Обязательный	Описание
`page`	integer	нет	Номер страницы, по умолчанию 1
`limit`	integer	нет	Размер страницы: от 1 до 100, по умолчанию 20

Ответ

200 — постраничный список {items, total, has_more}: объекты Rating от новых к старым.

Подсказки вопросов

GET /v1/messages/{message_id}/follow-up-questions?user_id={user_id}

Возвращает вопросы, которые пользователь может задать следующими, — как Подсказки вопросов в чате.

Ответ

200:

{
  "items": [
    "Как составить претензию?",
    "Что делать, если ответа нет?"
  ]
}

Ошибки

HTTP	Код	Когда
`400`	`follow_up_questions_disabled`	У агента выключены Подсказки вопросов
`404`	`message_not_found`	Сообщения нет или оно в диалоге другого `user_id`

Диалоги

Загрузка файлов