Установка приложения интегратора

Открыть в Маркетплейсе Битрикс24

1. Что понадобится

• портал Битрикс24 — облачный или коробочный (для коробки нужен модуль «rest» версии 21.600.0 или новее);
• права администратора портала (установка приложений из Маркетплейса);
• аккаунт на платформе БИК — регистрируется бесплатно, с пробным периодом 7 дней.

2. Регистрация на платформе

Создайте аккаунт на странице Регистрация: укажите название компании, почту и пароль. Подтвердите адрес по ссылке из письма.

После регистрации в личном кабинете появится код привязки — он понадобится на шаге 4, чтобы связать портал Битрикс24 с вашим аккаунтом.

3. Установка приложения

1. Откройте на своём портале раздел Приложения → Маркетплейс.
2. Найдите приложение «БИК — Интегратор» и нажмите «Установить».
3. Подтвердите запрашиваемые права. Приложению нужен доступ к задачам, чатам, диску и пользователям — без него синхронизация невозможна.

Состав запрашиваемых прав и зачем нужен каждый — на странице приложения «БИК — Интегратор».

Битрикс24 сообщит платформе об установке, и БИК сохранит токены доступа к порталу. Пароль администратора платформе не передаётся — используется стандартная авторизация OAuth Битрикс24.

4. Привязка портала к аккаунту

Откройте установленное приложение на портале. На стартовой странице введите код привязки из личного кабинета и подтвердите.

После привязки портал появится в кабинете на платформе, а в самом приложении откроется панель управления.

5. Панель управления

Панель доступна двумя способами и показывает одно и то же:

• внутри Битрикс24 — плитка приложения на вашем портале;
• в личном кабинете на bic-24.ru — там же биллинг, баланс, счета и API-токены.

Основные разделы: «Порталы» (клиенты и их состояние), «Маппинги» (какие проекты синхронизируются), «Чаты» (Открытые линии), «Здоровье» (очередь и нагрузка).

6. Что дальше

1. Пригласите клиента — сгенерируйте код-приглашение и передайте его. Порядок описан в разделе Установка приложения клиента.
2. Настройте маппинг проектов: какой проект на портале клиента синхронизируется с каким проектом у вас.
3. Пополните баланс до окончания пробного периода, иначе синхронизация приостановится (данные при этом сохраняются).

7. Коробочный портал интегратора

Коробочный портал должен работать на модуле «rest» версии 21.600.0 или новее: более ранние сборки не поддерживают минимальную версию прав «Пользователи», которую запрашивает приложение, и установка не пройдёт.

Если ваш Битрикс24 развёрнут «на коробке», приложение ставится так же, но дополнительно доступен режим Local App: на сервер портала разворачивается локальный модуль, и операции выполняются внутри процесса Битрикс24 — минуя ограничение облачного REST в 2 запроса в секунду. Это заметно ускоряет синхронизацию больших проектов.

Режим включается в панели управления в разделе «Порталы», а модуль разворачивается на сервере портала — порядок описан в разделе Установка Local App.

8. Если что-то пошло не так

• Приложение не открывается после установки — обновите страницу портала; Битрикс24 иногда кеширует список приложений.
• Портал не появился в кабинете — значит код привязки не введён (шаг 4) либо введён в другом аккаунте.
• Задачи не синхронизируются — проверьте, что маппинг проектов настроен и подписка активна (раздел «Биллинг»).