метод REST scope: im

im.notify.get

Получить уведомления

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

Описание

Метод im.notify.get возвращает список уведомлений пользователя частями. Следующая часть запрашивается через LAST_ID и LAST_TYPE.

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

Параметры

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

Идентификатор последнего уведомления предыдущей страницы для загрузки следующей. Обычно берется из поля id последнего элемента массива notifications в ответе предыдущего шага выборки или в ответе im.notify.history.search

Идентификатор уведомления также возвращают методы im.notify, im.notify.personal.add и im.notify.system.add.

Параметр нужно использовать вместе с LAST_TYPE

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

Технический курсор пагинации.

Допустимые значения:
- 1 — продолжить выборку с этапа подтверждений
- 3 — продолжить выборку с этапа обычных уведомлений

Параметр нужно использовать вместе с LAST_ID.

Для значений, отличных от 1 и 3, сервер не возвращает отдельную ошибку

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

Количество уведомлений на страницу. Значение по умолчанию — 50. Максимальное значение — 50

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

Преобразовать текст уведомлений. Значение Y включает преобразование, любое другое значение отключает

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"LAST_ID":1500,"LAST_TYPE":3,"LIMIT":20,"CONVERT_TEXT":"Y"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.notify.get

Ответ

HTTP-статус: 200

{
    "result": {
        "total_count": 120,
        "total_unread_count": 5,
        "chat_id": 77,
        "notifications": [
            {
                "id": 1500,
                "chat_id": 77,
                "author_id": 1,
                "date": "2026-03-03T09:00:00+00:00",
                "notify_type": 2,
                "notify_module": "rest",
                "notify_event": "rest_notify",
                "notify_tag": "MP|12345|TASK_42",
                "notify_sub_tag": "MP|12345|TASK|42",
                "notify_title": "",
                "setting_name": "rest|rest_notify",
                "text": "Напоминание",
                "notify_read": "N",
                "params": null
            }
        ],
        "users": [
            {
                "id": 1,
                "active":true,
                "name": "Иван Петров",
                "first_name":"Иван",
                "last_name":"Петров",
                "work_position":"",
                "color":"#1eb4aa",
                "avatar":"https://example.bitrix24.ru/upload/main/avatar.png",
                "avatar_hr":"https://example.bitrix24.ru/upload/main/avatar.png",
                "gender":"M",
                "birthday":"15-05",
                "extranet":false,
                "network":false,
                "bot":false,
                "connector":false,
                "external_auth_id":"socservices",
                "status":"online",
                "idle":false,
                "last_activity_date":"2026-03-03T15:04:20+03:00",
                "mobile_last_date":false,
                "desktop_last_date":false,
                "absent":false,
                "departments":[1],
                "phones":{
                    "work_phone":"+71234567890",
                    "inner_phone":"22"
                },
                "bot_data":null,
                "type":"user",
                "website":"example.ru",
                "email":"ivan@example.ru"
            }
        ]
    },
    "time": {
        "start": 1760000000.0,
        "finish": 1760000000.1,
        "duration": 0.1,
        "processing": 0.04,
        "date_start": "2026-03-03T10:00:00+03:00",
        "date_finish": "2026-03-03T10:00:00+03:00",
        "operating_reset_at": 1760030000,
        "operating": 0
    }
}

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

result object

Объект с данными уведомлений.

Структура объекта подробно описана ниже

time time

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

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

HTTP-статус: 400

{
    "error": "LAST_ID_AND_LAST_TYPE",
    "error_description": "Parameters LAST_ID and LAST_TYPE should be used together."
}
Код Описание Значение
LAST_ID_AND_LAST_TYPE Parameters LAST_ID and LAST_TYPE should be used together Передан только один параметр из пары LAST_ID и LAST_TYPE
LAST_ID_STRING Last notification ID can't be string Параметр LAST_ID содержит нечисловое значение

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

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