#Подключение self-hosted Битрикс24

Self-hosted (коробочный) Битрикс24 — это Битрикс24, который заказчик разворачивает на своём сервере, а не в облаке bitrix24.{ru,de,com,kz,by}. Чтобы Вайбкод мог работать с таким порталом — обращаться к CRM, задачам, ботам, выписывать вебхуки — нужен личный developer-key на стороне self-hosted Битрикс24.

С 2026-05-11 подключение делается в два клика, через бот-компаньон. Раньше нужно было просить администратора self-hosted Битрикс24 вручную выписать developer-key и копипастить URL вебхука на платформу — этот сценарий удалён.

#Как это работает

Подключение делается один раз для портала + по одному клику для каждого пользователя.

#Шаг 1. Администратор self-hosted Битрикс24 — один раз для портала

Этот шаг делает любой пользователь self-hosted Битрикс24 с ролью администратора.

  1. Откройте административный интерфейс self-hosted Битрикс24
  2. Установите модуль VibeCode Connector (если ещё не установлен) — он бесплатный, доступен в разделе модулей Битрикс24
  3. Откройте настройки модуля
  4. Нажмите кнопку «Подключить портал к Вайбкоду»
  5. Дождитесь окончания процесса (обычно 5–15 секунд) — модуль зарегистрирует портал на Вайбкоде, выпишет admin developer-key, установит приложение vibecode и зарегистрирует бот-компаньон

Этот шаг делается один раз на портал. После этого любой пользователь self-hosted Битрикс24 может подключить себя к Вайбкоду через шаг 2 — повторно дёргать админа уже не нужно.

#Шаг 2. Пользователь Вайбкода — один клик

После того как администратор сделал шаг 1, любой пользователь Вайбкода (включая самого администратора) может подключить свою учётную запись self-hosted Битрикс24.

  1. Откройте Вайбкод, перейдите в раздел Порталы
  2. Нажмите «Подключить self-hosted Битрикс24»
  3. Введите адрес self-hosted Битрикс24 (например, mybox.example.com) и нажмите «Продолжить»
  4. Вайбкод проверит, что портал зарегистрирован, и покажет ссылку «Открыть бот в self-hosted Битрикс24»
  5. Нажмите ссылку — откроется чат с бот-компаньоном Вайбкода в вашем self-hosted Битрикс24
  6. Бот покажет карточку с вашим именем и email из Вайбкода и две кнопки: «Да, это я» / «Нет, это не я»
  7. Нажмите «Да, это я» — Вайбкод выпишет ваш личный developer-key и автоматически перенаправит вас на дашборд портала

Готово. С этого момента ваши скрипты, агенты и приложения на Вайбкоде могут обращаться к этому self-hosted Битрикс24 от вашего имени.

#Состояния мастера подключения

При подключении мастер на стороне Вайбкода проходит через несколько состояний:

Состояние Что видит пользователь Что происходит
A — ввод адреса Поле «Адрес self-hosted Битрикс24» Пользователь указывает домен
B — открыт бот Ссылка «Открыть бот в self-hosted Битрикс24», ссылка действительна 10 минут Pair-code создан, ждём подтверждения в боте
C — успех «self-hosted Битрикс24 подключён», auto-redirect Пользователь нажал «Да» в боте, developer-key выписан
D — портал не зарегистрирован «Вайбкод не знает этот self-hosted Битрикс24» с инструкцией шага 1 Модуль vibecodeconnector ещё не активирован — попросите администратора
E — отклонено / истекло «Подтверждение отклонено» или «Код подтверждения истёк» Пользователь нажал «Нет» в боте, либо прошло 10 минут — можно начать заново

#Что делать в типичных ситуациях

#«Вайбкод не знает этот self-hosted Битрикс24» (состояние D)

Этот портал ещё не зарегистрирован на платформе. Попросите администратора self-hosted Битрикс24 выполнить шаг 1: установить модуль vibecodeconnector и нажать «Подключить портал к Вайбкоду». После этого вернитесь на Вайбкод и нажмите кнопку «Я подключил — повторить».

#Бот пишет «Запрос на привязку отклонён» — а вы ничего не отклоняли

Возможно, кто-то другой пытается привязать ваш self-hosted Битрикс24 к своей учётной записи на Вайбкоде. Если запрос пришёл неожиданно — это правильно, что вы нажали «Нет». Сообщите администратору self-hosted Битрикс24: возможно, идёт попытка социальной инженерии.

#Бот пишет «Код подтверждения истёк» — пропустил 10 минут

Pair-code действует 10 минут. Если не успели — просто откройте Вайбкод, нажмите «Подключить self-hosted Битрикс24» и пройдите процесс заново.

#«Кнопка устарела» — нажимаю «Да», а ничего не происходит

Скорее всего, вы повторно открыли старое сообщение от бота — за это время уже создан новый pair-code (например, если открывали Вайбкод в нескольких вкладках). Откройте Вайбкод, проверьте, что мастер показывает свежий pair-code, и нажмите ссылку «Открыть бот в self-hosted Битрикс24» заново.

#Кнопка «Подключить self-hosted Битрикс24» не появляется

Функция раскатывается постепенно. Если в вашем личном кабинете кнопки нет — возможно, функция полностью выключена (off) на стороне платформы; обратитесь к администратору платформы.

В режиме pilot кнопка видна всем пользователям с пометкой «бета» рядом, а внутри окна подключения отображается информационный баннер «доступно ограниченному количеству порталов» — это значит, что фича работает, но мы пока разворачиваем её плавно. В режиме on кнопка отображается так же, без значка и баннера.

#Бот не появился в моём self-hosted Битрикс24

После шага 1 модуль vibecodeconnector регистрирует бот-компаньона автоматически. Если бот не появился, возможно произошла ошибка на одном из шагов активации (mint admin-key / install app / register bot). Администратор self-hosted Битрикс24 может повторно нажать «Подключить портал к Вайбкоду» — процесс идемпотентен, повторное нажатие пройдёт только те шаги, которые упали.

#Безопасность

  • Карточка инициатора в боте — это защитный механизм, а не косметика. Бот всегда показывает имя и email пользователя Вайбкода, который запросил привязку. Если вы не узнаёте этого пользователя — нажмите «Нет, это не я», и developer-key не будет выписан.
  • Pair-code действует 10 минут и одноразовый — после подтверждения он сразу аннулируется. Перехват ссылки бесполезен через 10 минут или после первого подтверждения.
  • Developer-key хранится зашифрованным. В API-ответах всегда возвращается только подсказка (последние 4 символа), сам ключ не отдаётся ни одному клиенту.
  • SSRF-защита. Адреса вида localhost, 127.0.0.1, IP-литералы и приватные диапазоны отвергаются на этапе ввода — Вайбкод не разрешает указать вместо self-hosted Битрикс24 свой собственный backend.

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

Подключённый self-hosted Битрикс24 ведёт себя так же, как cloud-портал:

  • Создавайте API-ключи в разделе Ключи API — они работают через те же эндпоинты /v1/*
  • Создавайте OAuth-приложения в разделе Приложения — пользователи получают свой developer-key автоматически по такому же bot-pairing процессу
  • Запускайте AI-агентов и AI Router — для self-hosted порталов работают те же модели и пайплайны
  • Используйте веб-поиск, билинг, аналитику — без ограничений по сравнению с cloud

Особенности self-hosted (важно):

  • Скоупы реальные. На self-hosted Битрикс24 скоупы вебхуков enforce'ятся со стороны самого портала — попытка вызвать метод вне скоупа вернёт 403. На cloud скоупы advisory (Вайбкод фильтрует, B24 нет).
  • Тариф всегда commercial. self-hosted Битрикс24 — это платная лицензия, поэтому trial Вайбкода для таких порталов не активируется.
  • Несколько пользователей одного self-hosted Битрикс24 — каждый делает шаг 2 индивидуально и получает свой личный developer-key. Учётные записи независимые: revocation одного ключа не затрагивает других.

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

Откройте раздел Обратная связь на Вайбкоде или напишите в поддержку. В тикете укажите:

  • Адрес self-hosted Битрикс24 (например, mybox.example.com)
  • На каком шаге зависло (A / B / C / D / E)
  • Текст ошибки, если бот её показал
  • Время попытки (примерно)

С этой информацией мы сможем найти ваш request в audit-log и разобраться быстрее.

#Что дальше