метод REST scope: im

im.dialog.read

Установить признак «прочитано» у сообщений

Кто может выполнять: любой пользователь

Описание

Метод im.dialog.read устанавливает признак «прочитано» для сообщений диалога до указанного сообщения включительно.

Параметры

DIALOG_ID string обязательный

Идентификатор чата в формате:

  • chatXXX — чат
  • sgXXX — чат группы или проекта
  • XXX — идентификатор пользователя личного чата

Идентификатор чата можно получить с помощью метода im.chat.get. Идентификатор пользователя — с помощью методов user.get и user.search

MESSAGE_ID integer необязательный

Идентификатор последнего прочитанного сообщения. Если не передан — метод устанавливает признак прочтения для всех непрочитанных сообщений

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"DIALOG_ID":"chat1489","MESSAGE_ID":84875}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.dialog.read

Ответ

HTTP-статус: 200

{
    "result": {
        "dialogId": "chat1489",
        "chatId": 1489,
        "lastId": 84875,
        "counter": 3
    },
    "time": {
        "start": 1772624912,
        "finish": 1772624912.615753,
        "duration": 0.6157529354095459,
        "processing": 0,
        "date_start": "2026-03-04T14:48:32+03:00",
        "date_finish": "2026-03-04T14:48:32+03:00",
        "operating_reset_at": 1772625512,
        "operating": 0
    }
}

Возвращаемые данные

result object

Корневой элемент ответа (подробное описание).

Возвращает false, если у пользователя нет доступа к чату

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "DIALOG_ID_EMPTY",
    "error_description": "Dialog ID can't be empty"
}
Код Описание Значение
400 DIALOG_ID_EMPTY Dialog ID can't be empty

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.