Битрикс24 Вайбкод в коробочной версии: подключение модуля vibecodeconnector

Битрикс24 Вайбкод работает и в облаке, и в коробочной версии Битрикс24. Подключение коробочной версии состоит из трех частей:

  • установить модуль «Интеграция с Битрикс24 Вайбкод»,

  • зарегистрировать в Битрикс24 Вайбкод-сервер,

  • подключить коробочный Битрикс24 в кабинете Вайбкод.

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

Модуль «Интеграция с Битрикс24 Вайбкод» можно подключить только в одном Битрикс24. Если один лицензионный ключ используется в нескольких Битрикс24, например, основном и тестовом, Вайбкод заработает только в одном из них. Чтобы перенести подключение на другой Битрикс24, сначала снимите текущее — Отключить Вайбкод.

Что нужно для подключения

  • Права администратора. Модуль устанавливает и настраивает администратор Битрикс24.

  • Действующая лицензия. При регистрации лицензия коробочной версии проверяется на лицензионном сервисе Битрикс24.

  • Установленные модули im и rest. Без них не заработают каталог в Мессенджере и ключи для приложений.

  • Исходящий доступ к https://vibecode.bitrix24.tech. По этому адресу Битрикс24 обращается к платформе.

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

Подключить Битрикс24 к Вайбкод

  1. Перейдите на страницу Настройки > Настройки продукта > Модули и установите модуль «Интеграция с Битрикс24 Вайбкод» — технический код vibecodeconnector. Модуль в статусе бета-версии, поэтому установка просит подтвердить согласие с условиями.

  2. Нажмите «Открыть настройки модуля».

  3. После установки включены настройки «Видимость на портале» и «Открывать приложения внутри Битрикс24» — проверьте, что их не выключили.

  4. В поле «Добавить Битрикс24 Вайбкод-сервер» уже подставлен адрес https://vibecode.bitrix24.tech — сверьте его и нажмите «Зарегистрировать». Новая привязка появится в списке «Привязки к Битрикс24 Вайбкод-серверам».

  5. Сохраните изменения.

  6. Перейдите из административного раздела на публичную часть — вкладка Сайт. В Мессенджере нажмите на появившийся значок каталога в левом верхнем углу и выберите «Начать».

  7. На открывшейся странице Битрикс24 Вайбкод нажмите «Войти через Битрикс24» и авторизуйтесь.

  8. Нажмите «Подключить коробочную версию Битрикс24», вставьте адрес коробочного Битрикс24 и нажмите «Подключить».

Пользовательская документация

Подключение Битрикс24 Вайбкод в коробочной версии — пошагово со скриншотами

Как проверить подключение

  1. Откройте страницу Сервисы > Интеграция с Битрикс24 Вайбкод > Диагностика, на вкладке «Проверка соединения» выберите сервер и нажмите «Проверить». Если обе стороны видят друг друга, появится сообщение «Связь подтверждена».

  2. Откройте Мессенджер и убедитесь, что значок каталога на месте, а каталог открывается.

Если связь не подтвердилась, откройте на той же странице вкладку «Состояние и ссылки» — там состояние привязок и ссылка на журнал входящих запросов Вайбкод. По журналу видно, дошли ли запросы до Битрикс24 и какие из них отклонены.

Отметка «Просрочен» в списке привязок — не ошибка: Битрикс24 обновляет данные Вайбкод-сервера сам, а кнопка «Обновить» делает это сразу.

Настройки модуля

Страница настроек — Сервисы > Интеграция с Битрикс24 Вайбкод > Настройки.

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

  • Открывать приложения внутри Битрикс24 — открывает приложения из каталога в слайдере Битрикс24.

  • Источник прав — Вайбкод-сервер — определяет, кто решает, кому создавать ключи Вайбкод и приложения. Включено — права берутся у Вайбкод-сервера, и модуль выдает ключи, даже если настройки безопасности Битрикс24 ограничивают выпуск входящих вебхуков. Выключено — создание подчиняется правам Битрикс24.

  • Активное подключение к Битрикс24 Вайбкод — задает сервер, с которым работает Битрикс24, если серверов зарегистрировано несколько.

  • Максимальный TTL публичного ключа, сек — служебная настройка, по умолчанию 604 800 секунд. Менять ее при обычном подключении не нужно.

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

Ошибки при регистрации

Модуль показывает сообщения:

  • Лицензия не подтвердилась — коробочная версия заблокирована на лицензионном сервисе. Проверьте состояние лицензии и повторите регистрацию.

  • Лицензионный сервис временно недоступен — повторите через минуту.

  • Версия модуля несовместима с сервером Битрикс24 Вайбкод — обновите модуль vibecodeconnector.

  • Адрес не подходит — укажите полный адрес сервера со схемой http:// или https://.

  • Ответ Битрикс24 Вайбкод не содержит обязательные поля — обратитесь в поддержку.

Отключить Вайбкод

Удалите привязку кнопкой «Удалить» в списке привязок. Битрикс24 снимет регистрацию на стороне Вайбкод и отключит каталог. Пока зарегистрирована хотя бы одна привязка, модуль удалить нельзя — операция прерывается сообщением о действующей регистрации.

Что дальше

Предыдущая
Совместная работа над приложением
Следующая
MCP-сервер для AI