Для разработчиков

Отметка чата прочитанным

PUT/chats/{id}/read

Отмечает чат прочитанным для владельца токена до последнего сообщения на момент запроса, как если дочитать его до конца в интерфейсе. Прочитанными станут и сообщения, пришедшие уже после того, как вы получили историю. Чтобы оставить новые сообщения непрочитанными, после вызова отметьте чат методом PUTОтметка чата непрочитанным.

Метод обнуляет счётчик непрочитанного и снимает отметку непрочитанного упоминания «@» и ручную отметку «Непрочитанное». Чат пропадает из непрочитанных чатов, а тред из непрочитанных тредов. Так же это работает в архивном чате и с выключенными уведомлениями, и ни архив, ни уведомления метод не меняет. Треды чата — отдельные чаты: каждый тред отмечают по его chat_id.

Остальные участники видят свои сообщения прочитанными, а владелец токена появляется в GETСписке прочитавших сообщение у всех сообщений до конца чата. С персональным токеном это выглядит так, будто чат прочитал сам сотрудник. С токеном бота чат отмечается прочитанным для бота, и авторы увидят «Прочитано», даже если сообщения не открыл ни один сотрудник. Отправка сообщения тоже двигает позицию чтения, но «Прочитано» у чужих сообщений появляется только после этого метода.

В ответе приходит last_read_message_id, позиция чтения после вызова. В чате без сообщений она null, и метод ничего не меняет. Повторный запрос ничего не меняет и не рассылает событие о прочтении повторно.

Работает в беседах, каналах, личных чатах и тредах, где владелец токена состоит, и никуда его не добавляет: тред передают его chat_id. Открытый чат или доступный тред, где владелец токена не состоит, и чат другого пространства отвечают 404. Закрытый чат, где владелец токена не состоит, отвечает 403, в том числе владельцу и администраторам пространства. 403 отвечают и недоступный тред, и открытый чат, где не состоит мульти-гость. У метода свой лимит на частоту запросов.

Параметры пути

id
integer, (int32)
*
Идентификатор чата (беседы, канала, личного чата или чата треда)
Пример:334

Ответ

200OK
The request has succeeded.
data
object
*
Позиция чтения владельца токена в чате
last_read_message_id
nullableinteger, (int32)
*
Идентификатор последнего прочитанного сообщения. null, если в чате нет сообщений. Последнее сообщение чата учитывается, даже если его удалили, поэтому это может быть идентификатор удалённого сообщения, которого нет в списке сообщений.
Пример:1194275
Отметка чата прочитанным
pachca chats mark-read 334 \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 200
{  "data": {    "last_read_message_id": 1194275  }}