Обзор

Интеграция Bito — это внешнее приложение, которое работает с Integration API и при необходимости поставляет пользовательский виджет, выполняющийся внутри админ-панели Bito.

Сначала выберите способ распространения:

Вариант	Кто может установить	Аккаунт разработчика	Модерация
Приватная интеграция или приватный виджет	Только ваш аккаунт Bito	Не требуется	Проверки маркетплейса нет; архив всё равно валидируется, а владелец аккаунта принимает согласие
Публичная API-интеграция	Любой клиент Bito из маркетплейса	Требуется	Проверка карточки маркетплейса
Публичная интеграция с виджетом	Любой клиент Bito из маркетплейса	Требуется	Отдельная проверка карточки и релиза виджета

Это то же полезное разделение, что и в обзоре интеграций amoCRM: сначала приватная разработка и тестирование, затем отдельный процесс для публичного приложения. Названия полей, формат пакета и состояния ниже относятся именно к Bito.

Путь публичного виджета

  Аккаунт разработчика
        |
        |  Создать приложение -> сохранить ключи -> занять постоянный код
        v
  Карточка маркетплейса (название, тексты, URL, права, поддержка/конфиденциальность)
        |
        |  Создать версию -> загрузить widget.zip -> проверить -> протестировать локально
        v
  Проверка релиза: draft -> queued -> testing -> approved
        |
        |  Отправить карточку на отдельную проверку
        v
  Проверка карточки: draft/changed -> pending -> approved
        |
        v
  PUBLIC: клиенты находят приложение, устанавливают его и принимают релиз

Два процесса намеренно независимы:

• карточка приложения — публичная идентичность, описание, URL, права и коммерческие сведения;
• релиз — точная версия widget.zip, примечания к версии и снимок карточки.

Одобрение релиза делает код запускаемым, но само по себе не публикует приложение. Одобрение карточки делает приложение публичным, однако виджет нельзя опубликовать с локально активированным или не прошедшим модерацию текущим релизом.

Ключи не меняются при публикации

client_id, secret и api_key выдаются при создании интеграции. Публикация меняет видимость и одобренный код, но не создаёт отдельную production-идентичность.

WARNING

Secret показывается один раз, при создании, и прочитать его повторно нельзя. Если secret или API-ключ потерян или скомпрометирован, перевыпустите оба кнопкой Перевыпустить ключи на вкладке Ключи и сразу обновите всех клиентов — см. Смена ключей.

С чего начать

• Быстрый старт — первый API-вызов к своему аккаунту
• Как стать разработчиком Bito — публичное приложение
• Страница приложения — полный путь публичного виджета
• Пользовательские виджеты и формат widget.zip — контракт среды выполнения