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 келісім экраны жоқ, қосымша тексеруі жоқ. Хабарламаларды жіберу және қабылдау үшін бот токені жеткілікті, әрі сол коннектордың өзі ішкі қызметкерлер чаттарын да, клиентке бағытталған боттарды да қамтиды. Ол өндірістік сапада болғандықтан және толықтай тексерілгендіктен, AiHummer-ді бағалаған кезде алдымен осы арнаны баптауды ұсынамыз.

Polling немесе webhook

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

  • Long polling — коннектор Telegram-нан жаңартуларды тартып алады. Кіріс порт немесе TLS талап етілмейді, бұл оны жергілікті әзірлеу мен жеке желілер үшін идеал етеді.
  • Webhook — Telegram жаңартуларды қоғамдық HTTPS URL-ге жібереді. Кідіріс төмен әрі TLS-ті тоқтататын кері проксидің артындағы өндіріске жақсырақ сай келеді.

Коннектор қалыпты орналастыруда 8800 портын, ал жергілікті іске қосуда 8091 портын тыңдайды. Әрбір кіріс хабарлама AIHUMMER_INBOUND_URL-де бапталған шлюз URL-іне жіберіледі, ортақ кіріс құпиясымен аутентификацияланады.

Бай хабарламалар, реакциялар және сауалнамалар

Қарапайым мәтіннен басқа, Telegram арнасы Бай хабарламаларды көрсетеді — агенттің құрылымды шығысын Telegram-ның нативті хабарлама мүмкіндіктеріне салыстыратын форматталған жауаптар. Ол сондай-ақ реакциялар мен сауалнамаларды қолдайды, сондықтан агент раундтың бөлігі ретінде пайдаланушының хабарламасына реакция бере алады немесе чатқа жылдам сауалнама қоя алады.

[!TIP] Telegram — AiHummer-ге telegram деп идентификацияланатын арна. Агентті байлаған кезде немесе сөйлесулерді дереккөз бойынша сүзген кезде осы арна идентификаторын қолданыңыз.

Цикл сақшысымен боттан-ботқа

Агенттер басқа боттармен сөйлесе алады. Мұны қауіпсіз ету үшін коннектор цикл сақшысын жеткізеді: ол боттан-ботқа бақылаусыз алмасуларды шексіз пинг-понгқа айналмай тұрып анықтап, үзіп тастайды. Бұл сізге классикалық кері байланыс циклінің бұзылу режимінсіз көп-бот жұмыс ағындарын құрастыруға мүмкіндік береді.

OIDC арқылы құпияларды брокерлеу

Бот токені мен басқа коннектор құпиялары ешқашан қызметке қатаң түрде енгізілмейді. Оның орнына коннектор оларды рантаймда OIDC арқылы Құпиялар қызметінен алады — ол аутентификацияланады, содан кейін өзіне қажетті тіркелгі деректерін шығарып алады. Құпиялар шифрланған қоймада қалады әрі конфигурация файлдары мен процесс аргументтерінен тыс болады.

[!NOTE] Кіріс хабарламалар AIHUMMER_INBOUND_URL-ге жіберіледі және ортақ HMAC кіріс құпиясымен (AIHUMMER_INBOUND_SECRET) қорғалады. Оларды диспетчерлеу үшін шлюзде әдепкі жұмыс кеңістігі бапталған болуы керек.

Әрі қарай қайда