# onOfflineEvent

URL: https://chugunov.pro/api-bitrix24/events/on-offline-event/
Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c).
Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является.

Событие при появлении новых записей в очереди офлайн-событий
Scope: `базовый`
Кто может подписаться: любой пользователь

## Описание

Событие `ONOFFLINEEVENT` сработает, когда в очереди [офлайн-событий](https://chugunov.pro/api-bitrix24/events/offline-events/) появятся новые записи.

Событие заменяет опрос очереди по таймеру: приложение получает сигнал и забирает накопленные записи методами [event.offline.get](https://chugunov.pro/api-bitrix24/events/event-offline-get/) или [event.offline.list](https://chugunov.pro/api-bitrix24/events/event-offline-list/).

Подписывайтесь на `ONOFFLINEEVENT` только как на обычное событие — с URL обработчика в параметре `handler` метода [event.bind](https://chugunov.pro/api-bitrix24/events/event-bind/). Подписка с `event_type = offline` возвращает ошибку `ERROR_ARGUMENT` с текстом `Offline event cannot be registered for this event`: само уведомление об очереди в очередь не складывается.

Подписаться может любой пользователь, но только из приложения: `event.bind` работает лишь с авторизацией OAuth 2.0 и отклоняет вызов вебхука. Забрать записи из очереди методами `event.offline.*` может только администратор и тоже только в контексте приложения. Подробнее в статье [event.offline.get](https://chugunov.pro/api-bitrix24/events/offline-events/).

События не будут отправляться в приложение, пока установка не завершена. [Проверьте установку приложения](https://apidocs.bitrix24.ru/settings/app-installation/installation-finish.html)

## Параметры

- `event` `string` — обязательный. Символьный код события — `ONOFFLINEEVENT`
- `event_handler_id` `integer` — обязательный. Идентификатор обработчика события
- `data` `array` — обязательный. Приходит пустым.
  Подробнее [ниже](#data)
- `ts` `timestamp` — обязательный. Дата и время отправки уведомления из общей [очереди событий](https://chugunov.pro/api-bitrix24/events/)
- `auth` `object` — обязательный. Объект, содержащий параметры авторизации и данные о Битрикс24, на котором произошло событие.
  Значение `scope` — список прав, выданных приложению. Событие базовое и не требует отдельного скоупа.
  Структура описана [ниже](#auth)

Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/events/on-offline-event.html