Telegram
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
telegramdeb 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
- MAX, Bitrix24 va SIP telefoniya qoʻllanmalarida kanallarni solishtiring.
- Chat boʻlmagan manbalar uchun Generic inboundni koʻring.
- API’ga qarshi quryapsizmi? chat/completionsni koʻring.