AiHummer
Аԥсшәа▾
Аиалаҵара
v1.0.x▾
v1.0.xstable
{ }Swagger
Аканалқәа/Telegram

Telegram

v1.0.x · ирҿыцуп 2026-06-26

Telegram — ари AiHummer апродукциатә, иеицаԥхьоу аиҳабырагьежьтәи аканал ауп. Уи аус зуо аагент иҵабыргу ауаа рахьтә аазырԥшуа имариоу амҩа ауп: бот аԥҵа @BotFather ала, аконнектор атокен ат, насгьы аиҵаху амассежқәа агейтуэй ахь ишьҭаларц иалагоит.

Telegram-аконнектор апродукт аҩныҵҟа иҟоу Маркетплейс аҟынтә ишьҭаргылоуп, насгьы Admin UI аҟны иарка. Уи host-native ала аус ауеит, насгьы агейтуэй иадацәажәоит аиҵаху API ала, убри аҟнытә уи атурн-енджин акәымкәа ихатәла иҵеиҷахоит-иҿыцхоит.

Telegram аҟынтә иалагара зыхҟьо

Telegram AiHummer аканалқәа-зегь раасҭа имариоу амҩа амоуп: аоператор иҭахым, OAuth-аиҳәара-аэкран ыҟам, аԥшәыма аревиу аҭахым. Абот-атокен иазкуп амассежқәа реишьҭреи-роуреи, насгьы убри иеиԥшу аконнектор аҩныҵҟатәи аусуҩцәа рчатеи аклиентцәа рымоу аботцәеи дырҭарцоит. Уи апродукциатә, насгьы иҵаҟа иҟазҵахьоу ауп, убри аҟнытә ари аканал ауп ҳара иҳаицаԥхьоу AiHummer аназԥшаауа раԥхьаӡа иадушәҳәалар.

Polling ма webhook

Аконнектор аиҵаху амодқәа ҩба иадгылоит, убри аҟнытә уи аус ауеит шәгейтуэй жәлартә интернет аҟынтә иеиԥшӡам зыҟазаалакгьы.

  • Long polling — аконнектор Telegram аҟынтә агхақәа иааишьҭуеит. Аиҵаху-порт ма TLS аҭахым, убри аҟнытә уи иеиӷьуп алокалтә рҿиареи иарша аnetwork-қәеи рзы.
  • Webhook — Telegram агхақәа жәлартә HTTPS URL ахь ишьҭуеит. Илатентность-маҷ насгьы апродукциазы иеиӷьуп TLS аҟәырҭуа реверс-прокси ашьҭахь.

Аконнектор порт 8800 аҟны даԥхьоит инормалу адеплоймент аҟны, ма 8091 алокалтә ау請ра аҟны. Аиҵаху мессеж-зегь агейтуэй URL ахь ишьҭуеит, иани AIHUMMER_INBOUND_URL аҟны иconfiguraны, иеицырзеиԥшу аиҵаху-секрет ала иаутентифицаны.

Ибеиоу амассежқәа, ареакциақәеи аполлқәеи

Иҟамлоу атекст аасҭа, Telegram-аканал Ибеиоу амассежқәа иаԥшаауеит — иформатхоу аҭакқәа, аагент иструктурахоу аҭыжьра Telegram аиадатә мессеж-лшарақәа рахь изеиԥшу. Уи убри аан ареакциақәеи аполлқәеи иадгылоит, убри аҟнытә аагент ахархәаҩ имессеж дареагирра ма ачат аҟны алас полл алагалара илшоит атурн ачасть аҳасабла.

[!TIP] Telegram — AiHummer азы telegram ҳасабла иадырбоу аканал ауп. Уи аканалтә id хархәа аагент анбыҵашәҵо ма аиҿцәажәарақәа хыҵхырҭала аналыхшәуа.

Бот-бот иадҳәаланы алуп-гард ала

Аагентцәа егьырҭ аботцәа дырцәажәар рылшоит. Уи шәарҭарада иаҟаҵаразы, аконнектор алуп-гард инаит: уи иаԥшаауеит насгьы иаԥиҵәоит ианардыруа бот-бот аиҭныԥсахрақәа ианеиԥымҟьо пинг-понг иҟамларц аԥхьа. Ари мульти-бот аусфлоуқәа раԥҵара иашәамҩаԥгоит классикатә аиҭынтә-луп аиԥара амод ада.

OIDC ала асекретқәа реилазаара

Абот-атокени егьырҭ аконнектор асекретқәеи маҵзура аҩныҵҟа итеихкоданы инаргам. Иара уи аконнектор урҭ аус-руратә аамҭазы иаагоит Secrets Service over OIDC аҟынтә — уи иаутентифицоит, насгьы изеиҭаху акредентиалқәа иаагоит. Асекретқәа ишифрахоу авалт аҟны иаанхоит, насгьы аконфиг-файлқәеи апроцесс-аргументқәеи рахьтә ҩада.

[!NOTE] Аиҵаху амассежқәа AIHUMMER_INBOUND_URL ахь ишьҭуеит насгьы иеицырзеиԥшу HMAC аиҵаху-секрет (AIHUMMER_INBOUND_SECRET) ала ихьчоуп. Агейтуэй default-аусуратә ҭыԥ (workspace) иconfiguraны иамазароуп урҭ рышьҭразы.

Аҩаџьара аҟынӡа