AiHummer
Latviešu▾
PierakstītiesKonts
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanāli/Telegramma

Telegramma

v1.0.x · atjaunināts 2026-06-26

Telegram ir AiHummer ražošanas līmeņa, ieteicamais pirmais kanāls. Tā ir ātrākā metode, kā dabūt darba aģentu priekšā īstiem cilvēkiem: izveidojiet botu ar @BotFather, dodiet savienotājam žetonu, un ienākošie ziņojumi sāks plūst uz vārteju.

Telegram savienotājs tiek instalēts no produkta iekšienē Tirgus un konfigurēts administrēšanas lietotāja saskarnē. Tas darbojas uz saimniekmašīnas un sazinās ar vārteju pa ienākošo API, tādējādi tas mērogojas un restartējas neatkarīgi no pagrieziena dzinēja.

Savienot Telegram 6 soļos

Šeit ir pilns ceļvedis no nulles līdz botam, kas atbildēs tev Telegram. Viss, kas tev nepieciešams, ir Telegram konts un piekļuve savai AiHummer tīmekļa administrēšanas saskarnei.

  1. Izveido botu ar BotFather. Atveriet Telegram @BotFather, sūtīt /newbot, un iestatiet bota nosaukumu un lietotājvārds. Ko jūs redzēsiet: BotFather atgriež žetons patīk 123456789:AA… — šis ir bota piekļuves atslēga, nokopējiet to.
  2. Instalējiet Telegram savienotāju. Atveriet administrēšanas lietotāja interfeisu Spraudņi/Tirgus laukums, atrodiet Telegram savienotāju noklikšķiniet uz kataloga un pēc tam uz “Instalēt”. Gaidiet, līdz karte kļūs “tiešsaistē” (instalēšana tiek rādīta progresa josla).
  3. Ielīmējiet tokenu. Ej uz Kanāli ekrāns → tas Konfigurēt instalētos kanālus bloķēt, atveriet Telegram karti un ielīmējiet bota žetons ievadiet lauku no savienotāja formas. Saglabāt.
  4. Izveidot aģentu (ja tev tā vēl nav) — skatīt Aģents: vārds un sistēmas uzvedne ir pietiekami.
  5. Saistiet aģentu ar kanālu. Uz Kanāli ekrānā, iekš “Saites” bloks, izvēlies vienu noklusējuma aģents Telegramam — noteikums “jaunas Telegram sarunas tiek vadītas ar aģentu Y”. Izvēle tiek saglabāta uzreiz.
  6. Sūtīt ziņu botam. Atver savu botu Telegram un nosūti tam ziņu. Kas jūs redzēsiet: aģents atbild čatā, un parādās atbilstošā saruna administratora lietotāja interfeisa ekrānā “Sesijas”.

[!NOTE] Pēc noklusējuma aģents atbild zināmi lietotāji (cilvēki reģistrējušies AiHummer). Ja bots neatbild uz jūsu ziņu — pievienojiet sevi kā instances lietotājs, vai izslēgt “Atbildēt tikai zināmiem lietotājiem” Kanāli ekrāns.

Kāpēc sākt ar Telegram

Telegramam ir vismazākā berze no visiem AiHummer kanāliem: nav pārvadātāja, nav OAuth piekrišanas ekrāna, nav lietotņu pārskatīšanas. Lai sūtītu un saņemtu ziņojumus, pietiek ar bota tokenu, un tas pats savienotājs aptver gan iekšējo darbinieku tērzēšanu, gan klientiem paredzētus botus. Tā kā tas ir ražošanas līmeņa un pilnībā pārbaudīts, tas ir kanāls, kuru mēs iesakām vispirms izveidot, novērtējot AiHummer.

Aptauja vai tīmekļa āķis

Savienotājs atbalsta abus uzņemšanas režīmus, tāpēc tas darbojas neatkarīgi no tā, vai jūsu vārteja ir pieejama no publiskā interneta.

  • Ilgā aptauja — savienotājs izgūst atjauninājumus no Telegram. Nav ienākošā porta vai TLS ir nepieciešams, kas padara to ideāli piemērotu vietējai izstrādei un privātam tīkli.
  • Tīmekļa āķis — Telegram nosūta atjauninājumus uz publisku HTTPS URL. Mazāks latentums un labāk piemērots ražošanai aiz reversā starpniekservera, kas pabeidz TLS.

Savienotājs klausās uz ports 8800 parastā izvietošanā vai 8091 lokālam testam. Katrs ienākošais ziņojums tiek nosūtīts uz vārtejas URL, kas ir konfigurēts AIHUMMER_INBOUND_URL, autentificēts ar kopīgo ienākošo noslēpumu.

Bagātie ziņojumi, ziņojumu reakcijas un aptaujas

Papildus vienkāršam tekstam, Telegram kanāls attēlo Bagātie ziņojumi — formatētas atbildes, kas kartē aģenta strukturēto rezultātu uz Telegram vietējām ziņojumu funkcijām. Tas arī atbalsta ziņas reakcijas un aptaujas, tādējādi aģents var reaģēt uz lietotāja ziņojumu vai ievietot ātru aptauju tērzēšanā kā daļu no gājiena.

[!TIP] Telegram ir kanāls, kas AiHummer identificēts kā telegram. Izmantojiet to kanālu ID, kad jūs saistāt aģentu vai filtrējat sarunas pēc avota.

Bots ar botu cilpu aizsargu

Aģents var runāt ar citiem robotiem. Lai tas būtu droši, savienotājs piegādā cilpas sargs: tas nosaka un pārtrauc nekontrolētas botu savstarpējās apmaiņas, pirms tās pārvēršas bezgalīgā ping-pongā. Tas ļauj izveidot vairāku botu darbplūsmas bez klasiskās atgriezeniskās cilpas kļūmes.

Slepena starpniecība pār OIDC

Botu marķieris un citi savienotāja noslēpumi nekad netiek kodēti tieši pakalpojumā. Tā vietā savienotājs tos iegūst izpildes laikā no Noslēpumu serviss pār OIDC — tas autentificē, pēc tam iegūst nepieciešamās akreditācijas datus. Noslēpumi paliek šifrētā glabātuvē un netiek glabāti konfigurācijas failos un procesu argumentos.

[!NOTE] Ienākošie ziņojumi tiek nosūtīti uz AIHUMMER_INBOUND_URL un nodrošināts ar koplietotā HMAC ienākošā slepenā atslēga (AIHUMMER_INBOUND_SECRET). Vārtejai jābūt noklusējuma darba vieta konfigurēta, lai tos izsūtītu.

Ja tas nedarbojās

  • Telegram savienotājs nav ekrānā “Kanāli” — instalējiet to vispirms uz Spraudņi/Tirgus laukums ekrāns; līdz tiek uzstādīts kanāls nav redzams. Kopienas plānā pieejams tikai Telegram; pārējiem nepieciešama jaunināšana (HTTP 402).
  • Bots neatbild — pārbaudiet: (1) tokens ir pareizi ielīmēts un Telegrammas karte ir “tiešsaistē”; (2) kanāls ir saistīts ar aģentu sadaļā “Saistības”; (3) sūtītājs ir reģistrēts sistēmā (pēc noklusējuma aģents atbild tikai zināmi lietotāji).
  • Atbildes izskatās kā veidlapas — viltus modelis droši vien joprojām ir aktīvs; pievienojiet piegādātājs uz Modelis lapa.
  • “Neautorizēts” / marķieris noraidīts — žetons ir nepareizs vai atsaukts; ģenerēt jauns ar @BotFather (/token) un ielīmējiet to vēlreiz.
  • Webhook nesasniedz — webhook režīmā vārtejai jābūt pieejamai pie publisks HTTPS URL; privātā tīklā izmantojiet ilgstošu vaicāšanu, kam nav nepieciešami ienākošie savienojumi ports vai TLS.

Kur uz nākamo