Telegram

Alle ConnectorsPosteingangTelegram

Schnelleinrichtung#

Wenn im Telegram-Connector Mit QR-Code erstellen verfügbar ist, wählen Sie diese Option, scannen Sie den QR-Code oder wählen Sie Telegram öffnen, und tippen Sie im Einrichtungs-Bot auf Bot erstellen. Kehren Sie anschließend zu Make Agent Fast zurück, prüfen Sie den Benutzernamen des Bots und wählen Sie Diesen Bot verbinden. Das Kopieren eines Tokens ist nicht erforderlich. Die Einrichtung läuft nach 15 Minuten ab; Sie können sie abbrechen und neu starten.

Wenn die Schnelleinrichtung nicht verfügbar ist, nutzen Sie unten Mit einem Bot-Token verbinden. Beide Methoden verwenden dieselben Verbindungsprüfungen und dieselbe Bestätigung beim Ersetzen.

Das Erstellungsformular schlägt den Anzeigenamen Ihres Agents sowie einen Benutzernamen im Format maf_<agent>_<random>_bot vor. Beides lässt sich bearbeiten; der Zufallsanteil verringert Namenskonflikte, die endgültige Verfügbarkeitsprüfung erfolgt jedoch durch Telegram. Bestehende Bots werden nicht umbenannt.

Nach der Erstellung sendet der Einrichtungs-Bot eine Schaltfläche Diesen Bot verbinden, die die authentifizierte Verbindungsprüfung Ihres Agents öffnet. Allein das Erstellen des Bots verbindet ihn noch nicht. Sobald die Bestätigung erfolgreich war, führt Bot öffnen Sie zum Test in die Unterhaltung. /start oder /help stellt eine aktive Einrichtung wieder her oder zeigt Schaltflächen für das Dashboard und die Anleitung an.

Bot manuell erstellen und vorbereiten#

Folgen Sie der offiziellen Dokumentation von Telegram: Introduction to Bots und BotFather guide:

1. Öffnen Sie in Telegram das verifizierte Konto @BotFather.
2. Führen Sie /newbot aus, wählen Sie einen Anzeigenamen und einen eindeutigen Benutzernamen, der auf bot endet.
3. Kopieren Sie das Bot-Token. Jeder, der dieses Token besitzt, kontrolliert den Bot.
4. Optional: Konfigurieren Sie vor dem Start in BotFather das Foto, die Beschreibung, den Info-Text und die lokalisierte Befehlshilfe.

Das Token gehört zur Telegram Bot API; es ist weder ein Telegram-Anmeldecode noch eine API-ID oder ein API-Hash.

In Make Agent Fast verbinden#

Öffnen Sie die Seite Kanäle des Agents, wählen Sie Telegram, fügen Sie das Bot-Token ein, legen Sie fest, ob unterstützte Antworten zusätzlich gesprochen werden sollen, und wählen Sie Verbinden.

Make Agent Fast ruft Telegram getMe auf, um das Token zu prüfen und den Benutzernamen des Bots anzuzeigen. Anschließend ruft es setWebhook mit der öffentlichen HTTPS-URL des Connectors, einem geheimen Verifizierungstoken sowie message, callback_query und my_chat_member als akzeptierten Update-Typen auf. Bereits ausstehende Updates werden nicht verworfen.

Normalerweise ist kein manueller Webhook-Schritt erforderlich. Beenden Sie vor dem Verbinden jeden Polling-Dienst. Wenn der Bot einen anderen Webhook-Empfänger hat, prüfen und bestätigen Sie dessen Ersetzung; Make Agent Fast übernimmt ihn nicht stillschweigend. Ein Agent kann gleichzeitig über bis zu fünf Telegram-Bots antworten; jeder Bot ist eine eigene Verbindung. Wenn Sie einen anderen Bot speichern, wird eine neue Verbindung hinzugefügt, statt die aktuelle zu ersetzen. Ein Bot, der bereits einem anderen Agent zugeordnet ist, muss dort zuerst getrennt werden.

Unterhaltung testen#

1. Öffnen Sie den t.me-Link des Bots über ein Telegram-Konto, das nicht dem Owner gehört.
2. Wählen Sie Start; Bots können keine Unterhaltung mit einem Nutzer beginnen.
3. Senden Sie eine Textfrage, die sich aus dem Wissen beantworten lässt.
4. Senden Sie eine Sprachnachricht, falls Sprache aktiviert ist.
5. Prüfen Sie, dass Antworten eintreffen, Letzte Nachricht sich ändert und der Verlauf unter Unterhaltungen erscheint.

Private Nachrichten sind standardmäßig öffentlich: Besucher benötigen keine Freigabe durch den Owner. Antworten in Gruppen sind deaktiviert, bis der Owner In Gruppen antworten, wenn der Bot erwähnt wird oder auf seine Nachricht geantwortet wird aktiviert. Der Telegram-Datenschutzmodus (Privacy Mode) und die Gruppenberechtigungen gelten weiterhin. Testen Sie zuerst Direktnachrichten.

Sprachverhalten#

Telegram unterstützt in diesem Connector eingehende und ausgehende Sprachnachrichten. Eingehende Sprachnachrichten werden heruntergeladen und transkribiert, bevor der Agent antwortet. Ist Mit Sprache antworten aktiviert und steht ein Sprachanbieter zur Verfügung, sendet Make Agent Fast zusätzlich zum Text eine Sprach- bzw. Audioantwort. Schlägt die Transkription oder Sprachausgabe fehl, bitten Sie den Nutzer, es erneut als Text zu versuchen, und prüfen Sie den Connector-Fehler.

Token rotieren, deaktivieren oder entfernen#

Wenn das Token offengelegt wurde, generieren bzw. widerrufen Sie es sofort in BotFather, aktualisieren Sie den Connector mit dem neuen Token und testen Sie erneut. Beim Aktualisieren der Zugangsdaten für denselben Bot bleiben dessen Einstellungen und der Pausenstatus erhalten. Das Ersetzen durch einen anderen Bot erfordert eine Bestätigung und hält den Verlauf des vorherigen Bots getrennt.

Beim Deaktivieren werden Antworten lokal gestoppt; beim Entfernen wird die Verbindung archiviert und ihr Verlauf bleibt erhalten. Beides löscht weder den Telegram-Bot noch ruft es deleteWebhook auf, was einen neueren Empfänger stören könnte. Archivierte Verbindungen ignorieren eingehende Nachrichten. Per Schnelleinrichtung erstellte Bots können ihre Zugangsdaten nach Lebenszyklus-Ereignissen des Managers aktualisieren, ein pausierter Bot bleibt jedoch pausiert, und ein Wechsel der Inhaberschaft deaktiviert die Verbindung zur Prüfung.

Fehlerbehebung#

Fügen Sie niemals ein aktives Token in Dokumentation, Quellcode, Analysen oder Support-Screenshots ein.