Как подключить Вайбкод к коробочному Битрикс24

Коробочный Битрикс24 работает с Вайбкодом наравне с облачным, но подключение делает администратор руками. Нужны права администратора, действующая лицензия, установленные модули мессенджера и REST, исходящий доступ к платформе и внешний адрес портала.

Порядок подключения

1. Откройте настройки продукта, раздел модулей, и установите модуль интеграции с Битрикс24 Вайбкод. Он в статусе беты, поэтому установка попросит подтвердить согласие с условиями.
2. Перейдите в настройки модуля и проверьте, что включены видимость на портале и открытие приложений внутри Битрикс24.
3. Сверьте адрес сервера платформы в поле добавления, нажмите регистрацию и сохраните изменения. Новая привязка появится в списке.
4. Выйдите из административного раздела на публичную часть и откройте мессенджер: в левом верхнем углу появится значок каталога приложений.
5. Нажмите начать работу, войдите через Битрикс24 и подключите коробочную версию, указав внешний адрес своего портала.
6. Проверьте связь на странице диагностики модуля: при успешном обмене появится подтверждение.

Где чаще всего спотыкаются

Первое: привязка к лицензионному ключу. Модуль подключается к одному Битрикс24 на ключ, и если у вас боевой и тестовый контуры на одной лицензии, Вайбкод заработает только в одном. Для переезда сначала снимают текущую привязку, иначе модуль даже не даст себя удалить.

Второе: сетевой доступ. Нужен не только исходящий доступ от портала к платформе, но и обратная доступность: платформа сама обращается к Битрикс24. Коробка за корпоративным периметром без внешнего имени подключение не пройдёт, и чинить это придётся на стороне инфраструктуры.

Третье: источник прав. В настройках модуля есть переключатель, который определяет, кто решает, кому создавать ключи и приложения: платформа или сам Битрикс24. Если выбрать платформу, модуль будет выдавать ключи даже там, где настройки безопасности портала ограничивают выпуск вебхуков. Права на стороне платформы лучше настроить до того, как включать этот режим.

Если регистрация не прошла

Сообщение о неподтверждённой лицензии означает, что коробка заблокирована на лицензионном сервисе: сначала разбираемся с лицензией, потом повторяем регистрацию. Жалоба на несовместимость версии лечится обновлением модуля. Если платформа отвечает, что адрес не подходит, проверьте, что он указан полностью, вместе со схемой. Временную недоступность лицензионного сервиса достаточно переждать минуту.

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

Что даёт платформа после подключения, разобрали в материале Битрикс24 Вайбкод. Отличия облака и коробки собрали в сравнении облако или коробка.