База знаний GetMyBot

Интеграции

Как связать бота с 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}}. Для результата можно настроить разбор ответа, как у остальных действий.

ИИ

Одно подключение ИИ используется для действия ИИ в реакциях, 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, ограниченные редиректы, лимиты по размеру и времени, отказ от выполнения макросов, скриптов и встроенных объектов. См. Источники знаний.

Что дальше

Распознавание речи

Выберите совместимого с OpenAI провайдера или свой сервис, затем задайте базовый URL API, модель и API-ключ. Необязательный код языка, например ru или en, подсказывает язык речи; пустое поле оставляет определение провайдеру. Ключ и модель должны принадлежать выбранному провайдеру.