Integracje

Integracje łączą bota z zewnętrznymi serwisami. Każda integracja to zapisana konfiguracja (z zaszyfrowanymi sekretami), którą następnie wykorzystują akcje reakcji. Sekcja — Integracje w menu po lewej; przycisk Dodaj integrację, przełącznik połączenia i przycisk Konfiguruj na każdej karcie.

Dostępne serwisy

  • AI — model językowy (API zgodne z OpenAI). Zob. Odpowiedzi AI.
  • Google Sheets — dodawanie wierszy do arkusza.
  • Google Drive — przesyłanie plików do folderu.
  • GetCourse — wysyłanie użytkowników i transakcji do GetCourse.
  • Webhook — uniwersalne wysyłanie danych przez HTTP do dowolnego serwisu.
  • Zewnętrzny handler — podłączenie własnego backendu przez WebSocket: reakcję obsługuje Twój serwer. Zob. Zewnętrzny handler.

Konfiguracja

Przy dodawaniu wybierasz Serwis, podajesz Nazwę i pola konfiguracji zależne od typu:

Webhook

  • URL webhooka — adres odbiorcy.
  • Podpis HMAC (sekret) — do weryfikacji autentyczności; żądanie jest podpisywane nagłówkiem X-Signature: sha256=....

GetCourse

  • Konto i Klucz tajny.
  • Obiekt — „Użytkownicy" lub „Transakcje".

Google Sheets

  • ID arkusza i Zakres.
  • JSON konta serwisowego (sekret) — klucz Google service account.

Google Drive

  • ID folderu.
  • JSON konta serwisowego (sekret).

AI

  • Base URL, Model, Systemowy prompt, Klucz API (sekret). Szczegóły — Odpowiedzi AI.

Zewnętrzny handler

Integracja WebSocket: Twój serwer łączy się z GetMyBot i obsługuje reakcje, odpowiadając komendami w formacie Telegram Bot API.

  • Adres WebSocket — pod nim łączy się Twój serwis.
  • Token połączenia (sekret) — wyświetlany jeden raz przy tworzeniu; dostępny przycisk ponownego wydania.

Szczegóły, protokół i przykłady serwisu — Zewnętrzny handler.

Użycie w reakcjach

  • AI i Webhook są dostępne jako akcje/kanały od razu: dodaj akcję AI lub wysyłaj dane akcją Żądanie webowe na adres webhooka.
  • Akcje GetCourse, Google Arkusze, Google Dysk w konstruktorze reakcji są oznaczone jako „wkrótce" — same integracje można już teraz konfigurować.

Bezpieczeństwo

Wszystkie żądania wychodzące przechodzą przez ochronę przed SSRF (zablokowane są odwołania do sieci wewnętrznej), a odpowiedź jest ograniczona rozmiarem. Sekrety integracji są przechowywane w postaci zaszyfrowanej.

Co dalej