AiHummer
Тоҷикӣ▾
Даромадан
v1.0.x▾
v1.0.xstable
{ }Swagger
Каналҳо/Telegram

Telegram

v1.0.x · навсозӣ шуд 2026-06-26

Telegram канали аввалини тавсияшаванда ва дараҷаи истеҳсолотии AiHummer аст. Он зудтарин роҳ барои гузоштани агенти кории шумо дар назди одамони воқеӣ аст: бо @BotFather як бот эҷод кунед, токенро ба коннектор диҳед ва паёмҳои воридшаванда ба gateway ҷараён гирифтан мегиранд.

Коннектори Telegram аз Marketplace-и дохили маҳсулот насб карда мешавад ва дар Admin UI танзим мегардад. Он ба таври host-native кор мекунад ва бо gateway тавассути API-и воридшаванда сӯҳбат мекунад, бинобар ин мустақилона аз муҳаррики гардиш миқёс мегирад ва аз нав оғоз мешавад.

Чаро аз Telegram оғоз кунем

Telegram нисбат ба ҳар канали дигари AiHummer камтарин монеа дорад: на оператор, на экрани розигии OAuth, на баррасии барнома. Токени бот барои фиристодан ва қабули паёмҳо кофӣ аст ва ҳамон коннектор ҳам чатҳои дохилии кормандон ва ҳам ботҳои ба муштарӣ нигаронидашударо фаро мегирад. Азбаски он дараҷаи истеҳсолотӣ ва комилан санҷидашуда аст, ин канале аст, ки мо тавсия медиҳем ҳангоми арзёбии AiHummer аввал онро пайваст кунед.

Polling ё webhook

Коннектор ҳарду режими воридкуниро дастгирӣ мекунад, бинобар ин он новобаста аз он ки gateway-и шумо аз интернети ҷамъиятӣ дастрас аст ё не, кор мекунад.

  • Long polling — коннектор навсозиҳоро аз Telegram pull мекунад. Ягон порти воридшаванда ё TLS лозим нест, ки инро барои таҳияи маҳаллӣ ва шабакаҳои хусусӣ идеалӣ мегардонад.
  • Webhook — Telegram навсозиҳоро ба URL-и ҷамъиятии HTTPS push мекунад. Таъхири камтар ва барои истеҳсолот дар паси reverse proxy, ки TLS-ро қатъ мекунад, беҳтар мувофиқ аст.

Коннектор дар порти 8800 дар деплои муқаррарӣ ё 8091 барои иҷрои маҳаллӣ гӯш медиҳад. Ҳар паёми воридшаванда ба URL-и gateway, ки дар AIHUMMER_INBOUND_URL танзим шудааст, фиристода мешавад ва бо рози воридшавандаи муштарак аутентификатсия мегардад.

Паёмҳои бой, реаксияҳо ва пурсишҳо

Илова бар матни оддӣ, канали Telegram Паёмҳои бой (Rich Messages)-ро рендер мекунад — ҷавобҳои форматшуда, ки барориши сохторёфтаи агентро ба хусусиятҳои ватании паёми Telegram мепайвандад. Он инчунин реаксияҳо ва пурсишҳо-ро дастгирӣ мекунад, бинобар ин агент метавонад ба паёми корбар реаксия нишон диҳад ё ҳамчун қисми гардиш пурсиши зудро ба чат гузорад.

[!TIP] Telegram канале аст, ки ба AiHummer ҳамчун telegram муаррифӣ мешавад. Он id-и каналро ҳангоми бастани агент ё филтр кардани сӯҳбатҳо аз рӯи манбаъ истифода баред.

Bot-to-bot бо муҳофизи ҳалқа

Агентҳо метавонанд бо ботҳои дигар сӯҳбат кунанд. Барои бехатар сохтани он, коннектор муҳофизи ҳалқа (loop guard) интиқол медиҳад: он мубодилаҳои аз назоратхориҷшудаи bot-to-bot-ро пеш аз он ки ба ping-pong-и беохир табдил ёбанд, ошкор ва қатъ мекунад. Ин ба шумо имкон медиҳад, ки ҷараёнҳои кории бисёрботиро бе ҳолати классикии нокомии ҳалқаи бозхӯрд тартиб диҳед.

Миёнаравии розҳо тавассути OIDC

Токени бот ва дигар розҳои коннектор ҳеҷ гоҳ ба хидмат hard-code карда намешаванд. Ба ҷои ин коннектор онҳоро дар вақти иҷро аз Secrets Service тавассути OIDC ба даст меоварад — он аутентификатсия мекунад, сипас эътимодномаҳои лозимиро мегирад. Розҳо дар анбори рамзгузоришуда боқӣ мемонанд ва аз файлҳои конфигуратсия ва аргументҳои раванд берунанд.

[!NOTE] Паёмҳои воридшаванда ба AIHUMMER_INBOUND_URL фиристода мешаванд ва бо рози воридшавандаи муштараки HMAC (AIHUMMER_INBOUND_SECRET) ҳифз карда мешаванд. gateway бояд як корфазои пешфарз танзимшуда дошта бошад, то онҳоро равон кунад.

Қадами навбатӣ ба куҷо