AiHummer
Oʻzbekcha▾
KirishShaxsiy kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanallar/Telegram

Telegram

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

Telegram AiHummerning ishlab chiqarishga mo‘ljallangan, tavsiya etilgan birinchi kanali hisoblanadi. Haqiqiy odamlar oldida ishlaydigan agentni tezda olishning eng tezkor usuli: bilan bot yaratish @BotFather, ulashgichga tokenni bering va kirib kelayotgan xabarlar shlyuzga oqishni boshlaydi.

Telegram ulagichi mahsulot ichidan o‘rnatilgan Bozor va Admin UIda sozlangan. U host-native tarzida ishlaydi va inbound API orqali gateway bilan muloqot qiladi, shuning uchun u turn engine’dan mustaqil ravishda o’lchamini oshiradi va qayta ishga tushadi.

Telegramni 6 qadamda ulash

Mana Telegramda sizga javob beradigan bot yaratishga olib boruvchi boshlang‘ichdan oxirigacha bo‘lgan yo‘l. Sizga faqat Telegram akkaunti va AiHummer veb admin interfeysiga kirish kerak bo‘ladi.

  1. BotFather bilan bot yaratish. Telegramni oching @BotFather, yubor /newbot, va botning nomini o’rnating va foydalanuvchi nomi. Ko’rasiz: BotFather qaytaradi token yoqadi 123456789:AA… — bu botning kirish kaliti, uni nusxalash.
  2. Telegram ulashuvchini o’rnating. Admin interfeysida oching Plaginlar/Bozor, Telegram ulagichini toping katalogni oching va “O‘rnatish” tugmasini bosing. Karta “onlayn” holatga kelishini kuting (o‘rnatish taraqqiyot paneli ko‘rsatiladi).
  3. Tokenni joylashtiring. Ga boring Kanallar ekran → O‘rnatilgan kanallarni sozlash bloklash, Telegram kartasini oching va joylashtiring bot belgisi ulanish shaklidan maydonga. Saqlash.
  4. Agent yarating (agar sizda hali yo‘q bo‘lsa) — qarang Agentlar: ism va tizim ilovasi yetarli.
  5. Agentni kanalga bog’lang. Ustida Kanallar ekran, ichida Bog‘lamlar blok, tanla standart agent Telegram uchun — qoida “yangi Telegram suhbatlarini agent Y boshqaradi”. Tanlov darhol saqlanadi.
  6. Botga xabar yuboring. Telegramda botingizni oching va unga xabar yuboring. Nima siz ko’rasiz: agent chatda javob beradi va mos keladigan suhbat paydo bo’ladi admin UIdagi “Sessiyalar” ekranida.

[!NOTE] Standart bo’yicha agent javob beradi faqat ma’lum foydalanuvchilar (ro’yxatdan o’tgan odamlar AiHummer). Agar bot sizning xabaringizga jim bo‘lsa — o‘zingizni qo‘shing foydalanuvchi misoli, yoki “Faqat ma’lum foydalanuvchilarga javob berish” ni o’chiring Kanallar ekran.

Nima uchun Telegram bilan boshlash kerak

Telegram har qanday AiHummer kanaliga qaraganda eng kam to‘sqinlikka ega: provayder yo‘q, OAuth ruxsat ekrani yo‘q, ilova tekshiruvi yo‘q. Xabarlarni yuborish va qabul qilish uchun bot tokeni yetarli, va shu ulanish birikmasi ichki xodimlar suhbatlari va mijozlar bilan muloqot qiladigan botlarni qamrab oladi. U ishlab chiqarishga tayyor va to‘liq ishlatilgani sababli, AiHummerni baholashda birinchi bo‘lib ulanishingizni tavsiya qiladigan kanal aynan shu.

So’rov yoki webhook

Ulanma ikkala o’zlashtirish rejimini ham qo’llab-quvvatlaydi, shuning uchun gatewayingiz jamoat internetidan mavjud bo’lishidan qat’i nazar ishlaydi.

  • Uzoq so’rov — ulanish qurilmasi Telegramdan yangilanishlarni oladi. Kiruvchi port yo‘q yoki TLS talab qilinadi, bu uni mahalliy rivojlantirish va xususiy foydalanish uchun ideal qiladi tarmoqlar.
  • Vebxuk — Telegram yangilanishlarni ochiq HTTPS URL manziliga yuboradi. Kamroq kechikish va TLS ni tugatadigan teskari proksi ortida ishlab chiqarish uchun yaxshiroq mos keladi.

Ulagich tinglaydi port 8800 normal joylashtirishda, yoki 8091 mahalliy yugurish uchun. Har bir kiruvchi xabar belgilangan shlyuz URL manziliga joylashtiriladi AIHUMMER_INBOUND_URL, umumiy kiruvchi maxfiy kalit bilan tasdiqlangan.

Boy xabarlar, xabar reaksiyalari va so‘rovlar

Oddiy matndan tashqari, Telegram kanali namoyish qiladi Boy xabarlar — agentning strukturalangan chiqishini Telegramning mahalliy xabar xususiyatlariga moslashtiradigan formatlangan javoblar. Shuningdek, u qo‘llab-quvvatlaydi xabar reaksiyalari va so‘rovnomalar, shuning uchun agent foydalanuvchining xabariga javob berishi yoki navbatning bir qismi sifatida chatga tezkor so‘rov qo‘yishi mumkin.

[!TIP] Telegram AiHummer tomonidan aniqlangan kanal hisoblanadi telegram. Shu kanalni ishlating agentni bog‘lashingiz yoki suhbatlarni manba bo‘yicha filtrlashingizda identifikator.

Loop himoya bilan botdan-botga

Agentlar boshqa botlar bilan suhbatlashishi mumkin. Buni xavfsiz qilish uchun, ulanish moslamasi yetkazib beradi tsikl himoyasi: u cheksiz ping-pongga aylanishidan oldin qochib ketgan botdan-botga almashinuvlarni aniqlaydi va to’xtatadi. Bu sizga klassik feedback-loop xato rejimisiz ko’p-botli ish jarayonlarini yaratishga imkon beradi.

OIDC orqali sirli vositalash

Bot tokeni va boshqa ulanish sirlarini hech qachon xizmatga qattiq kod shaklida kiritilmaydi. Buning o‘rniga ulanish modul ularni ish vaqti davomida oladi OIDC ustidagi Maxfiylik Xizmati — u tasdiqlaydi, keyin kerakli kirish ma’lumotlarini oladi. Maxfiy ma’lumotlar shifrlangan trezor ichida qoladi va konfiguratsiya fayllari hamda jarayon argumentlaridan tashqarida bo‘ladi.

[!NOTE] Kirilayotgan xabarlar quyiga joylashtiriladi AIHUMMER_INBOUND_URL va tomonidan ta’minlangan ulashilgan HMAC kiruvchi sir (AIHUMMER_INBOUND_SECRET). Shlyuzda bo’lishi kerak ularga jo’natish uchun standart ish maydoni sozlangan.

Agar u ishlamasa

  • Telegram ulovchisi “Kanal” ekranida emas — avval uni o‘rnat bu Plaginlar/Bozor ekran; o‘rnatilgunga qadar kanal ko‘rsatilmayapti. Faqat Community rejasida Telegram mavjud; qolganlari yangilanishi kerak (HTTP 402).
  • Bot javob bermaydi — tekshirish: (1) token to‘g‘ri joylashtirilgan va Telegram kartasi “onlayn”; (2) kanal “Bog’lanishlar”da agentga bog’langan; (3) jo‘natuvchi tizimda ro‘yxatdan o‘tgan (standart bo‘yicha agent faqat javob beradi ma’lum foydalanuvchilar).
  • Javoblar shablon ko‘rinishida — soxta model ehtimol hali ham faol; ulang ta’minlovchi da Modellar sahifa.
  • “Ruxsatsiz” / token rad etildi — token noto‘g‘ri yoki bekor qilingan; yaratish yangi biri bilan @BotFather (/token) va uni yana joylashtiring.
  • Webhook kelmayapti — webhook rejimida gateway quyidagi manzilda mavjud bo‘lishi kerak ommaviy HTTPS URL; xususiy tarmoqda inbound talab qilmaydigan uzun so‘rovni ishlating port yoki TLS.

Keyingi qayerga