метод REST scope: im

im.notify.history.search

Поиск по истории уведомлений

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

Описание

Метод im.notify.history.search выполняет поиск по истории уведомлений пользователя.

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

Параметры

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

Текст поиска. Если SEARCH_TYPE и SEARCH_DATE не заданы, длина строки должна быть не меньше 3 символов

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

Фильтр по типу уведомления в формате MODULE или ``MODULE|EVENT``. Готовые значения можно получить методом im.notify.schema.get

SEARCH_TYPES array необязательный

Массив фильтров по типам уведомлений в формате MODULE или ``MODULE|EVENT``

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

Фильтр по дате в формате ISO 8601 (RFC3339)

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

Начало диапазона дат в формате ISO 8601 (RFC3339). Используется вместе с SEARCH_DATE_TO

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

Конец диапазона дат в формате ISO 8601 (RFC3339). Используется вместе с SEARCH_DATE_FROM

SEARCH_AUTHORS array необязательный

Массив идентификаторов авторов уведомлений для фильтрации

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

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

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

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

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

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

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

Групповой тег уведомлений для дополнительной фильтрации

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"SEARCH_TEXT":"счет","SEARCH_TYPE":"tasks|task_update","SEARCH_DATE":"2026-03-03T16:52:29+03:00","LAST_ID":1500,"LIMIT":20,"CONVERT_TEXT":"Y","GROUP_TAG":"TASK|42"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.notify.history.search

Ответ

HTTP-статус: 200

{
    "result": {
        "chat_id": 77,
        "total_results": 1,
        "notifications": [
            {
                "id": 1500,
                "chat_id": 77,
                "author_id": 1,
                "date": "2026-03-03T09:00:00+00:00",
                "notify_type": 2,
                "notify_module": "tasks",
                "notify_event": "task_update",
                "notify_tag": "TASK|42",
                "notify_sub_tag": "",
                "notify_title": "",
                "setting_name": "tasks|task_update",
                "text": "счет",
                "notify_read": "Y",
                "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-04T15: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-04T16:00:00+03:00",
        "date_finish": "2026-03-04T16:00:00+03:00",
        "operating_reset_at": 1760030000,
        "operating": 0
    }
}

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

result object

Объект с результатом поиска.

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

time time

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

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

HTTP-статус: 400

{
    "error": "SEARCH_TEXT_ERROR",
    "error_description": "SEARCH_TEXT can't be less then 3 symbols"
}
Код Описание Значение
SEARCH_TEXT_ERROR SEARCH_TEXT can't be less then 3 symbols Ошибка возникает, если не заданы SEARCH_TYPE, SEARCH_DATE, SEARCH_TYPES, SEARCH_AUTHORS, пара SEARCH_DATE_FROM и SEARCH_DATE_TO, а длина SEARCH_TEXT меньше 3
LAST_ID_STRING Last notification ID can't be string Параметр LAST_ID содержит нечисловое значение

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

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