> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Telegram ## Ü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](https://t.me/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](https://core.telegram.org/bots/features#privacy-mode) 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. > **Note** > > 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](https://t.me/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](https://core.telegram.org/bots/api#reactiontypeemoji) — 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. | > **Info** > > 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](/docs/de/eleven-agents/customization/personalization/dynamic-variables). ## Nützliche Links * [Dokumentation zur Telegram Bot API](https://core.telegram.org/bots/api) * [Datenschutzmodus](https://core.telegram.org/bots/features#privacy-mode) * [BotFather — Bots erstellen und verwalten](https://t.me/BotFather)