09.06.2026 00:00

SetReaction

[POST] .../v1/chatmessage/setreaction

Переключает одну реакцию текущего пользователя на сообщение.

Если реакция ещё не установлена текущим пользователем, метод добавляет её. Если такая реакция уже установлена, метод удаляет её. Если при добавлении новой реакции достигнут лимит реакций текущего пользователя на одно сообщение, первая реакция пользователя удаляется и новая реакция добавляется последней.

При успешном изменении публикуется websocket/webhook-событие ChatMessageReactionsSet.

Входные параметры

Название Тип данных Обязательность Описание
id String Обязательный UUID сообщения
reaction String Обязательный Код реакции

Ограничения и проверки

  • Метод является write-операцией и недоступен, если запись в чат запрещена текущим состоянием чата или связанной сущности.
  • Реакция должна входить в список реакций, разрешённых для чата.
  • Количество реакций текущего пользователя на одно сообщение задаётся серверными настройками.
  • При достижении лимита новая реакция добавляется с вытеснением первой реакции текущего пользователя.

Пример запроса

{
  "id": "9beec41f-6ef5-4e87-b4ea-05895cff2c54",
  "reaction": "👍"
}

Выходные параметры

Название Тип данных Описание
result.row_affected Int64 Количество фактически изменённых записей
result.ids Array of String UUID сообщений, где изменились реакции текущего пользователя

Пример ответа

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": ["9beec41f-6ef5-4e87-b4ea-05895cff2c54"]
  }
}