Schriftliche Anleitung

Was Sie tun werden

Sie fügen dem ausgewählten Unternehmen in KSeFGPT eine Telegram-Verbindung hinzu. Vor dem Speichern prüfen Sie den Bot und senden eine Testnachricht. Anschließend zeigt die Integrationskarte den Status Aktiv.

Das Token steuert den Bot. Behandeln Sie es deshalb wie ein Passwort und zeigen Sie es nicht in Screenshots, Dokumenten oder Supportanfragen.

Voraussetzungen

Bevor Sie beginnen

Bereiten Sie einen über @BotFather erstellten Bot und den Zielchat vor. Fügen Sie den Bot vor dem Test zu diesem Chat hinzu, da KSeFGPT eine echte Nachricht dorthin sendet.

Element	Beschreibung
Zugriff	Unternehmensinhaber oder Organisationsmitglied mit integrations:manage.
Tarif	Ein KSeFGPT-Tarif mit aktiviertem Modul Automatisierung und Integrationen.
Telegram-Daten	Ein Bot-Token von @BotFather und die ID einer Gruppe, eines Kanals oder Benutzers, zum Beispiel -1001234567890.
Startpunkt	Öffnen Sie nach der Anmeldung Automatisierung und dann Integrationen.
Dauer	Etwa 3 Minuten.
Auswirkung des Tests	Verbindung testen sendet sofort eine Nachricht an den angegebenen Telegram-Chat.

Prozessvideo

PT25.64S

Das Video zeigt die Auswahl von Telegram, die Eingabe von Bot-Token und Chat-ID, eine Testnachricht und das Speichern der aktiven Integration.

Telegram-Integration hinzufügen - Videoanleitung

01Schritt

Integrationen öffnen

Wählen Sie in der Seitennavigation Automatisierung und dann Integrationen. Wählen Sie Erste Integration hinzufügen oder Integration hinzufügen, wenn bereits andere Verbindungen vorhanden sind.

Ein Dialog mit den verfügbaren Integrationstypen sollte geöffnet werden.

Leere Integrationsliste in KSeFGPT mit der Schaltfläche Erste Integration hinzufügen — Schritt 1

02Schritt

Telegram auswählen

Wählen Sie im Dialog Integration hinzufügen den Eintrag Telegram. Die Karte beschreibt eine Verbindung zum Senden von Benachrichtigungen über einen Telegram-Bot.

Danach erscheint das Formular Konfigurieren Telegram.

Dialog Integration hinzufügen mit sichtbarer Telegram-Karte — Schritt 2

03Schritt

Bot- und Chat-Daten eingeben

Geben Sie unter Name eine eindeutige Bezeichnung ein. Fügen Sie unter Bot-Token den von @BotFather erhaltenen Wert ein und tragen Sie unter Chat-ID die Kennung des Nachrichtenempfängers ein.

Das Token sollte wie `123456:ABC-DEF...` aufgebaut sein. Die Kennung einer Gruppe oder eines Kanals beginnt üblicherweise mit einem Minuszeichen.

Formular Konfigurieren Telegram mit Name, verborgenem Bot-Token und Demonstrations-Chat-ID — Schritt 3

04Schritt

Verbindung testen

Wählen Sie Verbindung testen. KSeFGPT prüft zuerst das Token und sendet danach eine Testnachricht an den angegebenen Chat.

Warten Sie auf die grünen Bestätigungen Mit Bot verbunden und Testnachricht an den Chat gesendet. Prüfen Sie zusätzlich, ob die Nachricht beim richtigen Empfänger in Telegram angekommen ist.

Telegram-Formular mit Bestätigung der Bot-Verbindung und der gesendeten Testnachricht — Schritt 4

05Schritt

Integration speichern

Wählen Sie Speichern. Nach dem Speichern wird der Dialog geschlossen und die Integrationsliste automatisch aktualisiert.

Die neue Karte sollte den eingegebenen Namen, den Typ Telegram und den Status Aktiv zeigen. Von dieser Karte aus können Sie die Verbindung testen, bearbeiten oder löschen.

Gespeicherte Telegram-Integrationskarte mit dem Status Aktiv — Schritt 5

Endzustand

Ergebnis prüfen

Die Integration ist bereit, wenn die Testnachricht im angegebenen Telegram-Chat sichtbar ist und ihre KSeFGPT-Karte Aktiv zeigt.

Wenn das Token offengelegt wurde, widerrufen Sie es über @BotFather und speichern Sie im Integrationseditor ein neues Token.

Fehlerdiagnose

Wenn etwas nicht funktioniert

Vergleichen Sie das Symptom mit der folgenden Tabelle.

Symptom	Wahrscheinliche Ursache	Lösung
Verbindung testen ist deaktiviert	Das Feld Bot-Token ist leer.	Fügen Sie das vollständige Token von @BotFather ein.
Speichern ist deaktiviert	Integrationsname, Bot-Token oder Chat-ID fehlt.	Füllen Sie alle drei Pflichtfelder aus.
Ungültiges Bot-Token-Format	Das Token enthält keinen numerischen Teil, Doppelpunkt und geheimen Zeichenblock.	Kopieren Sie das Token erneut aus dem Chat mit @BotFather.
Bot konnte nicht verifiziert werden	Das Token ist falsch, abgelaufen oder widerrufen.	Prüfen Sie das Token oder erstellen Sie über @BotFather ein neues und wiederholen Sie den Test.
Der Bot existiert, kann aber keine Nachricht senden	Die Chat-ID ist falsch oder der Bot wurde dem angegebenen Chat nicht hinzugefügt.	Prüfen Sie die Chat-ID, fügen Sie den Bot hinzu und wiederholen Sie den Test.
Die Integration lässt sich nicht speichern	Die Berechtigung integrations:manage fehlt oder der Speichervorgang ist fehlgeschlagen.	Bitten Sie den Organisationsinhaber um die erforderliche Berechtigung und versuchen Sie es erneut.

Wie geht es weiter?

Fügen Sie im Automatisierungseditor einen Telegram-Benachrichtigungsblock hinzu und wählen Sie die gespeicherte Integration.

Testen Sie die Verbindung nach einer Änderung des Tokens oder der Chat-ID erneut, bevor Sie einen produktiven Workflow starten.

Telegram-Integration hinzufügen

Melden Sie sich an, testen Sie den Bot und speichern Sie die Verbindung für das ausgewählte Unternehmen.

Bei KSeFGPT anmelden

Wie fügt man eine Telegram-Integration in KSeFGPT hinzu?