Verwenden Sie diesen Artikel, um einen oder mehrere Telegram-Bots mit Ihrem Intercom-Arbeitsbereich zu verbinden, zu verstehen, was passiert, sobald die Verbindung aktiv ist, und zu wissen, was zu tun ist, wenn Sie die Verbindung trennen müssen. Nach der Einrichtung erscheinen Telegram-Gespräche im Inbox neben allen anderen Kanälen, Fin bearbeitet sie automatisch, und Workflows werden vollständig angewendet.
Was Sie vor der Verbindung benötigen
Sie benötigen Administratorzugang in Ihrem Intercom-Arbeitsbereich, um einen Telegram-Kanal zu verbinden oder zu trennen.
Bevor Sie verbinden, benötigen Sie einen Telegram-Bot und Ihren Bot-Token (eine Berechtigung, die Intercom erlaubt, Nachrichten im Namen Ihres Bots zu senden und zu empfangen). Erstellen Sie einen Bot über @BotFather (der offizielle Telegram-Bot zur Erstellung und Verwaltung von Bots). Siehe Telegram-Dokumentation für Schritt-für-Schritt-Anleitungen.
Hinweis: Ihr Bot-Token gibt volle Kontrolle über den Bot. Bewahren Sie ihn sicher auf und teilen Sie ihn nur im notwendigen Umfang für die Intercom-Verbindung.
So verbinden Sie Telegram
Halten Sie Ihren Bot-Token von @BotFather bereit, bevor Sie beginnen.
Gehen Sie zu Einstellungen > Kanäle > Telegram.
Fügen Sie Ihren Bot-Token in das Feld Bot token ein.
Klicken Sie auf Verbinden.
Sobald verbunden:
Intercom validiert Ihren Bot-Token.
Der webhook (der Verbindungspunkt, der Nachrichten von Telegram empfängt) wird registriert und verbindet Ihren Telegram-Bot mit dem Inbox.
Die Installation wird im Teammate Activity Log (Einstellungen > Sicherheit > Teammate Activity) protokolliert.
Der Telegram-Kanal erscheint als aktiv unter Einstellungen > Kanäle > Telegram, sobald die Einrichtung abgeschlossen ist. Um die Verbindung zu überprüfen, senden Sie eine Testnachricht an Ihren Telegram-Bot – sie sollte innerhalb weniger Sekunden als neues Gespräch in Ihrem Intercom Inbox erscheinen.
Mehrere Telegram-Bots verbinden
Sie können mehr als einen Telegram-Bot mit einem einzigen Arbeitsbereich verbinden – nützlich, wenn Sie separate Bots für verschiedene Marken, Regionen oder Produktlinien betreiben. Jeder hinzugefügte Bot erscheint in der Liste unter Einstellungen > Kanäle > Telegram mit eigenem @Benutzernamen und Verbindungsstatus. Um einen weiteren Bot hinzuzufügen, wiederholen Sie die oben genannten Verbindungsschritte mit dem Token des neuen Bots.
Einer Telegram-Bot eine Marke zuweisen
Wenn Ihr Arbeitsbereich einen Multibrand-Plan hat, können Sie jeder verbundenen Telegram-Bot eine Marke zuweisen. Dies steuert die Persona, die Fin beim Antworten verwendet, und die help center-Inhalte, aus denen Fin antwortet – jeder Bot kann unabhängig auf eine andere Marke verweisen.
So weisen Sie eine Marke zu:
Gehen Sie zu Einstellungen > Kanäle > Telegram.
Öffnen Sie auf der Bot-Karte den Brand-Auswähler.
Wählen Sie die Marke aus, die dieser Bot verwenden soll.
Gespräche, die vom Bot gestartet werden, werden mit der Marke als Standardgesprächsattribut gekennzeichnet, sodass sie in markenbasierten Ansichten, Berichten und Workflow-Bedingungen korrekt segmentiert werden.
Hinweis: Das Löschen des Brand-Auswählers setzt den Bot auf den Standard des Arbeitsbereichs zurück. Die Marken-Zuweisung ist nur bei Multibrand-Plänen verfügbar.
Gespräche nach Bot weiterleiten
Wenn Ihr Arbeitsbereich mehr als einen Telegram-Bot verbunden hat, können Sie die Gespräche jedes Bots unabhängig mit einem eigenen Gesprächsattribut weiterleiten.
Das Telegram-Bot-Attribut
Jedes Gespräch, das über Telegram ankommt, trägt automatisch ein schreibgeschütztes Telegram bot-Attribut, das aufzeichnet, von welchem Bot es stammt, angezeigt durch den Telegram-Benutzernamen dieses Bots (zum Beispiel support_acme_bot). Dieses Attribut ist verfügbar in:
Zuweisungsregeln
Workflow-Bedingungszweige
Die Inbox-Seitenleiste
Berichterstattung
Um die Weiterleitung einzurichten, erstellen Sie eine Zuweisungsregel oder einen Workflow mit einer Bedingung auf Telegram bot, wählen Sie einen Bot aus dem Dropdown-Menü und leiten Sie an das Team weiter, das ihn besitzt. Wiederholen Sie dies für jeden Bot. Arbeitsbereiche mit nur einem verbundenen Telegram-Bot sehen das Attribut mit einer einzigen Option – das Attribut ist vorhanden, aber es gibt nichts, worauf zwischen Bots weitergeleitet werden könnte.
Einschränkungen
Kein Verlauf. Nur Gespräche, die am oder nach dem 12. August 2026 erstellt wurden, tragen das Attribut. Gespräche, die vor diesem Datum geöffnet wurden, bleiben dauerhaft leer – es gibt keine Nachfüllung. Regeln, die auf das Attribut verzweigen, stimmen nicht mit älteren Gesprächen überein.
Schreibgeschützt. Das Attribut wird automatisch gesetzt, wenn das Gespräch erstellt wird. Teammitglieder und Administratoren können es nicht manuell setzen oder korrigieren, auch nicht in der Seitenleiste.
Nicht in der öffentlichen API. Das Attribut wird nicht über die REST API bereitgestellt, daher kann es von externen Integrationen nicht gelesen oder gefiltert werden.
Ein Workflow zurzeit. Ein Gespräch läuft jeweils mit einem einzigen für Teammitglieder sichtbaren Workflow. Wenn ein anderer aktiver Workflow das Gespräch bereits aufgenommen hat, wird ein Workflow, der auf Telegram bot verzweigt, nicht ausgeführt. Dies ist die häufigste Ursache dafür, dass eine Weiterleitungsregel scheinbar nichts bewirkt – prüfen Sie zuerst, ob ein anderer Workflow läuft.
Gruppenchats mit zwei Bots. Wenn zwei Ihrer Bots in derselben Telegram-Gruppe sind, öffnet jeder seine eigene Intercom-Konversation für diese Gruppe, sodass dieselbe Nachricht zweimal erscheint und beide Bots antworten können. Dies ist ein vorbestehendes Verhalten, nicht spezifisch für diese Funktion.
Getrennte Bots
Wenn ein Bot später getrennt wird, bleibt er als archivierte Option im Attribut-Auswähler verfügbar. Bestehende Regeln und ältere Gespräche, die darauf verweisen, werden weiterhin korrekt aufgelöst.
So trennen Sie Telegram
Um einen Telegram-Bot zu trennen, gehen Sie zu Einstellungen > Kanäle > Telegram und klicken Sie auf Trennen.
Bestehende Gespräche im Inbox sind nicht betroffen, wenn Sie trennen, sie bleiben zugänglich und können weiterhin von Teammitgliedern verwaltet werden. Kunden können jedoch keine neuen Nachrichten an den Bot senden, bis er wieder verbunden ist.
Wichtig: Das Trennen eines Bots entfernt dauerhaft dessen Bot-Token und webhook-Geheimnis (eine Sicherheitsberechtigung, die an die webhook-Verbindung gebunden ist) aus Intercom. Diese Berechtigungen können nicht wiederhergestellt werden. Um die Verbindung wiederherzustellen, müssen Sie Ihren Bot-Token über @BotFather neu generieren und die Einrichtung erneut abschließen.
Telegram-Broadcasts
Wenn Sie einen Broadcast senden, erscheint ein Von Bot-Auswähler, wenn Sie mehr als einen Telegram-Bot verbunden haben. Wählen Sie aus, von welchem Bot der Broadcast gesendet wird – die Kanalliste wird automatisch auf die Kanäle dieses Bots beschränkt. Wenn Sie nur einen Bot verbunden haben, funktionieren Broadcasts wie zuvor ohne zusätzliche Schritte.
Gesendete ticket-Formulare an Telegram-Kunden
Sie können strukturierte Informationen von Ihren Telegram-Kunden sammeln, indem Sie ihnen ein gehostetes ticket-Formular senden – genauso wie bei Discord, Slack und WhatsApp. Der Kunde verifiziert seine Identität mit einem Tipp über die eingebaute Telegram-Anmeldung, füllt dann das Formular aus und sendet es, ohne den Chat zu verlassen.
Setzen Sie die domain Ihres Bots in BotFather
Das Telegram Login Widget funktioniert nur auf einer domain, die mit Ihrem Bot registriert ist. Sie müssen dies einmal pro Bot einstellen – die domain hängt von der Hosting-Region Ihres Arbeitsbereichs ab:
Region | Domain zum Einstellen |
Vereinigte Staaten | app.intercom.com |
Europa | app.eu.intercom.com |
Australien | app.au.intercom.com |
Öffnen Sie einen Chat mit @BotFather in Telegram.
Senden Sie
/setdomain.Wählen Sie Ihren Bot aus.
Senden Sie die domain für Ihre Region aus der obigen Tabelle.
Hinweis: Wenn Sie nicht sicher sind, in welcher Region sich Ihr Arbeitsbereich befindet, überprüfen Sie die URL, mit der Sie sich bei Intercom anmelden – sie entspricht einer der oben genannten domains. Das Einstellen der falschen Region verhindert, dass das Login-Widget erscheint.
Senden Sie ein Formular an einen Telegram-Kunden
Öffnen Sie das Telegram-Gespräch in Ihrem Inbox.
Wählen Sie im Antwort-Composer (oder über die Aktionen
⌘K/Ctrl+K) aus, ein gehostetes ticket-Formular zu senden.Wählen Sie das Formular aus und senden Sie es. Der Kunde erhält einen Link im Telegram-Chat.
Was der Kunde sieht
Er öffnet den Link aus dem Chat.
Er wird aufgefordert, seine Identität mit dem Mit Telegram anmelden-Button zu verifizieren.
Nach einem Tipp öffnet sich das Formular – er füllt es aus und sendet es ab.
Das eingereichte ticket erscheint zurück im Gespräch, genau wie jedes andere gehostete ticket-Formular.
Fehlerbehebung
Der Anmeldebutton erscheint nicht – die domain des Bots ist nicht gesetzt oder die domain der falschen Region wurde verwendet. Führen Sie
/setdomainin BotFather mit der korrekten domain für Ihre Region erneut aus.„Verifizierung fehlgeschlagen“ nach dem Tippen auf Anmelden – bestätigen Sie, dass der spezifische Bot, der das Gespräch bearbeitet hat, mit dem Bot übereinstimmt, für den Sie die domain gesetzt haben. Bei mehreren verbundenen Bots muss jeder Bot seine domain separat in BotFather gesetzt bekommen.
Die Verbindung ist fehlgeschlagen – Jeder Telegram-Bot kann jeweils nur mit einem Intercom-Arbeitsbereich verbunden sein. Wenn Sie versuchen, einen Bot zu verbinden, der bereits in einem anderen Arbeitsbereich verwendet wird, schlägt die Verbindung fehl.