Verwenden Sie diesen Artikel, um einen Telegram-Bot 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 – diese sollte innerhalb weniger Sekunden als neues Gespräch in Ihrem Intercom Inbox erscheinen.
Kann ich denselben Bot in mehreren Arbeitsbereichen verwenden?
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.
So trennen Sie Telegram
Um die Verbindung zu trennen, gehen Sie zu Einstellungen > Kanäle > Telegram und klicken Sie auf Trennen.
Bestehende Gespräche im Inbox werden beim Trennen nicht beeinflusst, 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 entfernt dauerhaft den Bot token und das webhook-Geheimnis (eine Sicherheitsberechtigung, die mit der webhook-Verbindung verknüpft 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.
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 bestätigt seine Identität mit einem Tipp über die integrierte Telegram-Anmeldung und füllt das Formular aus, ohne den Chat zu verlassen.
Hinweis: Das Senden von gehosteten ticket-Formularen an Telegram-Kunden befindet sich derzeit in der Beta-Phase.
Legen Sie die Domain Ihres Bots in BotFather fest
Das Telegram-Login-Widget funktioniert nur auf einer Domain, die mit Ihrem Bot registriert ist. Sie müssen dies einmal pro Bot festlegen – die Domain hängt von der Hosting-Region Ihres Arbeitsbereichs ab:
Region | Zu setzende Domain |
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. Die falsche Region zu setzen verhindert, dass das Login-Widget angezeigt wird.
Senden Sie ein Formular an einen Telegram-Kunden
Öffnen Sie das Telegram-Gespräch in Ihrem Inbox.
Wählen Sie im Antwortfeld (oder über die Aktionen
⌘K/Ctrl+K) die Option, 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 der Schaltfläche Mit Telegram anmelden zu bestätigen.
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
Die Anmeldeschaltfläche 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 Bot, der mit Ihrer Telegram-Integration verbunden ist, mit dem Bot übereinstimmt, für den Sie die Domain festgelegt haben.