AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
Kanallar/Telegram

Telegram

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

Telegram AiHummer-iň önümçilik derejeli, maslahat berilýän ilkinji kanalydyr. Ol işleýän agenti hakyky adamlaryň öňünde goýmagyň iň çalt usulydyr: @BotFather bilen bot dörediň, konnektora tokeni beriň, we gelýän habarlar gatewaýa akyp başlaýar.

Telegram konnektory önümiň içindäki Marketplace-den gurulýar we Admin UI-de sazlanýar. Ol host-native işleýär we gatewaý bilen gelýän API üstünde gepleşýär, şonuň üçin ol gezek hereketlendirijisinden garaşsyz masştablanýar we täzeden başlaýar.

Näme üçin Telegram bilen başlamaly

Telegramda islendik AiHummer kanalyndan iň az päsgelçilik bar: operator ýok, OAuth razylyk ekrany ýok, programma gözden geçirmesi ýok. Habarlary ibermek we kabul etmek üçin bot token ýeterlikdir, we şol bir konnektor hem içerki işgär söhbetlerini, hem müşderä gönükdirilen botlary öz içine alýar. Ol önümçilik derejeli we doly synagdan geçenligi sebäpli, AiHummer-i bahalandyranyňyzda ilki bilen birikdirmegiňizi maslahat berýän kanalymyzdyr.

Polling ýa-da webhook

Konnektor iki kabul ediş re­žimini hem goldaýar, şonuň üçin gatewaýyňyzyň jemgyýetçilik internetinden elýeterli bolşy ýa bolmajagyna garamazdan işleýär.

  • Long polling — konnektor täzelenmeleri Telegramdan çekýär. Gelýän port ýa-da TLS talap edilmeýär, bu ony ýerli ösüş we hususy ulgamlar üçin ideal edýär.
  • Webhook — Telegram täzelenmeleri jemgyýetçilik HTTPS URL-e itýär. Has pes gijä galma we TLS-i tamamlaýan reverse proxy aňyrsynda önümçilige has laýyk.

Konnektor adaty deploýmentde 8800 portunda, ýa-da ýerli işleýiş üçin 8091-de diňleýär. Her gelýän habar AIHUMMER_INBOUND_URL-de sazlanan gatewaý URL-e ýerleşdirilýär, paýlaşylan gelýän gizlini bilen autentifikasiýa edilýär.

Baý habarlar, reaksiýalar we soraglar

Ýönekeý tekstden başga, Telegram kanaly Baý Habarlary görkezýär — agentiň gurluşly çykyşyny Telegramyň native habar aýratynlyklaryna görkezýän formatlanan jogaplar. Ol şeýle hem reaksiýalary we soraglary goldaýar, şonuň üçin agent gezegiň bir bölegi hökmünde ulanyjynyň habaryna reaksiýa bildirip ýa-da söhbete çalt soragy goýup biler.

[!TIP] Telegram AiHummer-e telegram hökmünde tanadylan kanaldyr. Agenti baglanyňyzda ýa-da söhbetdeşlikleri çeşme boýunça süzgüçleýäniňizde şol kanal id-ini ulanyň.

Döwüm goragy bilen bot-to-bot

Agentler beýleki botlar bilen gepleşip bilýär. Muny howpsuz etmek üçin konnektor döwüm goragyny hödürleýär: ol gözden gaçan bot-to-bot çalşyklaryny olar tükeniksiz ping-pong-a öwrülmänkä ýüze çykarýar we döwýär. Bu size klassiki yza-gaýtarym döwümi şowsuzlyk re­žimi bolmazdan köp-bot iş akymlaryny düzmäge mümkinçilik berýär.

OIDC üstünde gizlinleri brokerlemek

Bot token we beýleki konnektor gizlinleri hiç haçan hyzmata berk kodlanmaýar. Onuň ýerine konnektor olary iş wagtynda OIDC üstünde Gizlinler Hyzmatyndan alýar — ol autentifikasiýa edýär, soňra zerur kepilnamalary çykarýar. Gizlinler şifrlenen seýfde we konfiguratsiýa faýllaryndan we proses argumentlerinden daşda galýar.

[!NOTE] Gelýän habarlar AIHUMMER_INBOUND_URL-e ýerleşdirilýär we paýlaşylan HMAC gelýän gizlini (AIHUMMER_INBOUND_SECRET) bilen goralýar. Olary ýönkemek üçin gatewaýda deslapky iş giňişligi sazlanan bolmaly.

Indiki nirä