Callback установки

Когда в карточке приложения не указывается опция "Добавлять свою страницу и пункт в главном меню", это означает, что у него нет базового интерфейса в левом меню. Такое приложение все равно может зарегистрировать виджеты в различных местах встройки, но автоматически, сам по себе, пункт в левом меню добавлен не будет.

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

Тем не менее, несмотря на отсутствие пользовательского интерфейса, таким приложениям все равно нужно получить токены авторизации. И для этого как раз и нужен callback-обработчик, путь к которому нужно указать в поле "Ссылка на обработчик события установки".

Тогда, сразу после добавления локального приложения, Битрикс24 автоматически обратится к этому URL и передаст туда POST-запрос с данными авторизации OAuth 2.0, включая acces-token и refresh-token.

Предполагается, что приложение должно сохранить эти токены на своей стороне, чтобы в дальнейшем обновлять access-токен по мере необходимости.

В случае callback-обработчика установки, приложение также не должно вызывать JS-метод BX24.installFinish() как это нужно делать для локальных приложений с мастером установки.

Впрочем, даже если попытаться это сделать, то ничего не получится, поскольку это JS-метод библиотеки, которая работает только в рамках фреймов интерфейса приложения в браузере, а callback-обработчик приложения вызывается с backend Битрикс24. Никакой браузер в этом процессе не участвует.

Подробнее про процесс создания callback-приложения с мастером настройки вы можете прочитать здесь