Integrationen
Den Bot mit Google Tabellen, Drive, GetCourse oder KI verbinden: Zugang speichern und die passende Aktion zur Reaktion hinzufügen.
Auf dieser Seite
Mit einer Integration arbeitet der Bot mit einem anderen Dienst zusammen: Er trägt beispielsweise eine Anfrage in eine Google-Tabelle ein oder übergibt einen Kunden an GetCourse. Die Einrichtung hat zwei Schritte: Speichern Sie zuerst die Verbindung und wählen Sie sie danach in einer Reaktionsaktion aus.
Öffnen Sie Integrationen → Integration hinzufügen, wählen Sie den Dienst und füllen Sie die Felder aus. Zugangsdaten werden verschlüsselt gespeichert. In der Karte können Sie die Verbindung ein- oder ausschalten oder über Konfigurieren öffnen.
Verfügbare Dienste
- KI: Sprachmodell über eine OpenAI-kompatible API. Siehe KI-Antworten und AI-Agent.
- Google Sheets: Zeilen anhand von Spaltenüberschriften hinzufügen, lesen, suchen und aktualisieren (siehe Aktionen).
- Google Drive: Dateien in einen Ordner hochladen.
- GetCourse: Benutzer und Geschäfte erstellen oder aktualisieren sowie Benutzer, Geschäfte und Gruppen exportieren.
- Webhook: Daten per HTTP an die Adresse eines anderen Dienstes senden.
- Externer Handler: eine Reaktion über eine dauerhafte WebSocket-Verbindung an Ihr Serverprogramm übergeben. Siehe Externer Handler.
Google Kalender ist ebenfalls ein anschließbarer Dienst, jedoch nicht auf diesem Bildschirm: Sie verbinden ihn per OAuth unter AI → Kalender und konfigurieren dort auch Terminarten. Siehe Termine und Google Kalender.
Für die CRM-Systeme amoCRM und Kommo, Bitrix24, RetailCRM und OzmaCRM gibt es Integrationen → CRM. Dort verbinden Sie das System, ordnen seine Felder denen von GetMyBot zu, prüfen das Ergebnis vor dem Start, sehen das Austauschprotokoll und lösen Konflikte. Daten werden in beide Richtungen übertragen. amoCRM/Kommo nutzen OAuth, RetailCRM einen API-Schlüssel, OzmaCRM OIDC und Bitrix24 einen eingehenden Portal-Webhook. Der Ablauf steht unter CRM-Integrationen.
Einrichtung
Wählen Sie beim Hinzufügen einen Dienst, geben Sie der Verbindung einen Namen und füllen Sie die dienstspezifischen Felder aus.
Webhook
- Webhook-URL: Adresse des Empfängers.
- HMAC-Signatur (Geheimnis): gemeinsamer Schlüssel, mit dem der Empfänger prüft, ob die Anfrage von GetMyBot stammt. Die Signatur steht im Header
X-Signature: sha256=....
GetCourse
- Konto (Name der Schule, etwa
myschool) und geheimer API-Schlüssel. - Objekt: „Benutzer“ oder „Geschäfte“.
Die Aktion GetCourse unterstützt zwei Arbeitsweisen.
Import nach GetCourse. Die Felder sind wie in der offiziellen API gruppiert: Benutzer (email, phone, first_name, last_name, city, country, group_name), Importeinstellungen (etwa refresh_if_exists), Traffic-Quelle (utm_source, utm_campaign, referer), Geschäft (offer_code, deal_cost, deal_status, deal_is_paid) und zusätzliche Benutzerfelder. Sie können einen Wert aus Kundendaten nehmen, etwa email = {{param.email}}, oder einen festen Wert direkt eingeben, etwa utm_source = telegram. Vorschläge für Gruppen und zusätzliche Felder stammen aus Ihrem Konto. Lassen sie sich nicht laden, geben Sie die Namen von Hand ein. Bereits erstellte Aktionen mit einer gemeinsamen Feldliste funktionieren weiter. Die Schaltfläche In Abschnitte umwandeln verteilt bekannte Schlüssel auf die Abschnitte und legt übrige unter zusätzliche Felder.
Antwortet GetCourse mit HTTP 200, meldet aber success: false, gilt die Aktion als fehlgeschlagen und zeigt error_message. Bei Erfolg werden {user_id, deal_id, lead_id} in den temporären Reaktionsdaten gespeichert; fehlende Werte bleiben null.
Daten aus GetCourse abrufen. Benutzer exportieren, Geschäfte exportieren und Gruppen exportieren starten einen Export in GetCourse und warten bis zu 25 Sekunden auf dessen Fertigstellung. Sind die Daten noch nicht bereit, endet die Aktion mit export_not_ready: Wiederholen Sie sie später oder verwenden Sie einen engeren Filter. Ein Filter besteht aus Zeilen mit „Schlüssel, Typ, Wert“, etwa created_at[from] = 2026-10-01; unbekannte Schlüssel werden unverändert übergeben. Das Ergebnis ist eine Liste von Datensätzen mit den Feldnamen des Kontos, pro Ausführung höchstens 1.000 Zeilen (standardmäßig 50). has_more in den Seiteninformationen zeigt an, ob es eine weitere Seite gibt. GetCourse begrenzt die Exporthäufigkeit. Starten Sie den Export daher nicht bei jeder Nachricht, sondern in seltenen Abläufen oder nach Zeitplan.
Google Sheets
- Link zur Tabelle oder ihre ID.
- Dienstkonto-JSON (Geheimnis): Schlüsseldatei eines eigenen Google-Kontos für Programme. Geben Sie dessen E-Mail-Adresse Zugriff auf die Tabelle, sonst schlagen Lesen und Schreiben mit einem Zugriffsfehler fehl. Er wird im Aktionseditor und bei der Prüfung angezeigt.
Die Aktionsfelder werden den Spaltenüberschriften der Kopfzeile zugeordnet (standardmäßig die erste Zeile; Sie können eine andere angeben). Verfügbare Operationen:
- Zeile hinzufügen: Jedes Feld wird in die Spalte mit derselben Überschrift geschrieben, unabhängig von der Spaltenreihenfolge. Eine unbekannte Überschrift ist ein Fehler. Ergebnis:
{row_number, range}. - Zeilen lesen: Zeilen nach der Kopfzeile als Objekte mit der Zeilennummer
_row. Eine Seite enthält standardmäßig 50, höchstens 500 Zeilen;has_moreundnext_offsetkönnen Sie unter einem eigenen Schlüssel speichern. - Letzte Zeile lesen und Zeile suchen: durchsuchen das Blatt seitenweise. Ist es zu groß, melden sie einen Fehler, statt eine falsche Zeile zurückzugeben.
- Zeile aktualisieren: ändert Zellen der Zeile
row_number, etwa{{ctx.found.row_number}}nach einer Suche.
Werte können wie eingegeben gespeichert werden (Google Tabellen erkennt Formeln und Datumswerte) oder als Text (ohne Erkennung). Im Editor wählen Sie Felder aus den Blattüberschriften; können diese nicht gelesen werden, geben Sie die Namen selbst ein. Die Zeilenvorschau zeigt bis zu 20 Zeilen und ändert die Tabelle nicht. Ihr Ergebnis kann als Muster für die Antwortauswertung dienen, mit der Sie Felder für die nächste Aktion auswählen.
Google Drive
- Ordner-ID.
- Dienstkonto-JSON (Geheimnis). Geben Sie diesem Konto Bearbeitungsrechte für den Ordner.
Die Aktion Google Drive lädt eine Datei mit Name, Dateityp (MIME) und Inhalt hoch. Kennung und Link {file_id, web_view_link} werden in temporären Reaktionsdaten gespeichert, etwa unter upload. Den Link können Sie danach als {{ctx.upload.web_view_link}} einfügen. Für das Ergebnis lässt sich wie bei anderen Aktionen eine Antwortauswertung konfigurieren.
KI
- Base URL, Modell, System-Prompt, API-Schlüssel (Geheimnis). Mehr dazu: KI-Antworten und AI-Agent.
Eine KI-Verbindung wird von der Aktion KI in Reaktionen, vom AI-Agenten und zur Vorbereitung von Wissensquellen für die Suche verwendet. Für die Suche erzeugt das Modell numerische Textrepräsentationen, sogenannte Embeddings. Sie werden über dieselbe Base URL und denselben Schlüssel angefragt, standardmäßig mit text-embedding-3-small. Ohne funktionierende KI-Verbindung lassen sich Wissensquellen nicht für die Suche vorbereiten und der Agent nicht aktivieren.
Externer Handler
Bei dieser WebSocket-Integration verbindet sich Ihr Server mit GetMyBot und verarbeitet Reaktionen, indem er Befehle im Format der Telegram Bot API zurückgibt.
- WebSocket-Adresse: Hierüber verbindet sich Ihr Dienst.
- Verbindungstoken (Geheimnis): wird bei Erstellung einmal angezeigt; es gibt eine Schaltfläche zum Neuausstellen.
Protokoll und Dienstbeispiele finden Sie unter Externer Handler.
Verwendung in Reaktionen
- KI und Webhook stehen sofort als Aktionen oder Kanäle bereit: Fügen Sie die Aktion KI hinzu oder senden Sie Daten mit Webanfrage an eine Webhook-Adresse.
- Die Aktionen GetCourse, Google Tabelle und Google Drive stehen im Reaktionseditor bereit. Jede hat eine optionale Antwortauswertung: Wählen Sie benötigte Werte aus dem Ergebnis und speichern Sie sie im Kontext. Bei einem Fehler wird der konfigurierte Fehlerpfad ausgeführt. Ist die Funktion im Tarif nicht enthalten, wird der Schritt mit
feature_unavailableals fehlgeschlagen markiert.
Integration prüfen
Auf der Integrationskarte gibt es Prüfen. Dabei wird nichts geschrieben: Google Sheets liest Tabelleninformationen, Google Drive Ordnerinformationen, GetCourse führt eine sichere Leseanfrage aus und bei KI wird nur geprüft, ob die Einstellungen ausgefüllt sind (kein kostenpflichtiger Aufruf). Für andere Typen gibt es nichts zu prüfen. Das Ergebnis zeigt für jeden Punkt kurz, was funktioniert und was nicht.
Sicherheit
GetMyBot sendet Integrationsanfragen nicht an interne Netzwerke und begrenzt die Antwortgröße. Das verhindert Anfragen an Adressen, die nicht von außen erreichbar sein sollen (SSRF). Integrationsgeheimnisse werden verschlüsselt gespeichert.
Für Website-Crawling und Dateianalyse gelten zusätzliche Grenzen: nur erlaubte HTTPS-Adressen, Beachtung von robots.txt, begrenzte Weiterleitungen, Größen- und Zeitlimits sowie keine Ausführung von Makros, Skripten oder eingebetteten Objekten. Siehe Wissensquellen.
Nächste Schritte
- KI-Antworten und AI-Agent: Modell einrichten und verwenden.
- Wissensquellen: Grundlage für Antworten des AI-Agenten.
- Termine und Google Kalender: Kalender verbinden.
- Externer Handler: eigenes Backend per WebSocket verbinden.
- CRM-Integrationen: amoCRM/Kommo, Bitrix24, RetailCRM und OzmaCRM.
- Quellen und Schlüssel: REST- und OzmaDB-Konnektoren zum Lesen und Schreiben.
- Webanfragen und Webhooks: ein- und ausgehendes HTTP.
Spracherkennung
Wählen Sie einen OpenAI-kompatiblen Anbieter oder Ihren eigenen Dienst. Geben Sie danach API-Base-URL, Modell und API-Schlüssel ein. Ein optionaler Sprachcode wie ru oder en gibt einen Hinweis auf die gesprochene Sprache; ohne Angabe übernimmt der Anbieter die Erkennung. Schlüssel und Modell müssen zum gewählten Anbieter gehören.