Плагины, подключения и секреты

Эта страница описывает смежные экраны веб-интерфейса, которые расширяют инстанс и хранят учётные данные: Плагины (каталог маркетплейса), Подключения и Секреты.

Установите плагин за 4 шага

Плагины — это коннекторы каналов, сервисы, интеграции и навыки. Установка делается в один клик:

Откройте экран «Плагины» и перейдите в блок «Каталог/магазин».
Найдите нужный плагин (есть поиск и фильтры по типу и состоянию). Официальные модули помечены меткой Official и идут первыми. У карточки плагина явно разделены: издатель, требуемые сетевые адреса, секреты, права и каналы, которые он добавляет; способ удаления — кнопка «Удалить» на установленной карточке (кроме встроенных).
Нажмите «Установить». Что вы увидите: карточка покажет полосу прогресса и будет обновляться сама, пока плагин не станет «онлайн».
Нажмите «Настроить» — откроется форма из манифеста плагина (например, поле токена для коннектора канала). Заполните и сохраните.

Что дальше: канальный коннектор после установки появится на экране Каналы, а интеграция/подключение — на экране «Подключения». До установки плагин не показывается на этих экранах.

[!NOTE] Плагины сообщества. Кроме официального каталога, можно подключить сторонние источники в блоке «Источники»: добавьте имя и URL каталога, включите его и синхронизируйте. Плагины из таких источников проверяются по trust-store инстанса — при первой загрузке ключ автора одобряет оператор. Подробнее — Установка и обновления.

Экран «Плагины»

Экран «Плагины» (каталог маркетплейса) — единая точка установки всех модулей: коннекторы каналов, сервисы, OpenAPI-интеграции, навыки и MCP устанавливаются только здесь. Пока плагин не установлен, он не показывается на экранах «Каналы» и «Подключения»; после установки его настройка появляется там.

Установленные (показываются первыми) — карточки с логотипом, именем, меткой типа и статусом (онлайн / ошибка / разворачивается / заблокирован). Действия: Настроить (форма из манифеста плагина), Обновить до последней (когда в каталоге есть более новая версия), Удалить (с подтверждением; кроме встроенных). У модулей без видимых полей настройки (например, Einstein) кнопки «Настроить» нет — доступно только обновление. Возможны баннеры «нужен публичный URL» и «недоступно на текущем тарифе». Плагин памяти Einstein — встроенный: показан среди установленных с меткой «Встроенный», в каталоге не предлагается и не удаляется.
Каталог/магазин — полный каталог, включая канальные коннекторы: официальные модули первыми, остальные — по числу установок. Есть поиск и фильтры по типу (коннектор / сервис / интеграция / навык / MCP) и состоянию (установлен / не установлен). Модуль, недоступный на текущем тарифе, остаётся видимым — вместо «Установить» показывается ссылка «Обновите тариф» (сервер отвечает HTTP 402, см. Лицензирование).
Во время установки/обновления карточка показывает полосу прогресса и экран обновляется сам каждые несколько секунд до завершения.
Источники — официальный источник закреплён; приватные источники можно добавить (имя + URL), включать/выключать, удалять и синхронизировать.

Подробности — Маркетплейс и плагины.

Подключения (OAuth, мульти-аккаунт)

Экран «Подключения» — личное хранилище учётных данных к внешним сервисам.

Мои подключения — логотип сервиса, формат, метка, статус; кнопка отключить.
Доступные — записи каталога уровня «personal»: OAuth-сервисы запускают авторизацию через redirect (при первом использовании спросят client_id/secret, которые попадут в хранилище секретов); токен-сервисы показывают поля из манифеста (например, адрес почты и токен) и сохраняются как учётные данные.
+ аккаунт — мультиаккаунт: каждой метке соответствует отдельное подключение того же сервиса.
Блок Устройства — статус мостов iOS-устройств.

Подробнее — Подключения и OAuth.

Секреты (хранилище секретов)

Экран «Секреты» — хранилище только на запись: значения секретов не читаются обратно. «+ Новый секрет» — модальное окно с полями: область доступа (scope), имя, значение (пароль). В списке видны область, имя и метка «задан» плюс удаление. Секреты используются плагинами и агентами, не раскрываясь в интерфейсе.

Если не получилось

Вместо «Установить» — ссылка «Обновите тариф» — модуль недоступен на текущем тарифе (сервер отвечает HTTP 402). Смените тариф или выберите другой модуль, см. Лицензирование.
Карточка застряла на установке/ошибке — установка считается успешной только после ответа /healthz плагина; сломанный плагин не засчитывается. Попробуйте переустановить, подробности — Установка и обновления.
Плагина нет в каталоге — проверьте фильтры (тип/состояние) и поиск; если это сторонний плагин — добавьте и синхронизируйте его источник в блоке «Источники».
Не нашёл настройки установленного плагина — они появляются после установки: для каналов — на экране Каналы, для подключений — на «Подключения».

Что дальше

Установка и обновления — жизненный цикл плагинов.
Подключения и OAuth — мультиаккаунт.
Хранилище секретов — как хранятся секреты.