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

Открыть в Маркетплейсе Bitrix24

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

• портал Bitrix24 — облачный или коробочный;
• права администратора портала (установка приложений из Маркетплейса);
• аккаунт на платформе BIC — регистрируется бесплатно, с пробным периодом 7 дней.

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

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

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

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

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

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

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

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

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

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

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

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

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

6. Что дальше

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

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

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

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

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

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