AiHummer
Polski▾
Zaloguj sięKonto
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanały/Telegram

Telegram

v1.2.x · zaktualizowany 2026-06-26

Telegram jest produkcyjnym kanałem AiHummer, zalecanym jako pierwszy. To najszybszy sposób, aby postawić działającego agenta przed prawdziwymi ludźmi: stwórz bota z @BotFather, podaj konektorowi token, a przychodzące wiadomości zaczną napływać do bramy.

Konektor Telegrama jest instalowany z poziomu produktu Rynek i skonfigurowany w interfejsie administracyjnym. Działa natywnie na hoście i komunikuje się z bramą przez API przychodzące, więc skaluje się i uruchamia ponownie niezależnie od silnika turn.

Połącz Telegram w 6 krokach

Oto ścieżka od początku do końca, od zera do bota, który odpowiada ci w Telegramie. Wszystko, czego potrzebujesz, to konto na Telegramie i dostęp do swojej internetowej konsoli administracyjnej AiHummer.

  1. Utwórz bota za pomocą BotFather. W Telegramie otwórz @BotFather, wyślij /newbot, i ustaw nazwę bota oraz nazwa użytkownika. Co zobaczysz: BotFather zwraca token lubić 123456789:AA… — to jest klucz dostępu bota, skopiuj go.
  2. Zainstaluj łącznik Telegrama. Otwórz w interfejsie administracyjnym Wtyczki/Sklep, znajdź łącznik Telegram w katalog i kliknij „Zainstaluj”. Poczekaj, aż karta stanie się „online” (instalacja pasek postępu jest wyświetlany).
  3. Wklej token. Idź do Kanały ekran → Konfiguruj zainstalowane kanały zablokuj, otwórz kartę Telegram i wklej token bota do pola z formularza łącza. Zapisz.
  4. Utwórz agenta (jeśli jeszcze nie masz) — zobacz Agenci: wystarczy nazwa i podpowiedź systemowa.
  5. Powiąż agenta z kanałem. Na Kanały ekran, w Wiązania blok, wybierz domyślny agent dla Telegrama — zasada „nowe rozmowy na Telegramie są prowadzone przez agenta Y”. Wybór zapisuje się natychmiast.
  6. Wyślij wiadomość do bota. Otwórz swojego bota w Telegramie i wyślij mu wiadomość. Co zobaczysz: agent odpowiada na czacie, a odpowiadająca rozmowa się pojawia na ekranie „Sesje” w interfejsie administracyjnym.

[!NOTE] Domyślnie agent odpowiada tylko znani użytkownicy (osoby zarejestrowane w AiHummer). Jeśli bot nie odpowiada na twoją wiadomość — dodaj siebie jako użytkownik instancji lub wyłącz „Odpowiadaj tylko znanym użytkownikom” w Kanały ekran.

Dlaczego zacząć od Telegrama

Telegram ma najmniejszy opór spośród wszystkich kanałów AiHummer: brak operatora, brak ekranu zgody OAuth, brak przeglądu aplikacji. Wystarczy token bota, aby wysyłać i odbierać wiadomości, a ten sam łącznik obsługuje zarówno czaty wewnętrzne pracowników, jak i boty skierowane do klientów. Ponieważ jest to kanał produkcyjny i w pełni przetestowany, zalecamy podłączenie go w pierwszej kolejności podczas oceny AiHummer.

Pobieranie lub webhook

Konektor obsługuje oba tryby pobierania danych, więc działa niezależnie od tego, czy brama jest dostępna z publicznego internetu, czy nie.

  • Długie odpytywanie — łącznik pobiera aktualizacje z Telegrama. Brak portu przychodzącego lub wymagany jest TLS, co czyni go idealnym do lokalnego rozwoju i prywatnego sieci.
  • Webhook — Telegram wysyła aktualizacje na publiczny adres URL HTTPS. Niższe opóźnienia i lepiej nadaje się do produkcji za odwrotnym serwerem proxy, który kończy TLS.

Łącznik nasłuchuje na port 8800 w normalnym wdrożeniu, lub 8091 dla lokalnego uruchomienia. Każda przychodząca wiadomość jest wysyłana na adres URL bramki skonfigurowany w AIHUMMER_INBOUND_URL, uwierzytelnione za pomocą wspólnego sekretu przychodzącego.

Bogate wiadomości, reakcje na wiadomości i ankiety

Poza zwykłym tekstem, kanał Telegram wyświetla Bogate wiadomości — sformatowane odpowiedzi, które odwzorowują strukturalne dane agenta na natywne funkcje wiadomości Telegrama. Wspiera również reakcje na wiadomość i ankiety, więc agent może zareagować na wiadomość użytkownika lub wstawić szybką ankietę do czatu w ramach jednej tury.

[!TIP] Telegram to kanał zidentyfikowany dla AiHummer jako telegram. Użyj tego kanału id, kiedy przypisujesz agenta lub filtrujesz rozmowy według źródła.

Bot-do-bota z ochroną pętli

Agenci mogą rozmawiać z innymi botami. Aby to było bezpieczne, łącznik dostarcza strażnik pętli: wykrywa i przerywa wymiany botów, które wymknęły się spod kontroli, zanim przerodzą się w nieskończone ping-pongowanie. Pozwala to tworzyć przepływy pracy z udziałem wielu botów bez klasycznego trybu awarii pętli sprzężenia zwrotnego.

Tajne pośrednictwo przez OIDC

Token bota i inne sekrety konektora nigdy nie są na stałe wpisywane w usługę. Zamiast tego konektor pobiera je w czasie wykonywania z Usługa tajemnic przez OIDC — uwierzytelnia się, a następnie pobiera potrzebne poświadczenia. Sekrety pozostają w zaszyfrowanym sejfie i poza plikami konfiguracyjnymi oraz argumentami procesów.

[!NOTE] Wiadomości przychodzące są wysyłane do AIHUMMER_INBOUND_URL i zabezpieczone przez wspólne tajne HMAC przychodzące (AIHUMMER_INBOUND_SECRET). Bramkia musi mieć domyślne środowisko robocze skonfigurowane do ich wysyłania.

Jeśli to nie zadziałało

  • Konektor Telegram nie znajduje się na ekranie „Kanały” — najpierw zainstaluj to na ten Wtyczki/Sklep ekran; aż zostanie zainstalowany kanał nie jest wyświetlany. W planie Community dostępny jest tylko Telegram; reszta potrzebuje aktualizacji (HTTP 402).
  • Bot nie odpowiada — sprawdź: (1) czy token został poprawnie wklejony i Karta Telegramu jest „online”; (2) kanał jest powiązany z agentem w „Powiązaniach”; (3) nadawca jest zarejestrowany w systemie (domyślnie agent odpowiada tylko znani użytkownicy).
  • Odpowiedzi wyglądają jak szablony — model próbny prawdopodobnie wciąż jest aktywny; połącz dostawca na Modele strona.
  • “Nieautoryzowany” / token odrzucony — token jest nieprawidłowy lub cofnięty; wygeneruj nowy z @BotFather (/token) i wklej to ponownie.
  • Webhook nie dociera — w trybie webhook brama musi być osiągalna pod publiczny adres URL HTTPS; w sieci prywatnej użyj long pollingu, który nie wymaga połączeń przychodzących port lub TLS.

Dokąd dalej