Інтеграції

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

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

  • ШІ — мовна модель (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 (заборонені звернення у внутрішню мережу), а відповідь обмежена за розміром. Секрети інтеграцій зберігаються в зашифрованому вигляді.

Що далі