метод REST scope: im

im.counters.get

Получить счетчики

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

Описание

Метод im.counters.get получает счетчики непрочитанных сообщений и уведомлений для текущего пользователя.

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.counters.get

Ответ

HTTP-статус: 200

{
    "result": {
        "TYPE": {
            "ALL": 5,
            "NOTIFY": 4,
            "CHAT": 0,
            "LINES": 0,
            "DIALOG": 1,
            "MESSENGER": 1
        },
        "CHAT": [],
        "CHAT_MUTED": {
            "1317": 1,
            "1319": 1
        },
        "CHAT_UNREAD": [],
        "LINES": [],
        "DIALOG": {
            "547": 1
        },
        "DIALOG_UNREAD": []
    },
    "time": {
        "start": 1772010465,
        "finish": 1772010465.508917,
        "duration": 0.5089170932769775,
        "processing": 0,
        "date_start": "2026-02-25T12:07:45+03:00",
        "date_finish": "2026-02-25T12:07:45+03:00",
        "operating_reset_at": 1772011065,
        "operating": 0
    }
}

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

result object

Корневой объект со счетчиками

TYPE object

Суммарные счетчики по типам (подробное описание)

CHAT array

Счетчики по чатам. Ключ — идентификатор чата, значение — количество непрочитанных сообщений

CHAT_MUTED object

Счетчики по чатам с отключенными уведомлениями. Ключ — идентификатор чата, значение — количество непрочитанных сообщений

CHAT_UNREAD array

Счетчики по чатам с установленной меткой «Не прочитано»

LINES array

Счетчики по чатам открытых линий

DIALOG object

Счетчики по диалогам один-на-один. Ключ — идентификатор пользователя, значение — количество непрочитанных сообщений

DIALOG_UNREAD array

Счетчики по диалогам один-на-один с установленной ручной меткой «Не прочитано»

time time

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

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

HTTP-статус: 401

{
    "error": "INVALID_CREDENTIALS",
    "error_description": "Invalid request credentials"
}

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

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