База знаний GetMyBot

Интеграции

Подключение внешних сервисов: ИИ, Google Sheets, Google Drive, Google Календарь, GetCourse, вебхуки.

На этой странице

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

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

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

Google Календарь тоже подключаемый сервис, но не с этого экрана: он подключается по OAuth в разделе AI → Календарь, там же настраиваются типы встреч. См. Встречи и Google Календарь.

Для CRM-систем amoCRM и Kommo, Bitrix24, RetailCRM и OzmaCRM предусмотрен отдельный вид подключения со своей авторизацией, сопоставлением полей и двусторонней синхронизацией. У них свой экран, Интеграции → CRM, с мастером подключения, редактором маппинга, предпросмотром, журналом синхронизации и разбором конфликтов. amoCRM/Kommo (OAuth), RetailCRM (API-ключ) и OzmaCRM (OIDC) подключаются самостоятельно, Bitrix24 подключить пока нельзя. См. CRM-интеграции.

Настройка

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

Вебхук

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

GetCourse

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

Google Sheets

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

Google Drive

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

ИИ

Одна ИИ-интеграция обслуживает трёх потребителей: действие ИИ в реакциях, AI-агента и эмбеддинги, которыми индексируются источники знаний. Эмбеддинги запрашиваются по тому же base URL и ключу, по умолчанию моделью text-embedding-3-small. Без рабочей ИИ-интеграции источники не проиндексируются, а агента не получится активировать.

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

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

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

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

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

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

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

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

У обхода сайтов и разбора файлов есть свои дополнительные ограничения: только разрешённые HTTPS-адреса, соблюдение robots.txt, ограниченные редиректы, лимиты по размеру и времени, отказ от выполнения макросов, скриптов и встроенных объектов. См. Источники знаний.

Что дальше