> 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 ## Overzicht Koppel je ElevenLabs AI-agenten aan Telegram om te reageren op berichten die naar je bot worden gestuurd. Met deze integratie kunnen je agenten inkomende berichten in privéchats en groepen ontvangen, chatinformatie opzoeken, antwoorden versturen en op berichten reageren via de Telegram Bot API. ## Mogelijkheden | Mogelijkheid | Ondersteuning | | ------------------------- | ------------------------------------------------------------------------------------------------------------------ | | Zero retention mode (ZRM) | Niet ondersteund | | Bijlagen in triggers | Niet ondersteund — foto's, bestanden en andere media in inkomende berichten worden niet doorgestuurd naar de agent | | Bijlagen in tools | Niet ondersteund — tools werken alleen met tekst | ## Instellen #### Een Telegram-bot maken Open Telegram en start een gesprek met [@BotFather](https://t.me/BotFather). Stuur `/newbot` en volg de aanwijzingen om een naam en gebruikersnaam voor je bot te kiezen. BotFather stuurt vervolgens een bottoken. #### Verbinden in ElevenLabs Klik in de integratie-instellingen van ElevenLabs op **Verbinden** en plak het bottoken van BotFather. #### De trigger inschakelen Schakel na het verbinden de trigger **Telegram-bericht** in en selecteer de agent die inkomende berichten moet afhandelen. ElevenLabs registreert automatisch een webhook bij Telegram, zodat je bot berichten begint te ontvangen. ## De bot gebruiken in groepen De bot hoeft **geen** beheerder van de groep te zijn en je hoeft de [privacymodus](https://core.telegram.org/bots/features#privacy-mode) van Telegram **niet** uit te schakelen. Als de privacymodus is ingeschakeld (de standaardinstelling), bezorgt Telegram berichten die expliciet aan de bot zijn gericht. Dat is precies waar deze integratie naar luistert: * **`@`-vermeldingen** van de gebruikersnaam van de bot, bijvoorbeeld `@my_bot wat is de status?`. * **Antwoorden op berichten van de bot zelf**, inclusief vervolgberichten binnen hetzelfde gesprek. Berichten die niet aan de bot zijn gericht, worden bewust genegeerd. De bot negeert ook berichten van andere bots en onderneemt geen actie bij bewerkte of verwijderde berichten. > **Note** > > Telegram past wijzigingen in de privacymodus en beheerdersrol alleen toe op groepen waar de bot **na** de > wijziging lid van wordt. Als je eerder de privacymodus in [@BotFather](https://t.me/BotFather) hebt gewijzigd, of de > bot beheerder van een groep hebt gemaakt om vermeldingen te "repareren", verwijder de bot dan uit de groep en voeg hem opnieuw toe, zodat de nieuwe > instelling van kracht wordt — meestal zorgt dat ervoor dat vermeldingen werken, niet de beheerdersrol > zelf. In groeps- en supergroepchats wordt het antwoord van de agent als citaatantwoord op het bericht dat de trigger activeerde verstuurd. Zo blijft het antwoord visueel gekoppeld aan de vraag, ook wanneer de chat druk is. In privéchats tussen twee personen wordt het citaatantwoord onderdrukt, omdat het overbodig zou zijn. ## Agenttools Wanneer je Telegram-tools aan een agent toevoegt, zijn de volgende ingebouwde tools beschikbaar: | Tool | Beschrijving | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `telegram_get_chat` | Zoekt metadata op over de huidige chat, zoals het type, de titel, gebruikersnaam en beschrijving. De `chat_id` is gekoppeld aan het huidige gesprek en kan niet worden gewijzigd. | | `telegram_send_message` | Stuurt een tekstbericht naar de huidige chat. `chat_id` is gekoppeld; het model beheert `text` en de optionele `parse_mode` (`HTML`, `Markdown` of `MarkdownV2`). | | `telegram_react_to_message` | Reageert op het bericht dat de trigger activeerde met één emoji uit de door Telegram voor bots toegestane [reactieset](https://core.telegram.org/bots/api#reactiontypeemoji) — handig wanneer een korte bevestiging (`👍`, `🎉`, `❤`) natuurlijker is dan een tekstantwoord. Zowel `chat_id` als `message_id` zijn gekoppeld aan de oorspronkelijke beurt. Een nieuwe reactie instellen vervangt elke reactie die de bot eerder op hetzelfde bericht heeft ingesteld. | > **Info** > > Sommige chats beperken welke emoji zijn toegestaan via de instelling **Beschikbare reacties** van Telegram. Als een > reactieoproep wordt afgewezen, instrueer de agent dan om terug te vallen op een tekstantwoord. ## Dynamische variabelen Wanneer een agent via Telegram wordt uitgevoerd, zijn de volgende dynamische variabelen beschikbaar in prompts en tools: | Variabele | Beschrijving | | ------------------------------------- | ------------------------------------------------------------------------------------- | | `integration__telegram_chat_id` | Telegram-chat-ID waar het gesprek plaatsvindt. | | `integration__telegram_message_id` | Telegram-`message_id` van het gebruikersbericht dat de huidige agentbeurt activeerde. | | `integration__telegram_connection_id` | ID van de ElevenLabs-integratieverbinding. | Lees [dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables) voor informatie over het gebruik hiervan in prompts en tooloproepen. ## Handige links * [Documentatie voor de Telegram Bot API](https://core.telegram.org/bots/api) * [Privacymodus](https://core.telegram.org/bots/features#privacy-mode) * [BotFather — bots maken en beheren](https://t.me/BotFather)