Telegram | ElevenLabs Documentation

Anslut dina ElevenLabs-agenter till Telegram

Översikt

Anslut dina AI-agenter från ElevenLabs till Telegram för att svara på meddelanden som skickas till din bot. Den här integrationen gör det möjligt för dina agenter att ta emot inkommande meddelanden i privata chattar och grupper, hämta chattinformation, skicka svar och reagera på meddelanden via Telegram Bot API.

Funktioner

Funktion	Stöd
Nollagringsläge (ZRM)	Stöds inte
Bilagor i utlösare	Stöds inte — foton, filer och andra medier i inkommande meddelanden vidarebefordras inte till agenten
Bilagor i verktyg	Stöds inte — verktygen hanterar endast text

Konfigurera

Skapa en Telegram-bot

Öppna Telegram och starta en konversation med @BotFather. Skicka /newbot och följ anvisningarna för att välja namn och användarnamn för din bot. BotFather svarar med en bottoken.

Anslut i ElevenLabs

Klicka på Connect i inställningarna för ElevenLabs-integrationen och klistra in bottoken från BotFather.

Aktivera utlösaren

Efter anslutningen aktiverar du utlösaren Telegram Message och väljer agenten som ska hantera inkommande meddelanden. ElevenLabs registrerar automatiskt en webhook hos Telegram så att din bot börjar ta emot meddelanden.

Använda boten i grupper

Boten behöver inte vara administratör i gruppen och du behöver inte inaktivera Telegrams integritetsläge. När integritetsläget är aktiverat (standardinställningen) levererar Telegram meddelanden som uttryckligen riktas till boten, vilket är precis vad den här integrationen lyssnar efter:

@-omnämnanden av botens användarnamn, till exempel @my_bot what's the status?.
Svar på botens egna meddelanden, inklusive uppföljande turer i samma konversation.

Meddelanden som inte riktas till boten ignoreras avsiktligt. Boten ignorerar även meddelanden från andra botar och agerar inte på redigerade eller raderade meddelanden.

Telegram tillämpar ändringar av integritetsläge och administratörsroll endast på grupper som boten går med i efter ändringen. Om du tidigare har växlat integritetsläget i @BotFather, eller gjort boten till gruppadministratör för att ”fixa” omnämnanden, tar du bort boten från gruppen och lägger till den igen så att den nya inställningen börjar gälla — det är vanligtvis det som får omnämnanden att fungera, inte administratörsrollen i sig.

I grupp- och supergruppschattar skickas agentens svar som ett citerat svar på det utlösande meddelandet, så att svaret förblir visuellt kopplat till frågan även när chatten är aktiv. I privata 1:1-chattar utelämnas det citerade svaret eftersom det skulle vara överflödigt.

Agentverktyg

När du lägger till Telegram-verktyg till en agent finns följande inbyggda verktyg tillgängliga:

Verktyg	Beskrivning
`telegram_get_chat`	Hämtar metadata om den aktuella chatten (till exempel typ, titel, användarnamn och beskrivning). `chat_id` är bundet till den aktuella konversationen och kan inte omdirigeras.
`telegram_send_message`	Skickar ett textmeddelande till den aktuella chatten. `chat_id` är bundet; modellen styr `text` och den valfria `parse_mode` (`HTML`, `Markdown` eller `MarkdownV2`).
`telegram_react_to_message`	Reagerar på det utlösande meddelandet med en enda emoji från Telegrams reaktionsuppsättning som är tillåten för botar — användbart när en kort bekräftelse (`👍`, `🎉`, `❤`) känns mer naturlig än ett textsvar. Både `chat_id` och `message_id` är bundna till den ursprungliga turen. En ny reaktion ersätter en reaktion som boten tidigare har angett på samma meddelande.

Vissa chattar begränsar vilka emoji som är tillåtna via Telegrams inställning Available reactions. Om ett reaktionsanrop avvisas ska du instruera agenten att i stället använda ett textsvar.

Dynamiska variabler

När en agent körs från Telegram är följande dynamiska variabler tillgängliga i promptar och verktyg:

Variabel	Beskrivning
`integration__telegram_chat_id`	Telegram-chatt-ID där konversationen pågår.
`integration__telegram_message_id`	Telegram-`message_id` för användarmeddelandet som utlöste den aktuella agentturen.
`integration__telegram_connection_id`	ID för ElevenLabs-integrationsanslutningen.

Se dynamiska variabler för hur du refererar till dessa i promptar och verktygsanrop.