Telegram | ElevenLabs Documentation

Połącz swoich agentów ElevenLabs z Telegramem

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

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

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, aby dowiedzieć się, jak odwoływać się do nich w promptach i wywołaniach narzędzi.