Коннекторы — внешние каналы, подключённые к базе знаний

Коннекторы связывают каналы мессенджеров, где уже находятся ваши клиенты и коллеги — WhatsApp, Telegram, Discord, Slack — с той же базой знаний, которая питает внутренний чат. Разговоры остаются на ваших серверах: приложение запрашивает API канала с учётными данными, которые вводит администратор, а ответы поступают из документальной базы знаний.

Доступно только в выпуске Enterprise (connectors_enabled: false в лицензии Community — панель администратора Community показывает UpgradePrompt; см. Administration). Ссылки: packages/shared/src/schemas/connector.schema.ts (поля формы), packages/server/src/routes/connectors.ts (лимиты + роутер), CHANGELOG.md v0.28.1, packages/shared/src/constants/license.ts. Строоки происхождения: FACT-CENSUS.md F-CONN-1, F-CONN-2, F-LIC-1.

Создание коннектора

Путь: Settings → Conversations → Connectors (кнопка New connector). Форма требует:

Привязка архива определяет корпус: каждый вопрос, пришедший из канала, проходит ту же RAG-конвейер, что и внутренние чаты (гибридный поиск, указание источников, синтез) — цитированный ответ отправляется обратно по исходному каналу.

Редактирование коннектора (v0.28.1)

Карточка коннектора в панели администратора содержит меню переполнения с пунктом Edit (первый): открывается предзаполненное диалоговое окно над изменяемой поверхностью:

• Изменяемо через `PUT /api/connectors/:id`: имя, привязка архива, приветственное/резервное сообщения, fallback locale, rate limit, daily session limit (пусто = null; 0 = без ограничений).
• Неизменяемо по схеме: платформа, токен бота, workspace. Смена канала или токена = новый коннектор.
• Переключатель isEnabled остаётся на карточке (Switch); pollMode Telegram остаётся на кнопках вебхука.
• PUT записывает событие аудита chat_connector.updated (наравне с веткой DELETE).

Адаптеры платформ

Каждая платформа работает через выделенный адаптер со своими регистрационными данными:

Учётные данные передаются и остаются на сервере; секретный токен после создания никогда не отображается в интерфейсе.

Лимиты и резервное сообщение

Rate limit и daily session limit защищают workspace от внешнего трафика: 0 = без ограничений; N = максимум на коннектор. Резервное сообщение (с настраиваемой fallback locale) — это ответ, когда поиск по корпусу не даёт пригодных для цитирования элементов — внешний канал никогда не получает генерации без источников, когда резерв настроен.

Отключение и аудит

• isEnabled (Switch на карточке) приостанавливает маршрутизацию, не удаляя конфигурацию.
• DELETE коннектора — отдельное аудируемое действие (событие chat_connector.deleted, наравне с updated).
• Все административные операции над коннекторами попадают в журнал событий (см. Administration).

Активация Enterprise без прикосновения к серверу

Лицензия Enterprise применяется вставкой ключа в панели (Settings → Security → License, GET/PUT/DELETE /api/license/instance): проверка ключа probe-first (invalid/expired/plugin_bound/community_tier — отвергнутый ключ никогда не сохраняется), шифрование AES-256-GCM в SystemConfig, применение во время выполнения через setCachedLicense. См. API reference; F-LIC-1.

Это руководство описывает операционную поверхность адаптеров коннекторов; техническая глубина живёт в статье-близнеце:

• Техническая глубина

Provenance

---

Справочник оператора — Simmetric Chat v0.28.1 (документы обновлены 2026-10-02, SHA переписи `aca5b8ff`).