AiHummer
Lietuvių▾
PrisijungtiPaskyra
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanalai/Telegrama

Telegrama

v1.1.x · atnaujinta 2026-06-26

Telegram yra AiHummer gamybinio lygio, rekomenduojamas pirmasis kanalas. Tai greičiausias būdas turėti veikiantį agentą prieš tikrus žmones: sukurkite robotą su @BotFather, suteikite jungikliui žetoną, ir įeinantys pranešimai pradės tekėti į vartus.

„Telegram“ jungtis įdiegta iš produkto viduje Prekyvietė ir sukonfigūruotas Administratoriaus sąsajoje. Jis veikia natūraliai prie pagrindinio kompiuterio ir bendrauja su vartų mazgu per įeinantį API, todėl jis gali būti mastuojamas ir paleidžiamas iš naujo nepriklausomai nuo posūkio variklio.

Prisijunkite prie Telegram per 6 žingsnius

Štai pilnas kelias nuo nulio iki roboto, kuris jums atsako „Telegram“ programoje. Viskas, ko jums reikia, tai „Telegram“ paskyra ir prieiga prie jūsų AiHummer internetinės administravimo sąsajos.

  1. Sukurkite botą su BotFather. Atidarykite Telegram @BotFather, siųsti /newbot, ir nustatykite boto vardą ir vartotojo vardas. Ką pamatysite: BotFather grąžina žetonas patinka 123456789:AA… — tai yra roboto prieigos raktas, nukopijuok jį.
  2. Įdiekite „Telegram“ jungtį. Atidarykite administratoriaus sąsajoje Įskiepiai/Rinkos vieta, suraskite „Telegram“ jungtį katalogą ir spustelėkite „Įdiegti“. Palaukite, kol kortelė taps „prisijungusi“ (įdiegimas rodomas progreso juostos indikatorius).
  3. Įklijuokite žetoną. Eiti į Kanalai ekranas → tas Konfigūruoti įdiegtas kanalus blokuoti, atidaryti Telegram kortelę ir įklijuoti roboto žetonas į lauką iš jungties formos. Išsaugoti.
  4. Sukurti agentą (jei jo dar neturite) — žr. Agentai: pakanka vardo ir sistemos užklausos.
  5. Pririškite agentą prie kanalo. Ant Kanalai ekranas, į “Sąsajos” blokuoti, pasirinkti numatytasis agentas Telegramui — taisyklė „naujas Telegram pokalbis valdomas agento Y“. Pasirinkimas išsaugomas iš karto.
  6. Siųsk žinutę botui. Atidarykite savo botą Telegram ir parašykite jam žinutę. Kas jūs pamatysite: agentas atsako pokalbyje, ir atsiranda atitinkamas pokalbis administratoriaus sąsajoje ekrane „Sesijos“.

[!NOTE] Pagal numatytuosius nustatymus agentas atsako tik žinomi vartotojai (žmonės registruoti AiHummer). Jei botas liks tylus į jūsų žinutę – arba pridėkite save kaip pavyzdžio vartotojas arba išjunkite „Atsakyti tik žinomiems vartotojams“ Kanalai ekranas.

Kodėl pradėti nuo Telegram

„Telegram“ turi mažiausią trintį iš visų AiHummer kanalų: nėra vežėjo, nėra OAuth sutikimo ekrano, nėra programėlės peržiūros. Pakanka botų žetono, kad būtų galima siųsti ir gauti žinutes, o tas pats jungiklis aptarnauja tiek vidinius darbuotojų pokalbius, tiek su klientais susijusius botus. Kadangi jis yra gamybinio lygio ir visiškai išbandytas, tai yra kanalas, kurį rekomenduojame prijungti pirmiausia, vertinant AiHummer.

Apklausos arba žiniatinklio kablio

Jungtis palaiko abu įvedimo režimus, todėl ji veikia tiek, jei jūsų vartai yra pasiekiami iš viešojo interneto, tiek jei ne.

  • Ilgas užklausos laukimas — jungtis traukia naujinimus iš Telegram. Nėra įeinančio prievado arba reikalingas TLS, dėl ko tai puikiai tinka vietiniam kūrimui ir privačiam naudojimui tinklai.
  • Tinklo kabliukas — „Telegram“ siunčia atnaujinimus į viešą HTTPS URL. Mažesnė delsos trukmė ir geriau tinka gamybai už atvirkštinio tarpinio serverio, kuris užbaigia TLS,.

Jungtis klausosi prievadas 8800 įprastame diegime arba 8091 vietiniam paleidimui. Kiekviena įeinanti žinutė siunčiama į tinklo vartų URL, sukonfigūruotą AIHUMMER_INBOUND_URL, autentifikuota naudojant bendrą įeinantį slaptąjį raktą.

Pažangios žinutės, žinučių reakcijos ir apklausos

Be paprasto teksto, „Telegram“ kanalas rodo Turtingos žinutės — suformatuoti atsakymai, kurie pritaiko agento struktūruotą išvestį prie „Telegram“ natyvios žinučių funkcijų. Taip pat palaiko žinučių reakcijos ir apklausos, todėl agentas gali reaguoti į vartotojo žinutę arba įdėti greitą apklausą į pokalbį kaip dalį turno.

[!TIP] Telegram yra kanalas, identifikuotas AiHummer kaip telegram. Naudokite tą kanalą ID, kai pririšate agentą arba filtruojate pokalbius pagal šaltinį.

Botas su botu su kilpos apsauga

Agentai gali kalbėtis su kitais botais. Kad tai būtų saugu, jungtis siūlo kilpos sargybinis: jis aptinka ir nutraukia išsibėgančius botų tarpusavio mainus, kol jie netampa begaline ping-pong žaidimo forma. Tai leidžia jums kurti daugelio botų darbo srautus be klasikinio atsiliepimų ciklo gedimo režimo.

Slaptas tarpininkavimas per OIDC

Botų žetonas ir kitos jungties paslaptys niekada nėra įrašomos į paslaugą tiesiogiai. Vietoj to jungtis jas gauna vykdymo metu iš Paslaugų paslaptys per OIDC — jis autentifikuoja, tada gauna reikalingus prisijungimo duomenis. Slaptažodžiai lieka užšifruotame seife ir neatrodo konfigūracijos failuose bei proceso argumentuose.

[!NOTE] Įeinantys pranešimai skelbiami AIHUMMER_INBOUND_URL ir užtikrinta naudojant bendras HMAC įeinantis slaptažodis (AIHUMMER_INBOUND_SECRET). Vartai turi turėti numatytoji darbo sritis sukonfigūruota jas išsiųsti.

Jeigu tai neveiktų

  • „Telegram“ jungtis nėra „Kanaluose“ ekrane — pirmiausia įdiekite tai į tas Įskiepiai/Rinkos vieta ekranas; kol įdiegtas kanalas nerodomas. Tik bendruomenės plane yra prieinama Telegram; likusioms reikalingas atnaujinimas (HTTP 402).
  • Botas neatsako — patikrinkite: (1) žetonas įklijuotas teisingai ir „Telegram“ kortelė yra „internete“; (2) kanalas yra susietas su agentu skiltyje „Sąsajos“; (3) siuntėjas yra užregistruotas sistemoje (pagal numatytuosius nustatymus agentas atsako tik žinomi naudotojai).
  • Atsakymai atrodo su šablonu — šis bandomasis modelis tikriausiai vis dar aktyvus; prijunkite teikėjas ant Modeliai puslapis.
  • “Neautorizuota” / žetonas atmestas — žetonas neteisingas arba atšauktas; sugeneruok naujasis su @BotFather (/token) ir įklijuokite jį dar kartą.
  • Webhookas neateina — webhook režimu vartai turi būti pasiekiami adresu viešas HTTPS URL; privačiame tinkle naudokite ilgą užklausų laukimą (long polling), kuriam nereikia įeinančių ryšių prievadas arba TLS.

Kur toliau