Как открыть сайт приложением в Битрикс24

1. Создайте раздел, например /b24, с модулем app_b24 и доступом «Всем».
2. Откройте его страницу как администратор. В блоке «Адреса для настроек приложения» есть «Путь вашего обработчика» и «Путь для первоначальной установки».
3. На портале: Разработчикам → Другое → Локальное приложение, тип «Серверное». Галочку «Использует только API» не ставьте. Вставьте оба адреса, придумайте название пункта меню и сохраните.
4. Скопируйте «Код приложения (client_id)» и «Ключ приложения (client_secret)» в «Настройки модуля»: поля «client_id (код приложения)» и «client_secret (ключ приложения)».
5. На странице раздела нажмите «Проверить ключи и связь с Битрикс24».
6. Выберите «Куда попадает пользователь после входа» и нажмите «Сохранить».
7. Откройте приложение в левом меню портала. Установка пройдёт сама.

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

Платёжные страницы внутри портала не работают. Поэтому страницы из поля «Страницы, которые открываются в новой вкладке» (по умолчанию /finance) заменяются кнопкой. Она открывает ту же страницу в новой вкладке, и человек уже вошёл на сайт. Чтобы пускать только свой портал, впишите его адрес в «Только эти порталы (необязательно)».

Приложение можно опубликовать и в Маркете Битрикс24 — для этого нужен статус партнёра-разработчика. Ключи тогда берутся в кабинете вендора, кнопка «Протестировать».

Если не получилось

• Не удаётся подтвердить вход из Битрикс24. Чаще всего ключи взяты от другого приложения или скопированы с пробелом. Проверьте их кнопкой «Проверить ключи и связь с Битрикс24». Если окно приложения было открыто давно, обновите страницу портала.
• Вход не сохраняется. Сайт открывается внутри портала, а Safari на компьютере и Firefox в строгом режиме такой вход не держат. Chrome, Яндекс Браузер, Edge и приложения Битрикс24 работают.