> 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

## Ö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](https://t.me/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](https://core.telegram.org/bots/features#privacy-mode). 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.

> **Note**
>
> 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](https://t.me/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](https://core.telegram.org/bots/api#reactiontypeemoji) 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. |

> **Info**
>
> 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](/docs/sv/eleven-agents/customization/personalization/dynamic-variables) för hur du refererar till dessa i promptar och verktygsanrop.

## Användbara länkar

* [Telegram Bot API-dokumentation](https://core.telegram.org/bots/api)
* [Integritetsläge](https://core.telegram.org/bots/features#privacy-mode)
* [BotFather — skapa och hantera botar](https://t.me/BotFather)