AiHummer
Oʻzbekcha
Kirish
v1.0.x
{ }Swagger

Telegram

v1.0.x · yangilandi 2026-06-26

Telegram — AiHummer’ning ishlab chiqarish darajasidagi, tavsiya etilgan birinchi kanali. Bu ishlaydigan agentni real odamlar oldiga olib chiqishning eng tez yoʻli: @BotFather bilan bot yarating, konnektorga tokenni bering va kiruvchi xabarlar gateway’ga oqib kela boshlaydi.

Telegram konnektori ichki mahsulot Marketplacedan oʻrnatiladi va Admin UI’da sozlanadi. U host-native ishlaydi va gateway bilan inbound API orqali gaplashadi, shuning uchun turn dvigatelidan mustaqil ravishda masshtablanadi va qayta ishga tushadi.

Nega Telegramdan boshlash kerak

Telegram har qanday AiHummer kanali ichida eng kam ishqalanishga ega: operator yoʻq, OAuth rozilik ekrani yoʻq, ilova koʻrigi yoʻq. Bot tokeni xabarlarni yuborish va qabul qilish uchun yetarli, va aynan shu konnektor ham ichki xodimlar chatlarini, ham mijozlarga yoʻnaltirilgan botlarni qamrab oladi. U ishlab chiqarish darajasida va toʻliq sinovdan oʻtgani uchun, AiHummer’ni baholaganingizda biz birinchi navbatda ulashni tavsiya qiladigan kanal aynan shu.

Polling yoki webhook

Konnektor ikkala qabul qilish rejimini ham qoʻllab-quvvatlaydi, shuning uchun gateway’ingiz umumiy internetdan erishish mumkin boʻladimi yoki yoʻqmi — ishlaydi.

  • Long polling — konnektor yangilanishlarni Telegramdan tortib oladi. Kiruvchi port yoki TLS talab qilinmaydi, bu uni lokal ishlab chiqish va xususiy tarmoqlar uchun ideal qiladi.
  • Webhook — Telegram yangilanishlarni umumiy HTTPS URL’ga yuboradi. Kechikish kamroq va TLS’ni tugatadigan teskari proksi ortidagi ishlab chiqarish uchun yaxshiroq mos keladi.

Konnektor oddiy joylashtirishda 8800-portda, lokal ishlashda esa 8091’da tinglaydi. Har bir kiruvchi xabar AIHUMMER_INBOUND_URLda sozlangan gateway URL’iga joylanadi va umumiy inbound siri bilan autentifikatsiya qilinadi.

Boy xabarlar, reaksiyalar va soʻrovnomalar

Oddiy matndan tashqari Telegram kanali Rich Messagesni render qiladi — agentning tuzilgan natijasini Telegramning native xabar imkoniyatlariga moslashtiradigan formatlangan javoblar. U shuningdek reaksiyalar va soʻrovnomalarni qoʻllab-quvvatlaydi, shuning uchun agent foydalanuvchi xabariga reaksiya bildirishi yoki turn’ning bir qismi sifatida chatga tezkor soʻrovnoma qoʻyishi mumkin.

[!TIP] Telegram — AiHummerga telegram deb tanilgan kanal. Agentni bogʻlaganingizda yoki suhbatlarni manba boʻyicha filtrlaganingizda aynan shu kanal id’sidan foydalaning.

Loop guard bilan bot-to-bot

Agentlar boshqa botlar bilan gaplasha oladi. Buni xavfsiz qilish uchun konnektor loop guard bilan yetkaziladi: u nazoratdan chiqib ketgan bot-to-bot almashinuvlarni cheksiz ping-pongga aylanishidan oldin aniqlaydi va uzadi. Bu sizga klassik teskari aloqa siklidagi nosozlik rejimisiz koʻp botli ish oqimlarini tuzish imkonini beradi.

OIDC orqali sir brokerlash

Bot tokeni va boshqa konnektor sirlari hech qachon xizmatga qatʼiy yozib qoʻyilmaydi. Buning oʻrniga konnektor ularni ish vaqtida OIDC orqali Secrets Servicedan oladi — u autentifikatsiya qiladi, soʻngra kerakli hisob maʼlumotlarini oladi. Sirlar shifrlangan ombor ichida qoladi va konfiguratsiya fayllaridan hamda jarayon argumentlaridan tashqarida boʻladi.

[!NOTE] Kiruvchi xabarlar AIHUMMER_INBOUND_URLga joylanadi va umumiy HMAC inbound siri (AIHUMMER_INBOUND_SECRET) bilan himoyalanadi. Ularni dispetcherlash uchun gateway’da standart ish maydoni sozlangan boʻlishi kerak.

Keyingi qadam