AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanallar/Telegram

Telegram

v1.0.x · täzelendi 2026-06-26

Telegram AiHummer-iň önümçilik derejesindäki, maslahat berlen birinji kanaldyr. Hakyky adamlaryň öňüne işleýän agenti çykarmagyň iň çalt usuly: bilen bot dörediň @BotFather, birikdirijiň tokenini beriň we gelýän habarlar gapyja akyp başlaýar.

Telegram birikdirijisi önümiň öňünden gurnaldy Bazar we wekilçilik ulanyjy interfeýsinde sazlanýar. Ol serweriň özüni işledýär we girdi API arkaly gateway bilen aragatnaşyk saklaýar, şonuň üçin ol öwrüliş ulgamyndan garaşsyz ösdürilýär we täzeden işleýär.

Telegrama 6 ädimde birikdiriň

Mundan beýläk Telegramda size jogap berýän bot döretmegiň başlangyçdan ahyrky ädime çenli ýoluny hödürleýäris. Siziň diňe bir Telegram hasabyňyz we AiHummer web dolandyryş interfeýsine giriş hukugyňyz gerek.

  1. BotFather bilen bot dörediň. Telegramda aç @BotFather, iberiň /newbot, we botuň adyny we ulanyjy ady. Göräniňiz: BotFather gaýtadan berýär token şeýle 123456789:AA… — muny botyň giriş açary, ony göçüriň.
  2. Telegram birleşdirijisini gurnan. Admin UI-de aç Pluginler/Bazar, Telegram birleşdirijisini tapyň katalogy we “Gurnamak” düwmesine basyň. Kartyň “onlaýn” bolmagyny syn ediň (gurnama gynşaklyk görkeziji görkezilýär).
  3. Tokeni goýuň. Kanallar ekranyna geçiň → Gurnalan kanallary sazlań bloklamak, Telegram kartasyny açmak we ýapıştırmak bot tokeni Baglaýjy görnüşinden meýdana. Ýatda sakla.
  4. Agent döretmek (eger henizem ýok bolsa) — gör Agentler: at we ulgam buýruky ýetýär.
  5. Agenti kanala bagla. Üstünde Kanallar ekran, içinde “Baglamalar” blok, saýla baş agent Telegram üçin — ýaňa öňdelik “täze Telegram gürrüňleri agent Y tarapyndan geçiriler”. Saýlaw derrew tygşytlanýar.
  6. Bota hat iberiň. Botuňyzy Telegramda açyň we oňa habar iberiň. Näme siz görersiňiz: agent çatda jogap berýär we gabat gelýän gürleşik peýda bolýar admin UI-de «Sessions» ekranında.

[!NOTE] Adaty ýagdaýda agent jogap berýär diňe belli ulanyjylar (hasaba alnan adamlar AiHummer). Eger bot siziň habaryňyza sessiz galýan bolsa — ýa özüňizi goşuň ýa-da mysal ulanyjy, ýa-da “Diňe belli ulanyjylara jogap ber” opsiýasyny öçüriň Kanallar ekran.

Näme üçin Telegram bilen başlamaly

Telegram islendik AiHummer kanalynyň iň az çydamlylygyna eýe: daşky geçiriji ýok, OAuth razyçylyk ekrany ýok, programma synagy ýok. Habarlaşmak we habarlary almak üçin bir bot tokeni ýeterlikdir, we şol birikdiriji içki işgärler gepleşiklerini hem-de müşderä gönükdirilen botlary hem öz içine alýar. Ol önümçilik derejesinde we doly işlenilenligi sebäpli, AiHummeri baha bereniňizde ilkinji bolup birleşdirmek üçin maslahat berýän kanalymyzdyr.

Sorag beriş ýa-da webhgook

Baýlanyşyk enjamy iki sany kabul ediş görnüşini hem goldaýar, şonuň üçin geçelgäňiz jemgyýetçilik internetinden elýeterli bolsada, bolmasa-da işleýär.

  • Uzyn sorag — birikdiriji Telegram-dan täzelikleri alýar. Içeri port ýok ýa-da TLS gerek bolup, bu ony ýerli ösüş we hususy üçin amatly edýär torlar.
  • Webhook — Telegram täzelenmeleri köpçülikleýin HTTPS URL-ine ýükleýär. Aşakdaky gijikme we TLS-i tamamlaýan ters proksiniň yzynda önümçilik üçin has amatly.

Birikdiriji diňleýär port 8800 adaty ýerleşdirişde ýa-da 8091 ýerli öňe sürüliş üçin. Her gelýän habar, konfigurirlenen geçelge URL salgysyna iberiler AIHUMMER_INBOUND_URL, paýlaşylan içeri girýän gizlin bilen tassyklanan.

Bäşinji habarlary, habar jogaplary we ses berişlikler

Ýönekeý tekstdän başga, Telegram kanaly ýerine ýetirýär Bäşirli Hatlar — agentiň strukturaly netijesini Telegramyň özboluşly habar aýratynlyklaryna meňzetýän formatlanşykly jogaplar. Şeýle hem goldaýar habarlara reaksiýalar we ses berişlikler, şonuň üçin agent ulanyjynyň habaryna jogap berip biler ýa-da bir aýly soragnamany söhbetiň bir bölegi hökmünde goýup biler.

[!TIP] Telegram AiHummer üçin kesgitlenen kanal telegram. Şol kanaly ulanyň agenti baglanyňyzda ýa-da söhbetdeşlikleri çeşmä görä süzüňizde id.

Bot-boten bilen gaýtalaýyş goraýjy

Agentler beýleki botlar bilen gürleşip bilýarlar. Muny howpsuz etmek üçin, birikdiriji iberýär loop goragçy: ol çäksiz ping-ponga öwrülmezden öň gaçýan bot-bot çalyşmalaryny duýýar we dargadýar. Bu, köne täsir-özüne gaýtadan işlemäniň baştutan bozulma çärelerinden tapawutlylykda, köp botdan ybarat iş akymyny düzmäge mümkinçilik berýär.

OIDC arkaly gizlin aracyllyk

Bot tokeni we beýleki birleşdiriji gizlin maglumatlar hyzmatyň içine hiç haçan gönüden-göni kodlanylmaýar. Munuň ýerine birleşdiriji olary iş wagtynda alýar OIDC boýunça Gizlinlik Gullugy — ol tassyklama geçirýär, soňra zerur bolan şahadatnamalary berýär. Syrlary şifrlenen howuzda saklanylýar we konfigurasiýa faýllaryndan we proses argumentlerinden daşarda bolýar.

[!NOTE] Gelýän hatlar aşakdaky ýere ýerleşdirilýär AIHUMMER_INBOUND_URL we üpjün edilen paýlaşylan HMAC gelýän gizlinlik (AIHUMMER_INBOUND_SECRET). Gapynyň eýýäm bolmalydygy Olary ibermek üçin standart iş meýdançasy öňünden sazlanyldy.

Eger işlemän bolsa

  • Telegram birikdirijisi “Kanallar” ekranynda ýok — ilki bilen ony gurnap şu Pluginler/Bazar ekran; gurnalançak çenli kanal görkezilmeýär. Diňe Telegram Community meýilnamasynda elýeterlidir; galanlary täzelemeli (HTTP 402).
  • Bot jogap bermänok — barlamak: (1) tokeniň dogry ýapyşdyrylandygyny we Telegram kartoçkasy “online” ýagdaýda; (2) kanal “Bäklimler” bölüminde agent bilen baglanyşyklydyr; (3) iberiji ulgama ýazylan (standart taýdan agent diňe jogap berýär belgili ulanyjylar).
  • Jogaplar şablona meňzeýär — ýagny iňlis modeli köplenç işjeň ýagdaýynda; birikdiriň berra beriji Modeller sahypa.
  • “Hubarsyz” / token ret edildi — token nädogry ýa-da yzyna çekilen; döretmek täze biri bilen @BotFather (/token) we täzeden goý.
  • Webhook gelmeýär — webhook režiminde geçelge öňünden elýeterli bolmaly umumy HTTPS URL; hususy torlarda içerki gelmegi talap etmän uzak sorag ulanyň port ýa-da TLS.

Indi nire?