AiHummer
Кыргызча▾
Кирүү
v1.0.x▾
v1.0.xstable
{ }Swagger
Каналдар/Telegram

Telegram

v1.0.x · жаңыланды 2026-06-26

Telegram — бул AiHummer’дин өндүрүш деңгээлиндеги, сунушталган биринчи каналы. Бул иштеген агентти чыныгы адамдардын алдына коюунун эң тез жолу: @BotFather менен бот түзүңүз, коннекторго токенди бериңиз, жана кирүүчү билдирүүлөр шлюзга агып баштайт.

Telegram коннектору продукттун ичиндеги Marketplace булагынан орнотулат жана Admin UI’де конфигурацияланат. Ал хост-нативдик иштейт жана шлюз менен кирүүчү API аркылуу сүйлөшөт, ошондуктан ал кезек кыймылдаткычынан көз карандысыз масштабдалат жана кайра жүктөлөт.

Эмне үчүн Telegram’дан баштоо керек

Telegram’дын AiHummer каналдарынын ичинде эң аз тоскоолдугу бар: байланыш оператору жок, OAuth макулдук экраны жок, колдонмо текшерүүсү жок. Билдирүүлөрдү жөнөтүү жана алуу үчүн бот токени жетиштүү, жана ошол эле коннектор ички кызматкерлердин маектерин да, кардарларга багытталган botторду да камтыйт. Ал өндүрүш деңгээлинде жана толугу менен сыналган болгондуктан, AiHummer’ди баалоодо аны биринчи болуп туташтырууну сунуштайбыз.

Поллинг же вебхук

Коннектор эки кабыл алуу режимин тең колдойт, ошондуктан ал сиздин шлюзуңуз коомдук интернеттен жеткиликтүү болсо да, болбосо да иштейт.

  • Long polling — коннектор Telegram’дан жаңыртууларды тартып алат. Кирүүчү порт же TLS талап кылынбайт, бул аны жергиликтүү иштеп чыгуу жана жеке тармактар үчүн идеалдуу кылат.
  • Webhook — Telegram жаңыртууларды коомдук HTTPS URL’ине түртөт. Төмөн кечигүү жана TLS’ти аяктаган реверс-проксинин артындагы өндүрүшкө ылайыктуу.

Коннектор кадимки жайылтууда 8800 портунда, же жергиликтүү иштетүү үчүн 8091 портунда угат. Ар бир кирүүчү билдирүү AIHUMMER_INBOUND_URL ичинде конфигурацияланган шлюз URL’ине жайгаштырылат, бөлүшүлгөн кирүүчү сыр менен аутентификацияланат.

Бай билдирүүлөр, реакциялар жана сурамжылоолор

Жөнөкөй тексттен тышкары, Telegram каналы Бай Билдирүүлөрдү (Rich Messages) рендерлейт — агенттин структуралык чыгуусун Telegram’дын нативдик билдирүү функцияларына дал келтирген форматталган жооптор. Ал ошондой эле реакцияларды жана сурамжылоолорду колдойт, ошондуктан агент колдонуучунун билдирүүсүнө реакция кыла алат же кезектин бир бөлүгү катары маекке тез сурамжылоо коё алат.

[!TIP] Telegram AiHummer’ге telegram катары идентификацияланган канал. Агентти байлаганда же сүйлөшүүлөрдү булагы боюнча чыпкалаганда ошол канал id’син колдонуңуз.

Цикл-сактагычы менен бот-боткко

Агенттер башка botтор менен сүйлөшө алышат. Аны коопсуз кылуу үчүн коннектор цикл-сактагычын жеткирет: ал качып бараткан бот-боткко алмашууларды чексиз пинг-понгго айланганга чейин аныктайт жана үзөт. Бул сизге классикалык кайтарым байланыш-циклинин ката режимисиз көп-боттук жумушчу агымдарын курууга мүмкүндүк берет.

OIDC аркылуу сыр делдалдоо

Бот токени жана башка коннектор сырлары эч качан кызматка катуу-коддолбойт. Анын ордуна коннектор аларды иштөө учурунда OIDC аркылуу Сырлар Кызматынан алат — ал аутентификацияланат, андан кийин керектүү эсептик дайындарды алат. Сырлар шифрленген казынада калат жана конфигурация файлдарынан жана процесс аргументтеринен сырткары болот.

[!NOTE] Кирүүчү билдирүүлөр AIHUMMER_INBOUND_URL дарегине жайгаштырылат жана бөлүшүлгөн HMAC кирүүчү сыры (AIHUMMER_INBOUND_SECRET) менен корголгон. Аларды жөнөтүү үчүн шлюзда демейки жумушчу мейкиндик конфигурацияланган болушу керек.

Андан ары кайда