Telegram | ElevenLabs Documentation

Koppel je ElevenLabs-agents aan 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. 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 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.

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 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 — 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.

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 voor informatie over het gebruik hiervan in prompts en tooloproepen.