> 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

## Omówienie

Połącz swoich agentów AI ElevenLabs z Telegramem, aby odpowiadali na wiadomości wysyłane do twojego bota. Ta integracja pozwala agentom odbierać wiadomości prywatne i grupowe, sprawdzać informacje o czacie, wysyłać odpowiedzi i reagować na wiadomości przez Telegram Bot API.

## Możliwości

| Możliwość                   | Obsługa                                                                                                  |
| --------------------------- | -------------------------------------------------------------------------------------------------------- |
| Tryb zerowej retencji (ZRM) | Nieobsługiwany                                                                                           |
| Załączniki w wyzwalaczach   | Nieobsługiwane — zdjęcia, pliki i inne media w przychodzących wiadomościach nie są przekazywane agentowi |
| Załączniki w narzędziach    | Nieobsługiwane — narzędzia działają tylko na tekście                                                     |

## Konfiguracja

#### Utwórz bota Telegram

Otwórz Telegram i rozpocznij rozmowę z [@BotFather](https://t.me/BotFather). Wyślij `/newbot` i postępuj zgodnie z instrukcjami, aby wybrać nazwę i nazwę użytkownika bota. BotFather odpowie tokenem bota.

#### Połącz w ElevenLabs

W konfiguracji integracji ElevenLabs kliknij **Połącz** i wklej token bota z BotFather.

#### Włącz wyzwalacz

Po połączeniu włącz wyzwalacz **Telegram Message** i wybierz agenta, który ma obsługiwać przychodzące wiadomości. ElevenLabs automatycznie zarejestruje webhook w Telegramie, aby twój bot zaczął odbierać wiadomości.

## Używanie bota w grupach

Bot **nie** musi być administratorem grupy, a ty **nie** musisz wyłączać [trybu prywatności](https://core.telegram.org/bots/features#privacy-mode) Telegrama. Gdy tryb prywatności jest włączony (domyślnie), Telegram dostarcza wiadomości bezpośrednio kierowane do bota — właśnie takich nasłuchuje ta integracja:

* **Wzmianki przez `@`** o nazwie użytkownika bota, na przykład `@my_bot jaki jest status?`.
* **Odpowiedzi na własne wiadomości bota**, także kolejne wiadomości w tej samej rozmowie.

Wiadomości, które nie są skierowane do bota, są celowo ignorowane. Bot ignoruje też wiadomości od innych botów i nie reaguje na edytowane ani usunięte wiadomości.

> **Note**
>
> Telegram stosuje zmiany trybu prywatności i roli administratora tylko w grupach, do których bot dołącza **po**
> zmianie. Jeśli wcześniej zmieniałeś tryb prywatności w [@BotFather](https://t.me/BotFather) lub zrobiłeś
> bota administratorem grupy, by „naprawić” wzmianki, usuń go z grupy i dodaj ponownie, aby nowe
> ustawienie zaczęło działać — zwykle to sprawia, że wzmianki zaczynają działać, a nie sama rola
> administratora.

W czatach grupowych i supergrupach odpowiedź agenta jest wysyłana jako cytowana odpowiedź na wiadomość wyzwalającą, więc pozostaje wizualnie powiązana z pytaniem nawet przy dużej aktywności na czacie. W prywatnych czatach 1:1 cytowana odpowiedź jest pomijana, bo byłaby zbędna.

## Narzędzia agenta

Gdy dodasz do agenta narzędzia Telegrama, dostępne będą następujące wbudowane narzędzia:

| Narzędzie                   | Opis                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `telegram_get_chat`         | Pobiera metadane bieżącego czatu, takie jak typ, tytuł, nazwa użytkownika i opis. `chat_id` jest powiązany z bieżącą rozmową i nie można go zmienić.                                                                                                                                                                                                                                                                                                    |
| `telegram_send_message`     | Wysyła wiadomość tekstową na bieżący czat. `chat_id` jest powiązany; model kontroluje `text` oraz opcjonalny `parse_mode` (`HTML`, `Markdown` lub `MarkdownV2`).                                                                                                                                                                                                                                                                                        |
| `telegram_react_to_message` | Reaguje na wiadomość wyzwalającą pojedynczym emoji z dozwolonego dla botów [zestawu reakcji](https://core.telegram.org/bots/api#reactiontypeemoji) Telegrama — przydatne, gdy krótkie potwierdzenie (`👍`, `🎉`, `❤`) jest bardziej naturalne niż odpowiedź tekstowa. Zarówno `chat_id`, jak i `message_id` są powiązane z wiadomością źródłową. Ustawienie nowej reakcji zastępuje każdą reakcję, którą bot wcześniej ustawił na tej samej wiadomości. |

> **Info**
>
> Niektóre czaty ograniczają dozwolone emoji w ustawieniu Telegrama **Available reactions**. Jeśli
> wywołanie reakcji zostanie odrzucone, poinstruuj agenta, aby przeszedł na odpowiedź tekstową.

## Zmienne dynamiczne

Gdy agent działa z Telegrama, w promptach i narzędziach dostępne są następujące zmienne dynamiczne:

| Zmienna                               | Opis                                                                                 |
| ------------------------------------- | ------------------------------------------------------------------------------------ |
| `integration__telegram_chat_id`       | ID czatu Telegram, w którym odbywa się rozmowa.                                      |
| `integration__telegram_message_id`    | Telegramowe `message_id` wiadomości użytkownika, która wywołała bieżącą turę agenta. |
| `integration__telegram_connection_id` | ID połączenia integracji ElevenLabs.                                                 |

Zobacz [zmienne dynamiczne](/docs/pl/eleven-agents/customization/personalization/dynamic-variables), aby dowiedzieć się, jak odwoływać się do nich w promptach i wywołaniach narzędzi.

## Przydatne linki

* [Dokumentacja Telegram Bot API](https://core.telegram.org/bots/api)
* [Tryb prywatności](https://core.telegram.org/bots/features#privacy-mode)
* [BotFather — tworzenie i zarządzanie botami](https://t.me/BotFather)