Интеграции
Как связать бота с Google Таблицами, Диском, GetCourse или ИИ. Где сохранить доступ и какое действие добавить в реакцию.
На этой странице
Интеграция позволяет боту работать с другим сервисом: например, добавлять заявку в Google Таблицу или передавать клиента в GetCourse. Настройка состоит из двух частей: сначала сохраните подключение, затем выберите его в действии реакции.
Откройте Интеграции → Добавить интеграцию, выберите сервис и заполните его поля. Данные доступа хранятся зашифрованными. На карточке подключение можно включить, выключить или открыть через Настроить.
Доступные сервисы
- ИИ: языковая модель (OpenAI-совместимый API). См. ИИ-ответы и AI-агент.
- Google Sheets: добавление, чтение, поиск и обновление строк по заголовкам колонок (см. Действия).
- Google Drive: загрузка файлов в папку.
- GetCourse: создание и обновление пользователей и сделок, выгрузка пользователей, сделок и групп.
- Вебхук: отправка данных на адрес другого сервиса по HTTP.
- Внешний обработчик: передача реакции вашей программе на сервере через постоянное соединение WebSocket. См. Внешний обработчик.
Google Календарь тоже подключаемый сервис, но не с этого экрана: он подключается по OAuth в разделе AI → Календарь, там же настраиваются типы встреч. См. Встречи и Google Календарь.
Для CRM-систем amoCRM и Kommo, Bitrix24, RetailCRM и OzmaCRM есть отдельный раздел Интеграции → CRM. Там можно подключить систему, сопоставить её поля с полями GetMyBot, проверить результат до запуска, посмотреть журнал обмена и разрешить конфликты. Данные передаются в обе стороны. amoCRM/Kommo подключаются через OAuth, RetailCRM через API-ключ, OzmaCRM через OIDC, а Bitrix24 через входящий вебхук портала. Порядок подключения описан в статье CRM-интеграции.
Настройка
При добавлении выберите Сервис, задайте Название подключения и заполните поля для выбранного сервиса:
Вебхук
- URL вебхука: адрес приёмника.
- Подпись HMAC (секрет): общий ключ, по которому принимающий сервис проверит, что запрос пришёл от GetMyBot. Подпись передаётся в заголовке
X-Signature: sha256=....
GetCourse
- Аккаунт (имя школы, например
myschool) и Секретный ключ API. - Объект: «Пользователи» или «Сделки».
Действие GetCourse умеет два вида работы.
Импорт в GetCourse. Поля сгруппированы так же, как в официальном API: Пользователь (email, phone, first_name, last_name, city, country, group_name), Настройки импорта (например, refresh_if_exists), Источник трафика (utm_source, utm_campaign, referer), Сделка (offer_code, deal_cost, deal_status, deal_is_paid) и Дополнительные поля пользователя. Значение можно взять из данных клиента: например, email = {{param.email}}; постоянное значение можно вписать прямо в поле: utm_source = telegram. Подсказки групп и дополнительных полей берутся из вашего аккаунта. Если загрузить их не удалось, названия вводятся вручную. Ранее созданные действия с общим списком полей продолжают работать; кнопка Преобразовать в секции распределит известные ключи по разделам, остальные поместит в дополнительные поля.
Если GetCourse отвечает HTTP 200, но сообщает success: false, действие считается неуспешным и показывает текст error_message. При успехе идентификаторы {user_id, deal_id, lead_id} сохраняются во временные данные реакции; отсутствующие значения остаются нулевыми.
Получение данных из GetCourse. Операции Выгрузить пользователей, Выгрузить сделки, Выгрузить группы запускают выгрузку в GetCourse и ждут её готовности до 25 секунд. Если данных ещё нет, действие завершится ошибкой export_not_ready: повторите позже или задайте более узкий фильтр. Фильтр состоит из строк «ключ, тип, значение» (например, created_at[from] = 2026-10-01); неизвестные ключи передаются без изменений. Результат – список записей с названиями полей аккаунта, за один запуск не больше 1000 строк (по умолчанию 50). Признак has_more в Сведениях о странице показывает, есть ли следующая часть. GetCourse ограничивает частоту выгрузок, поэтому не запускайте их на каждое сообщение: используйте редкие сценарии или расписание.
Google Sheets
- Ссылка на таблицу (или её ID).
- JSON сервисного аккаунта (секрет): файл с ключом отдельного аккаунта Google для программы. Предоставьте адресу почты этого аккаунта доступ к таблице, иначе чтение и запись завершатся ошибкой доступа. Она показывается в редакторе действия и при проверке.
Поля действия сопоставляются с заголовками колонок строки заголовков (по умолчанию первая строка, можно указать другую). Операции:
- Добавить строку: каждое поле записывается в колонку с таким же заголовком, порядок колонок листа не важен. Неизвестный заголовок – ошибка. Результат:
{row_number, range}. - Прочитать строки: строки после заголовков в виде объектов, плюс номер
_row. Страница по умолчанию 50, максимум 500;has_moreиnext_offsetможно сохранить в отдельный ключ. - Прочитать последнюю строку и Найти строку: просматривают лист постранично и завершаются ошибкой, если лист слишком велик, а не возвращают неверную строку.
- Обновить строку: меняет ячейки строки
row_number(например,{{ctx.found.row_number}}после поиска).
Значения можно записывать «как при вводе» (Google Таблицы распознают формулы и даты) или «как текст» (без распознавания). В редакторе поля выбираются из заголовков листа; если заголовки не прочитались, названия вводятся вручную. Предпросмотр строк показывает до 20 строк и ничего не меняет в таблице. Его результат можно использовать как образец для разбора ответа, то есть выбора полей, которые понадобятся в следующем действии.
Google Drive
- ID папки.
- JSON сервисного аккаунта (секрет). Дайте этому аккаунту доступ редактора к папке.
Действие Google Диск загружает файл с именем, типом файла (MIME) и содержимым. Идентификатор и ссылка {file_id, web_view_link} сохраняются во временные данные реакции, например под ключом upload. Ссылку затем можно вставить как {{ctx.upload.web_view_link}}. Для результата можно настроить разбор ответа, как у остальных действий.
ИИ
- Base URL, Модель, Системный промпт, API-ключ (секрет). Подробнее: ИИ-ответы и AI-агент.
Одно подключение ИИ используется для действия ИИ в реакциях, AI-агента и подготовки источников знаний к поиску. Для поиска модель создаёт числовые представления текста, эмбеддинги. Они запрашиваются по тому же базовому URL и ключу, по умолчанию у модели text-embedding-3-small. Без рабочего подключения ИИ источники не подготовятся к поиску, а агента не получится активировать.
Внешний обработчик
WebSocket-интеграция: ваш сервер подключается к GetMyBot и обрабатывает реакции, отвечая командами в формате Telegram Bot API.
- Адрес WebSocket: по нему подключается ваш сервис.
- Токен подключения (секрет): показывается один раз при создании; есть кнопка перевыпуска.
Подробности, протокол и примеры сервиса: Внешний обработчик.
Использование в реакциях
- ИИ и Вебхук доступны как действия/каналы сразу: добавьте действие ИИ или отправляйте данные действием Веб-запрос на адрес вебхука.
- Действия GetCourse, Google Таблица, Google Диск доступны в конструкторе реакций. У каждого есть необязательный разбор ответа: из результата действия можно выбрать нужные значения и положить их в контекст, а при ошибке запускается настроенный маршрут ошибки. Если функции нет в тарифе, шаг помечается неуспешным с причиной
feature_unavailable.
Проверка интеграции
На карточке интеграции есть кнопка Проверить. Она ничего не записывает: для Google Sheets читает сведения о таблице, для Google Drive – сведения о папке, для GetCourse выполняет безопасный запрос чтения, для ИИ проверяет только заполненность настроек (платный вызов не делается). Для остальных типов проверять нечего. Результат показан по пунктам: что прошло и что нет, с коротким пояснением.
Безопасность
GetMyBot не отправляет запросы интеграций во внутренние сети, а размер ответа ограничивает. Это защита от обращения к адресам, которые не предназначены для внешнего доступа (SSRF). Секреты интеграций хранятся в зашифрованном виде.
У обхода сайтов и разбора файлов есть свои дополнительные ограничения: только разрешённые HTTPS-адреса, соблюдение robots.txt, ограниченные редиректы, лимиты по размеру и времени, отказ от выполнения макросов, скриптов и встроенных объектов. См. Источники знаний.
Что дальше
- ИИ-ответы и AI-агент: настройка и применение модели.
- Источники знаний: из чего отвечает AI-агент.
- Встречи и Google Календарь: подключение календаря.
- Внешний обработчик: подключение своего бэкенда по WebSocket.
- CRM-интеграции: amoCRM/Kommo, Bitrix24, RetailCRM и OzmaCRM.
- Источники и ключи: REST/OzmaDB-коннекторы для чтения и записи данных.
- Веб-запросы и вебхуки: входящие и исходящие HTTP.
Распознавание речи
Выберите совместимого с OpenAI провайдера или свой сервис, затем задайте базовый URL API, модель и API-ключ. Необязательный код языка, например ru или en, подсказывает язык речи; пустое поле оставляет определение провайдеру. Ключ и модель должны принадлежать выбранному провайдеру.