Интеграции

Интеграции связывают бота с внешними сервисами. Каждая интеграция — это сохранённая конфигурация (с зашифрованными секретами), которую затем используют действия реакций. Раздел — Интеграции в меню слева; кнопка Добавить интеграцию, переключатель подключения и кнопка Настроить на каждой карточке.

Доступные сервисы

  • ИИ — языковая модель (OpenAI-совместимый API). См. ИИ-ответы.
  • Google Sheets — добавление строк в таблицу.
  • Google Drive — загрузка файлов в папку.
  • GetCourse — отправка пользователей и сделок в GetCourse.
  • Вебхук — универсальная отправка данных по HTTP в любой сервис.
  • Внешний обработчик — подключение своего бэкенда по WebSocket: реакцию обрабатывает ваш сервер. См. Внешний обработчик.

Настройка

При добавлении выбирается Сервис, задаётся Название и поля конфигурации, зависящие от типа:

Вебхук

  • URL вебхука — адрес приёмника.
  • Подпись HMAC (секрет) — для проверки подлинности; запрос подписывается заголовком X-Signature: sha256=....

GetCourse

  • Аккаунт и Секретный ключ.
  • Объект — «Пользователи» или «Сделки».

Google Sheets

  • ID таблицы и Диапазон.
  • JSON сервисного аккаунта (секрет) — ключ Google service account.

Google Drive

  • ID папки.
  • JSON сервисного аккаунта (секрет).

ИИ

  • Base URL, Модель, Системный промпт, API-ключ (секрет). Подробнее — ИИ-ответы.

Внешний обработчик

WebSocket-интеграция: ваш сервер подключается к GetMyBot и обрабатывает реакции, отвечая командами в формате Telegram Bot API.

  • Адрес WebSocket — по нему подключается ваш сервис.
  • Токен подключения (секрет) — показывается один раз при создании; есть кнопка перевыпуска.

Подробности, протокол и примеры сервиса — Внешний обработчик.

Использование в реакциях

  • ИИ и Вебхук доступны как действия/каналы сразу: добавьте действие ИИ или отправляйте данные действием Веб-запрос на адрес вебхука.
  • Действия GetCourse, Google Таблица, Google Диск в конструкторе реакций размечены как «скоро» — сами интеграции настраиваются уже сейчас.

Безопасность

Все исходящие запросы проходят через защиту от SSRF (запрещены обращения во внутреннюю сеть), а ответ ограничен по размеру. Секреты интеграций хранятся в зашифрованном виде.

Что дальше