25.03.2026 15:10

MarkRead

[POST] .../v1/chatmessage/markread

Отмечает сообщения чата как прочитанные для текущего пользователя.

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

Название Тип данных Обязательность Описание
chat_id String Обязательный UUID чата

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

  • chat_id обязателен и должен быть корректным UUID чата.
  • Метод работает только для текущего пользователя (из текущей сессии API).
  • Для обычных чатов проверяется право chat_message_select (684).
  • Для чатов, связанных с Lead/Deal/Ticket/Task, доступ наследуется от сущности: Select у сущности заменяет chat_message_select.
  • Закрытие чата (closed = true) не блокирует чтение и отметку прочитанности.
  • Помечаются только непрочитанные и не удаленные сообщения текущего пользователя.
  • Staff-ограниченные сообщения (Private и System с action_code = StaffNoticeAdded) помечаются как прочитанные только пользователям, которым разрешен их просмотр.
  • Для пользователя с правом chat_manage_all (688) без участия в чате история прочтения не ведется: метод возвращает row_affected = 0.

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

{
  "chat_id": "6f6fdb2f-7d0b-4c34-b6fd-1fbcf40d37ef"
}

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

Название Тип данных Описание
result.row_affected Int64 Количество измененных строк

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

{
  "ok": true,
  "result": {
    "row_affected": 12,
    "ids": null
  }
}