Страница приложения

Публичные интеграции управляются в Интеграция → Мои приложения. Страница разделена на Основную информацию, Версии, Статистику, Отзывы и Ключи, чтобы карточка маркетплейса и исполняемые релизы виджета проходили проверку независимо.

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

1. Создайте основу приложения

В Моих приложениях нажмите Кастомная интеграция и в окне Создание интеграции выберите + Создать в нужной строке:

Тип	Когда выбирать
Внешняя интеграция	Сервис вызывает Integration API, но не выполняет JavaScript внутри Bito
Интеграция с собственным кодом	Приложение также поставляет widget.zip, который монтируется внутри Bito

Заполните начальную форму и нажмите Сохранить. Bito покажет client_id, secret и api_key; secret виден только в этот раз. Скопируйте все три значения до закрытия окна.

Приложение создаётся в вашем аккаунте неустановленным. Чтобы его проверить, откройте его в списке Установлены на странице Интеграция и нажмите Установить — до установки запросы к API возвращают Integration is not installed, а виджет не монтируется.

2. Займите постоянный код

Откройте новое приложение и выберите код приложения:

warehouse_helper

Код должен начинаться со строчной латинской буквы, содержать 3–32 символа и состоять только из строчных латинских букв, цифр и подчёркивания. Перед сохранением нажмите Проверить доступность.

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

3. Заполните Основную информацию

Поле	Назначение
Категория	Категория маркетплейса
Redirect URL	HTTPS callback установки/OAuth
Access revoke hook URL	HTTPS callback удаления
Webhook URL	Адрес по умолчанию для вебхуков данных
Iframe URL	Необязательная внешняя страница настроек; это не пользовательский in-page виджет
Grant access	Права Integration API, которые клиент видит до установки
Монетизация	Бесплатно или Оплата на моём сайте с публичной страницей цен

Пустой список прав означает полный доступ к Integration API. Объявляйте минимальный набор: клиент видит и принимает именно этот контракт.

4. Оформите карточку маркетплейса

Выберите языки публикации и язык по умолчанию. Для каждого выбранного языка заполняется отдельная карточка:

• название и краткое название;
• описание до установки;
• инструкция после установки;
• изображение 400×272 и логотип после установки 108×108;
• изображения галереи 1188×616;
• URL политики конфиденциальности;
• URL или email поддержки.

В тексте после установки поддерживаются #SUBDOMAIN#, #ACCOUNT_ID# и #USER_ID#. Bito подставляет значения, когда клиент читает установленную карточку.

У карточки свой набор состояний:

Состояние	Значение
draft	Ещё не отправлена
pending	Проверяется; карточка заблокирована, работа с версиями продолжается
approved	Проверенная карточка опубликована
changed	Публичная карточка изменена; до одобрения обновления остаётся видна последняя одобренная версия

5. Создайте и протестируйте версию

На вкладке Версии создайте семантическую версию, например 1.0.0, добавьте примечания и загрузите widget.zip. Bito сразу проверит архив и покажет все ошибки.

Пока приложение приватное, кнопка Сохранить в строке версии активирует её только в developer tenant. Используйте Предпросмотр, затем проверьте все объявленные точки в настоящем интерфейсе Bito. Такая локальная активация не является модерацией и не позволяет опубликовать приложение.

Карточка редактируется в Основной информации. При создании версии текущая карточка копируется в неизменяемый снимок релиза, поэтому последующие правки не меняют то, что видел модератор.

6. Отправьте два процесса проверки

У публичного виджета две заявки:

1. Проверка релиза на вкладке Версии проверяет конкретный архив и версию.
2. Проверка карточки в Основной информации проверяет идентичность в маркетплейсе, тексты, URL, права и коммерческие сведения.

Процессы не блокируют друг друга. Рекомендуемый порядок первой публикации:

Заполнить карточку -> создать релиз -> загрузить -> проверить -> протестировать локально
-> отправить релиз -> релиз одобрен -> отправить карточку -> карточка одобрена -> public

Карточку можно отправить, пока релиз проверяется, но модератор не сможет опубликовать виджет, текущий релиз которого не одобрен модератором. API-приложению релиз не нужен.

Пример: публичный складской виджет

Пример повторяет путь из руководства по публичному виджету amoCRM, но использует поля и пакет Bito.

1. Запросите доступ разработчика и создайте Интеграцию-виджет «Warehouse Helper».
2. Сохраните ключи и займите warehouse_helper.
3. Укажите install и revoke URL на https://integration.example.com, выберите только необходимые права товаров и складов, добавьте поддержку и конфиденциальность.
4. Заполните узбекскую, русскую и английскую карточки.
5. Создайте 1.0.0, загрузите валидный widget.zip и сохраните локально.
6. Проверьте все точки, удаление/повторную установку, callback и согласие.
7. Отправьте 1.0.0 на проверку релиза. При отказе исправьте и отправьте повторно.
8. После одобрения релиза отправьте карточку. После её одобрения клиенты найдут приложение, установят его и примут 1.0.0.

Далее: Публикация релиза и Отправка на проверку.