Telegram-Bot-Integration

Einen Telegram-Bot erstellen

1. Öffne Telegram und suche nach @BotFather.
2. Starte einen Chat mit BotFather und sende /newbot.
3. Wähle einen Anzeigenamen und einen Benutzernamen für deinen Bot. Der Benutzername muss auf bot enden, zum Beispiel AcmeSupportBot.
4. BotFather antwortet mit einem API-Token. Kopiere ihn, du brauchst ihn im nächsten Schritt.

Wichtig: Halte den Token geheim. Wer ihn hat, kann deinen Bot steuern.

Den Bot mit Deskwoot verbinden

1. Gehe zu Einstellungen > Posteingänge und wähle unter Kanal hinzufügen den Kanal Telegram.
2. Gib einen Namen des Posteingangs ein und füge den Token in Bot-Token ein.
3. Klicke auf Posteingang erstellen.

Deskwoot verbindet den Bot sofort mit Telegram. Akzeptiert Telegram den Token nicht, siehst du den Grund, und es wird kein Posteingang erstellt. Der letzte Schritt, Posteingang erstellt, zeigt unter Gruppennachrichten, ob der Bot in Gruppen jede Nachricht liest (siehe unten).

Die Agenten, die du in den Einstellungen des Posteingangs unter Mitarbeiter hinzufügst, sind die, an die Round Robin seine Konversationen verteilt. Siehe Automatische Zuweisung und Round Robin.

Private Chats

Wenn jemand deinem Bot schreibt, erscheint der Chat als Konversation in deinem Posteingang, mit dieser Person als Kontakt. Dein Team antwortet in Deskwoot, und die Antwort kommt in Telegram an. Deine Antworten können Text und Dateien enthalten: Bilder, Videos, Audio und Dokumente. Antwortet Fynn, steht über seiner ersten Antwort eine Zeile wie „Fynn, der KI-Assistent von Acme“, siehe So sehen Kunden, dass Fynn eine KI ist.

Telegram lässt einen Bot nur Leuten schreiben, die selbst einen Chat mit ihm begonnen haben. Der Kunde schreibt also immer zuerst.

Telegram-Gruppen

Füge deinen Bot zu einer Telegram-Gruppe hinzu, dann wird die Gruppe zu einer Konversation in deinem Posteingang, mit dem Namen der Gruppe als Kontakt. Dort schreiben deine Kunden und dein eigenes Team.

• Wer was geschrieben hat. Bei jeder Nachricht steht der Name des Mitglieds, das sie geschrieben hat. Klicke auf den Namen oder das runde Bild daneben, um die Karte des Mitglieds zu öffnen: Name, @Handle (ein Link zum Telegram-Profil) und Telegram-ID. Der Pfeil neben dem Namen öffnet den Kontakt in einem neuen Tab.
• Ein Kontakt für jedes Mitglied. Jede Person, die in der Gruppe schreibt, bekommt einen eigenen Kontakt, und zwar denselben, den Deskwoot nutzt, wenn sie deinem Bot privat schreibt. Bei älteren Nachrichten hat ein Mitglied vielleicht noch keinen Kontakt. Die Karte bietet dann Als Kontakt speichern an. Dafür brauchst du die Berechtigung, Kontakte zu verwalten (die Standardrolle Agent hat sie).
• Auf eine bestimmte Nachricht antworten. Fahre mit der Maus über eine Nachricht und klicke auf Antworten. Über dem Antwortfeld steht dann Antwort an Anna, und deine Antwort kommt in Telegram als Antwort auf genau diese Nachricht an. Antwort aufheben (das x in der Leiste) entfernt sie wieder.
• Zitate von Kunden. Antwortet jemand in Telegram auf eine frühere Nachricht, zeigt Deskwoot die zitierte Nachricht über seiner an. Ein Klick auf das Zitat springt zu ihr.
• Dein KI-Bot antwortet nur, wenn er gefragt wird. Dein Team sieht jede Gruppennachricht, die der Bot bekommt, aber Fynn antwortet nur auf eine Nachricht, die deinen Bot erwähnt (zum Beispiel @AcmeSupportBot) oder auf eine von Fynns eigenen Nachrichten antwortet. Eine Antwort auf die Nachricht eines Agenten zählt nicht, auch wenn Agenten über denselben Bot antworten. Andere automatische Nachrichten wie eine Abwesenheitsantwort oder eine Zufriedenheitsumfrage gehen nie in eine Gruppe.

Antworten auf eine bestimmte Nachricht geht auch in privaten Telegram-Chats. In der App für iPhone und Android drückst du lange auf eine Nachricht und wählst Antworten. Tippe auf den Namen eines Mitglieds, um seine Details zu sehen, mit Kontakt öffnen oder Als Kontakt speichern.

Den Bot jede Gruppennachricht lesen lassen

Bei einem neuen Bot ist der Datenschutzmodus von Telegram an. Dann bekommt ein Bot in einer Gruppe nur Nachrichten, die ihn erwähnen, Befehle und Antworten auf seine eigenen Nachrichten, und deinem Team fehlt der größte Teil der Gruppe. Damit er jede Nachricht bekommt, gibt es zwei Wege:

• Datenschutzmodus ausschalten. Öffne in Telegram @BotFather und sende /setprivacy. Wähle deinen Bot und dann Disable. Entferne den Bot danach aus jeder Gruppe und füge ihn wieder hinzu, damit die Änderung dort gilt.
• Den Bot zum Admin der Gruppe machen. Admins bekommen jede Nachricht.

Um zu sehen, wie es um deinen Bot steht, gehst du zu Einstellungen > Posteingänge, klickst bei deinem Telegram-Posteingang auf Konfigurieren und öffnest den Tab Konfiguration. Unter Gruppennachrichten steht Liest alle Gruppennachrichten oder dass nur ein Teil der Gruppennachrichten bei Deskwoot ankommt, zusammen mit den Schritten von oben. Wenn du die Einstellung in BotFather geändert hast, klicke auf Erneut prüfen.

Telegram-Handles bei Kontakten

Ein Kontakt behält sein Telegram-@Handle unter Soziale Links auf der Kontaktseite, mit einem Button, der das Telegram-Profil öffnet. Wenn du im Dashboard einen Kontakt auswählst, etwa für eine neue Nachricht oder zum Zusammenführen zweier Kontakte, und in der Kontaktsuche der App findest du ihn auch über sein Handle, mit oder ohne @.

• Hat ein Kontakt mit deinem Bot gechattet oder in einer seiner Gruppen geschrieben, trägt Telegram das Handle (falls die Person eins hat) und die Telegram-ID ein. Beim Feld steht dann Aus Telegram übernommen., und du kannst es nicht ändern.
• Bei jedem anderen Kontakt kannst du ein Handle in das Feld Telegram eintippen, auch wenn du einen neuen Kontakt anlegst. Speichere mit Kontakt aktualisieren. Ein Handle hat 5 bis 32 Buchstaben, Ziffern oder Unterstriche.

Fehlerbehebung

• Nur ein Teil der Gruppennachrichten kommt an: Der Datenschutzmodus ist noch an, oder der Bot wurde nach dem Ausschalten nicht aus der Gruppe entfernt und wieder hinzugefügt. Siehe „Den Bot jede Gruppennachricht lesen lassen“ oben.
• Es kommen gar keine Nachrichten an: Wenn du nach dem Verbinden in BotFather einen neuen Token erzeugt hast (/revoke), bekommt der Posteingang keine Nachrichten mehr. Den Token eines bestehenden Posteingangs kannst du nicht ändern. Lösche den alten Telegram-Posteingang unter Einstellungen > Posteingänge (seine Konversationen bleiben in Deskwoot) und verbinde den neuen Token als neuen Telegram-Posteingang.
• „Dieser Telegram-Bot ist schon mit einem anderen Deskwoot-Posteingang verbunden“: Telegram schickt die Nachrichten eines Bots nur an einen Posteingang. Entferne den Bot zuerst dort oder erstelle mit @BotFather einen neuen Bot.
• Der Bot war vorher mit einem anderen Dienst verbunden: Ein Telegram-Bot schickt seine Nachrichten immer nur an einen Webhook. Wenn du ihn mit Deskwoot verbindest, ersetzt Deskwoot den Webhook des anderen Dienstes, und dieser bekommt keine Nachrichten mehr. Setzt der andere Dienst seinen Webhook später wieder, kommen in Deskwoot keine Nachrichten mehr an.

Tipps

• Gib deinem Bot einen klaren Namen, der zu deiner Marke passt, damit Kunden ihn erkennen.
• Lege in BotFather mit /setdescription und /setuserpic eine Beschreibung und ein Profilbild fest.
• Nutze Labels und Zuweisungen, um Telegram-Konversationen neben deinen anderen Kanälen zu organisieren.

Häufige Fragen

Warum sehe ich nur einen Teil der Gruppennachrichten?

Der Datenschutzmodus von Telegram ist für deinen Bot an, deshalb bekommt er in einer Gruppe nur Nachrichten, die ihn erwähnen, Befehle und Antworten auf seine eigenen Nachrichten. Schalte ihn in @BotFather aus (/setprivacy, Bot wählen, Disable), entferne den Bot dann aus jeder Gruppe und füge ihn wieder hinzu. Oder mach den Bot zum Admin der Gruppe. Gruppennachrichten im Tab Konfiguration des Posteingangs zeigt die Datenschutzeinstellung; klicke nach einer Änderung auf Erneut prüfen. Ist der Bot Admin einer Gruppe, bekommt er dort jede Nachricht, auch wenn der Datenschutzmodus an ist. Nachrichten von vor der Änderung kommen nicht nachträglich an.

Kann ich in einer Gruppe auf eine bestimmte Nachricht antworten?

Ja. Fahre mit der Maus über die Nachricht und klicke auf Antworten, oder drück in der App lange auf die Nachricht und wähle Antworten. Deine Antwort kommt in Telegram als Antwort auf diese Nachricht an. Das geht bei Nachrichten von Kunden und bei Nachrichten deines Teams, die schon rausgegangen sind, in Gruppen und in privaten Chats. Wurde die Nachricht in Telegram inzwischen gelöscht, geht deine Antwort trotzdem raus, nur ohne Zitat.

Wie sehe ich, wer in einer Gruppe eine Nachricht geschrieben hat?

Über jeder Nachricht steht der Name des Mitglieds. Ein Klick darauf öffnet seine Karte mit @Handle, Telegram-ID und dem Pfeil, der seinen Kontakt öffnet. In der App tippst du auf den Namen.

Wird jedes Gruppenmitglied zu einem Kontakt?

Jede Person, die in der Gruppe schreibt, ja, und es ist derselbe Kontakt, den Deskwoot nutzt, wenn sie deinem Bot direkt schreibt. Andere Bots und Admins, die anonym im Namen der Gruppe schreiben, bekommen keinen Kontakt. Bei älteren Nachrichten zeigt die Karte des Mitglieds stattdessen Als Kontakt speichern.

Antwortet Fynn in Telegram-Gruppen?

Nur wenn eine Nachricht deinen Bot erwähnt oder auf eine von Fynns eigenen Nachrichten antwortet. Alles andere in der Gruppe landet ohne automatische Antwort bei deinem Team. In einem privaten Chat antwortet Fynn wie auf deinen anderen Kanälen.

Sehe ich die Telefonnummer eines Gruppenmitglieds?

Nein. Telegram gibt einem Bot nie die Telefonnummer eines Mitglieds. Eine Telefonnummer steht nur da, wenn der Kontakt des Mitglieds in Deskwoot schon eine hat.

Welche Nachrichtentypen kommen in Deskwoot an?

Text, Fotos, Videos, Audiodateien, Sprachnachrichten und Dokumente, mit ihren Bildunterschriften. Sticker, Standorte, Umfragen und runde Videonachrichten erreichen Deskwoot nicht, und wenn jemand eine Nachricht später in Telegram bearbeitet, ändert sie sich in Deskwoot nicht. Deine Antworten können Text, Bilder, Videos, Audio und Dokumente enthalten. Sprachnachrichten und Audiodateien werden automatisch transkribiert, damit Fynn sie beantworten und dein Team sie lesen kann, siehe Fynn und Sprachnachrichten.

Was passiert, wenn eine Antwort den Kunden nicht erreicht?

Unter der Antwort steht Zustellung fehlgeschlagen. mit dem Grund von Telegram, zum Beispiel wenn der Kunde den Bot blockiert hat. Kam dein Text an, aber eine Datei nicht, sendet ein Klick nur die fehlende Datei noch einmal, siehe Wenn eine Antwort nicht zugestellt wird.

Kostet Telegram etwas pro Nachricht?

Nein. Telegram berechnet für seine Bot-API nichts. Wenn Fynn antwortet, zählt das wie auf jedem anderen Kanal als KI-Konversation in Deskwoot.

Wie erstelle ich einen Telegram-Bot?

Öffne Telegram, suche nach @BotFather, sende /newbot und folge den Anweisungen. Am Ende schickt dir BotFather einen API-Token. Füge ihn in Deskwoot ein.

Was mache ich, wenn mein Bot-Benutzername schon vergeben ist?

Benutzernamen von Telegram-Bots sind eindeutig und enden auf „bot“. Probiere Varianten wie AcmeSupportBot, AcmeHelpBot oder AcmeChatBot und nimm einen, der noch frei ist.

Kann ich mehrere Telegram-Bots verbinden?

Ja. Jeder Bot wird zu einem eigenen Posteingang. Das hilft bei getrennten Marken, Produktlinien oder Sprachen. Ein Bot kann nur mit einem Deskwoot-Posteingang verbunden sein.

Was passiert, wenn ich nach dem Verbinden einen neuen Bot-Token erzeuge?

Mit dem alten Token funktioniert der Posteingang nicht mehr, und den Token eines bestehenden Posteingangs kannst du nicht ändern. Lösche den alten Telegram-Posteingang unter Einstellungen > Posteingänge (seine Konversationen bleiben in Deskwoot) und verbinde den neuen Token als neuen Telegram-Posteingang. Nutze /revoke in BotFather nur, wenn es wirklich nötig ist.

Kann der Bot eine Konversation auf Telegram beginnen?

Nein. Telegram verlangt, dass die Person dem Bot zuerst schreibt. Danach kann dein Team ihr jederzeit antworten, ohne Zeitfenster.

Werden alte Telegram-Nachrichten importiert?

Nein. Telegram gibt Bots keine Nachrichten aus der Zeit, bevor sie in einem Chat waren. In Deskwoot erscheinen nur Nachrichten, die nach dem Verbinden des Bots geschrieben wurden (und in einer Gruppe erst, nachdem der Bot hinzugefügt wurde).

Was mache ich, wenn der Bot nicht mehr funktioniert?

Häufige Ursachen: Der Token wurde widerrufen, der Bot wurde in BotFather gelöscht, oder Telegram hat den Bot wegen Regelverstößen gesperrt. Prüfe deinen Bot in BotFather unter /mybots. Wenn du einen neuen Token erzeugst, verbinde ihn wie oben beschrieben als neuen Telegram-Posteingang.

Kann ich Profilbild und Beschreibung des Bots ändern?

Ja, in BotFather mit /setdescription, /setuserpic und /setname. Die Angaben sehen Leute, wenn sie deinen Bot zum ersten Mal öffnen.