Telegram-Integration | Botpress Hub

Die Telegram-Integration ermöglicht es Botpress-Chatbots und KI-Agenten, über die offizielle Telegram Bot API mit Nutzern auf Telegram zu kommunizieren. Sie unterstützt bidirektionale Echtzeit-Kommunikation mit Text, Medien, Buttons und interaktiven Befehlen in privaten Chats oder Gruppen.

Im Hintergrund nutzt die Integration Telegraf – ein leistungsstarkes Node.js-Framework –, um Nachrichtenrouting, Befehle und Ereignisse von Telegram zu verwalten. Nachrichten, die Ihr KI-Agent sendet, werden automatisch von Markdown in das von Telegram unterstützte HTML-Format umgewandelt, sodass Text, Links und Formatierungen korrekt dargestellt werden.

Mit integrierten Funktionen zur Nachrichtenbereinigung und Anzeige von Tippindikatoren sorgt diese Integration für eine saubere, sichere und reaktionsschnelle Kommunikationserfahrung für Endnutzer. Entwickler können sie nutzen, um Updates zu automatisieren, Tickets zu bearbeiten oder ihre Chatbots mit minimalem Aufwand in Telegram-Communities einzubinden.

The Telegram integration allows your AI-powered chatbot to seamlessly interact with Telegram, a popular messaging platform with a large user base. Connect your chatbot to Telegram and engage with your audience in real-time conversations. With this integration, you can automate customer support, provide personalized recommendations, send notifications, and handle inquiries directly within Telegram. Leverage Telegram's rich features, including text messages, inline buttons, media files, and more, to create dynamic and interactive chatbot experiences. Empower your chatbot to deliver exceptional user experiences on Telegram with the Telegram Integration for Botpress.

## Migrating from version `0.x.x` to `1.x.x`

### Removal of proactive conversations (and proactive users)

- Telegram does not currently support proactive conversations, so any bots using this feature will need to be updated to use the normal conversation flow.

### Removal of dedicated Markdown messages type

- The `markdown` channel message type is being deprecated in favor of integrating this behavior into the base `text` message type.
- This new Markdown behavior (commonmark spec) will allow image Markdown. However, since Telegram does not support mixed message types, it will split the message into multiple messages with images sent in between text messages.

### Addition of message limits

- Telegram has a message length limit of 4096 characters, so that limit has been added to the text parameter in the `text` message payload. Going over this limit will result in the message being rejected.

FAQs

Was ist die Botpress Telegram-Integration und wie funktioniert sie?

Die Botpress Telegram-Integration verbindet einen Botpress-Chatbot oder KI-Agenten mit der offiziellen Telegram Bot API, sodass Unterhaltungen direkt in Telegram-Chats stattfinden können. Im Hintergrund verwendet die Integration das Botpress SDK zusammen mit dem Telegraf-Framework, um Updates von Telegram zu empfangen und Antworten in Echtzeit zurückzusenden. Eingehende Telegram-Nachrichten werden in Botpress-Ereignisse umgewandelt, sodass der Agent Richtlinien, Wissensabfragen und Workflows wie auf jedem anderen Kanal anwenden kann. Ausgehende Nachrichten werden vom internen Botpress-Nachrichtenformat in Telegram-kompatible Inhalte umgewandelt, einschließlich Unterstützung für Text, Inline-Buttons und Medien, wo dies möglich ist. Nach der Konfiguration mit einem Bot-Token und einer Webhook-URL übernimmt die Integration die technischen API-Aufrufe und Wiederholungen, sodass sich Teams auf die Gestaltung von Unterhaltungen konzentrieren können, anstatt HTTP-Anfragen zu programmieren.

Wie wird die Telegram-Integration in Botpress von Anfang bis Ende eingerichtet?

Die Einrichtung beginnt direkt in Telegram, indem ein Bot über den BotFather erstellt wird, der ein Bot-Token für den Zugriff auf die Telegram Bot API generiert. In Botpress Studio wird die Telegram-Integration aus dem Hub installiert und dann mit diesem Bot-Token in den Integrationseinstellungen konfiguriert. Der Konfigurationsbildschirm bietet einfache Optionen wie Aktiviert (um die Kommunikation ein- oder auszuschalten), Webhook-URL (wohin Telegram Updates sendet) und das Token-Feld zur Autorisierung der Integration. Nach dem Speichern registriert Botpress den Webhook und beginnt, auf neue Updates zu lauschen, sodass jede Nachricht an den Telegram-Bot als Ereignis im Botpress-Projekt erscheint. Ab diesem Zeitpunkt funktionieren Flows, Richtlinien und KI-Agenten in Telegram-Unterhaltungen genauso wie im Webchat oder auf anderen Kanälen – für eine einheitliche Architektur im gesamten System.

Welche Funktionen und Nachrichtentypen unterstützt die Telegram-Integration für Chatbots und KI-Agenten?

Die Telegram-Integration unterstützt Standard-Textnachrichten sowie viele der erweiterten Funktionen, für die Telegram bekannt ist, wie Inline-Buttons und Medienanhänge. Nachrichten, die von einem Botpress-KI-Agenten erzeugt werden, werden in Telegram-Nachrichtentypen umgewandelt, sodass sie interaktive Buttons, Schnellantwort-Flows und Links enthalten können, die den Telegram-Formatierungsregeln entsprechen. Tippindikatoren sind über integrationsspezifische Cards verfügbar, sodass ein Bot anzeigen kann, dass er gerade eine Antwort verfasst, und so ein natürlicheres Chat-Erlebnis für Nutzer schafft. Die Integration stellt außerdem Tags für Unterhaltungen und Nutzer bereit, wie eine Telegram-Konversations-ID oder Nutzer-ID, sodass fortgeschrittene Nutzer Telegram-Identitäten mit CRM-Datensätzen oder internen Systemen verknüpfen können. Diese Möglichkeiten machen die Telegram-Integration geeignet für Kundensupport, proaktive Benachrichtigungen (im Rahmen der Telegram-Beschränkungen), Community-Management und automatisierte Informationsabfragen.

Wie sorgt die Botpress Telegram-Integration für eine sichere Verarbeitung von Markdown, HTML und Nachrichtenformatierung?

Telegram unterstützt bestimmte Formatierungsmodi wie HTML und Markdown, ist jedoch streng bei erlaubten Tags und Zeichen. Um zuverlässig formatierte Inhalte zu liefern, nutzt die Integration eine Markdown-Verarbeitungspipeline auf Basis von markdown-it, um Botpress-Inhalte in Telegram-kompatibles HTML umzuwandeln, und setzt sanitize-html ein, um unsichere Tags und Attribute vor dem Versand zu entfernen oder zu maskieren. So wird sichergestellt, dass Überschriften, Fettdruck, Links und Listen korrekt angezeigt werden, ohne Nachrichten zu beschädigen oder Nutzer unsicherem HTML auszusetzen. Zusätzlich hält sich die Integration an Telegrams Vorgaben zu gemischten Inhalten und Nachrichtenlängen, indem Text und Bilder bei Bedarf in mehrere Nachrichten aufgeteilt werden, sodass auch komplexe Inhalte eines KI-Agenten sauber im Telegram-Client erscheinen. Teams können dadurch in Botpress reichhaltige, auf Markdown basierende Inhalte gestalten, während die Integration alle Telegram-spezifischen Formatierungsdetails im Hintergrund übernimmt.

Was sind typische Anwendungsfälle für den Einsatz eines Botpress-Chatbots oder KI-Agenten auf Telegram?

Ein mit Telegram verbundener KI-Agent wird meist für Kundensupport, Community-Interaktion oder transaktionale Nachrichten in Kanälen genutzt, in denen Telegram bereits eine große Nutzerbasis hat. Viele Teams setzen die Integration ein, um sofortigen Self-Service-Support, automatisierte FAQs und Ticket-Vorqualifizierung direkt in Telegram-Chats anzubieten und so separate Webportale oder Apps zu vermeiden. Andere nutzen sie, um Bestellupdates, Kontobenachrichtigungen oder Produktankündigungen an Abonnenten zu senden, die Telegram als bevorzugten Kommunikationskanal nutzen. Da Telegram Gruppen und Supergruppen unterstützt, eignet sich die Integration auch für Community-Moderation, das Weiterleiten komplexer Anfragen an menschliche Agenten über Botpress-Richtlinien und das Erfassen von Feedback von Power-Usern in Echtzeit. In Kombination mit Botpress-Funktionen wie Wissensabfrage, Richtlinien und Human-in-the-Loop wird die Telegram-Integration zu einem flexiblen Einstiegspunkt für jede Organisation, die ihren Chatbot oder KI-Agenten einer bestehenden Telegram-Zielgruppe zugänglich machen möchte.

Betreut von

Botpress-Team

Telegram

FAQs

Beliebte Integrationen entdecken