Виджет для своего аккаунта

Чтобы запускать свой JavaScript внутри Bito, аккаунт разработчика не нужен. Если виджет нужен только вашей компании — внутренний инструмент, экран, связанный с вашими системами, то, что никто больше не установит, — загрузите его в свой аккаунт и обойдите маркетплейс целиком.

	Эта страница	Приложение маркетплейса
Статус разработчика	Не нужен	Нужен active
Где работает	Только в вашем аккаунте	В каждом установившем аккаунте
Кто одобряет	Автоматическая проверка архива, затем ваше согласие	Модератор Bito
Версии	Повторная загрузка заменяет текущий виджет	История релизов, которой вы управляете

Как загрузить

1. В разделе Интеграция → Интеграция нажмите Кастомная интеграция и в окне Создание интеграции выберите + Создать в строке Интеграция с собственным кодом.
2. Заполните обычную форму кастомной интеграции.
3. Приложите widget.zip в блоке Ваш собственный виджет.
4. Нажмите Сохранить. Будут показаны client_id, секрет и API-ключ; секрет виден только в этот раз.
5. Откройте интеграцию в списке Установлены и нажмите Установить. Интеграция создаётся неустановленной: пока она не установлена, виджет не монтируется, а запросы к API возвращают Integration is not installed.

Архив проверяется сразу при загрузке — тот же валидатор, те же правила, тот же отчёт об ошибках, что и на пути маркетплейса. Если проверка пройдена, виджет становится рабочим в вашем аккаунте. Если нет — показываются ошибки, ничего не активируется, вы исправляете архив и загружаете снова.

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

TIP

Формат widget.zip одинаков для обоих путей — см. формат widget.zip. Внутри пакета нет признака «приватный».

Согласие всё равно требуется

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

Так же виджет и отключается. Отзыв согласия снимает его сразу везде; отдельного шага удаления нет.

Каждая загрузка создаёт новый релиз, а согласие привязано к релизу — поэтому замена виджета запрашивает согласие заново. Изменившийся код не наследует одобрение, выданное старому.

Что на самом деле значит «приватный»

Клиент вашей интеграции остаётся private, и именно это делает её вашей:

• она никогда не появится в маркетплейсе другого аккаунта — витрина отдаёт только public-клиентов;
• другой аккаунт не сможет установить её через маркетплейс даже с client_id;
• её не увидит модератор, потому что она не попадает в очередь.

Когда всё-таки нужен другой путь

Идите на страницу приложения — и сначала получите аккаунт разработчика — если хотите, чтобы приложение находили и устанавливали другие компании, нужна карточка в магазине на нескольких языках, статистика установок или история версий с модерацией.

Выбор не окончательный. Чтобы превратить приватную интеграцию в приложение маркетплейса, сначала получите доступ разработчика, заполните код и карточку. Затем отдельно отправьте на проверку релиз и карточку. Тот же клиент станет public только после одобрения карточки с текущим релизом, который прошёл модерацию.