Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Событие после успешной установки приложения OnAppInstall». Вы узнаете экспертные методики работы с битрикс и научитесь избегать типичных ошибок начинающих разработчиков.

Событие после успешной установки приложения OnAppInstall

> Scope: базовый
>
> Кто может подписаться: любой пользователь

Событие OnAppInstall вызывается сразу после успешной установки приложения на Битрикс24. В обработчик передается application_token, который важно сохранить. Подробнее читайте в статье [](../../events/safe-event-handlers).

События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения

Что получает обработчик

Данные передаются в виде POST-запроса {.b24-info}

array(
    'event' => 'ONAPPINSTALL',
    'data' => array(
        'VERSION' => '1.0.0',
        'ACTIVE' => 'Y',
        'INSTALLED' => 'Y',
        'LANGUAGE_ID' => 'ru'
    ),
    'ts' => '1696527000',
    'auth' => array(
        'domain' => 'some-domain.bitrix24.ru',
        'server_endpoint' => 'https://oauth.bitrix24.tech/rest/',   
        'status' => 'F',
        'client_endpoint' => 'https://some-domain.bitrix24.ru/rest/',   
        'member_id' => 'a223c6b3710f85df22e9377d6c4f7553',
        'application_token' => '51856fefc120afa4b628cc82d3935cce',        
    ),
)

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

Параметр data {#data}

Параметр auth {#auth}

Обработчик данного события можно установить в установочном скрипте приложения, который указывается в карточке версии в отдельном поле.

• [](../../events/index)
• [](../../events/event-bind)
• [](./on-app-payment)
• [](./on-app-method-confirm)
• [](./on-user-add)
• [](./on-app-uninstall)