Telegram | ElevenLabs Documentation

Übersicht

Verbinden Sie Ihre ElevenLabs-KI-Agenten mit Telegram, um auf Nachrichten zu antworten, die an Ihren Bot gesendet werden. Mit dieser Integration können Ihre Agenten eingehende Nachrichten in privaten Chats und Gruppen empfangen, Chat-Informationen abrufen, Antworten senden und über die Telegram Bot API auf Nachrichten reagieren.

Funktionen

Funktion	Unterstützung
Zero Retention Mode (ZRM)	Nicht unterstützt
Anhänge in Triggern	Nicht unterstützt — Fotos, Dateien und andere Medien in eingehenden Nachrichten werden nicht an den Agenten weitergeleitet
Anhänge in Tools	Nicht unterstützt — Tools arbeiten nur mit Text

Einrichtung

Telegram-Bot erstellen

Öffnen Sie Telegram und starten Sie eine Unterhaltung mit @BotFather. Senden Sie /newbot und folgen Sie den Anweisungen, um einen Namen und Benutzernamen für Ihren Bot zu wählen. BotFather antwortet mit einem Bot-Token.

In ElevenLabs verbinden

Klicken Sie in der ElevenLabs-Integrationseinrichtung auf Verbinden und fügen Sie den Bot-Token von BotFather ein.

Trigger aktivieren

Aktivieren Sie nach dem Verbinden den Trigger Telegram Message und wählen Sie den Agenten aus, der eingehende Nachrichten verarbeiten soll. ElevenLabs registriert automatisch einen Webhook bei Telegram, damit Ihr Bot Nachrichten empfangen kann.

Bot in Gruppen verwenden

Der Bot muss kein Gruppenadministrator sein, und Sie müssen den Datenschutzmodus von Telegram nicht deaktivieren. Bei aktiviertem Datenschutzmodus (standardmäßig aktiviert) stellt Telegram Nachrichten zu, die den Bot ausdrücklich ansprechen. Genau auf diese Nachrichten reagiert die Integration:

@-Erwähnungen des Bot-Benutzernamens, zum Beispiel @my_bot what's the status?.
Antworten auf eigene Nachrichten des Bots, einschließlich weiterer Nachrichten innerhalb derselben Unterhaltung.

Nachrichten, die den Bot nicht ansprechen, werden absichtlich ignoriert. Der Bot ignoriert außerdem Nachrichten anderer Bots und verarbeitet keine bearbeiteten oder gelöschten Nachrichten.

Telegram übernimmt Änderungen am Datenschutzmodus und an Administratorrollen nur für Gruppen, denen der Bot nach der Änderung beitritt. Wenn Sie den Datenschutzmodus zuvor in @BotFather geändert oder den Bot zum Gruppenadministrator gemacht haben, um Erwähnungen zu „reparieren“, entfernen Sie den Bot aus der Gruppe und fügen Sie ihn erneut hinzu, damit die neue Einstellung wirksam wird — normalerweise sorgt das dafür, dass Erwähnungen funktionieren, nicht die Administratorrolle selbst.

In Gruppen- und Supergruppen-Chats wird die Antwort des Agenten als Zitatantwort auf die auslösende Nachricht gesendet. So bleibt die Antwort auch in einem aktiven Chat visuell mit der Frage verknüpft. In privaten 1:1-Chats wird die Zitatantwort unterdrückt, da sie überflüssig wäre.

Agenten-Tools

Wenn Sie einem Agenten Telegram-Tools hinzufügen, stehen die folgenden integrierten Tools zur Verfügung:

Tool	Beschreibung
`telegram_get_chat`	Ruft Metadaten zum aktuellen Chat ab, etwa Typ, Titel, Benutzername und Beschreibung. Die `chat_id` ist an die aktuelle Unterhaltung gebunden und kann nicht geändert werden.
`telegram_send_message`	Sendet eine Textnachricht an den aktuellen Chat. `chat_id` ist gebunden; das Modell steuert `text` und den optionalen `parse_mode` (`HTML`, `Markdown` oder `MarkdownV2`).
`telegram_react_to_message`	Reagiert auf die auslösende Nachricht mit einem einzelnen Emoji aus dem von Telegram für Bots erlaubten Reaktionssatz — nützlich, wenn eine kurze Bestätigung (`👍`, `🎉`, `❤`) natürlicher ist als eine Textantwort. Sowohl `chat_id` als auch `message_id` sind an den ursprünglichen Turn gebunden. Das Setzen einer neuen Reaktion ersetzt jede Reaktion, die der Bot zuvor auf dieselbe Nachricht gesetzt hat.

Einige Chats beschränken über die Telegram-Einstellung Verfügbare Reaktionen, welche Emojis erlaubt sind. Wenn ein Reaktionsaufruf abgelehnt wird, weisen Sie den Agenten an, stattdessen mit einer Textantwort zu reagieren.

Dynamische Variablen

Wenn ein Agent über Telegram ausgeführt wird, sind die folgenden dynamischen Variablen in Prompts und Tools verfügbar:

Variable	Beschreibung
`integration__telegram_chat_id`	Telegram-Chat-ID, in dem die Unterhaltung stattfindet.
`integration__telegram_message_id`	Telegram-`message_id` der Benutzernachricht, die den aktuellen Agenten-Turn ausgelöst hat.
`integration__telegram_connection_id`	ID der ElevenLabs-Integrationsverbindung.

Wie Sie diese in Prompts und Tool-Aufrufen referenzieren, erfahren Sie unter dynamische Variablen.