Telegram — AiHummer Дакументацыя

Telegram — гэта рэкамендаваны першы канал AiHummer прадакшэн-узроўню. Гэта самы хуткі спосаб паставіць працуючага агента перад рэальнымі людзьмі: стварыце бота праз @BotFather, дайце канектару токен, і ўваходныя паведамленні пачынаюць цячы ў шлюз.

Канектар Telegram усталёўваецца з убудаванага Маркетплейса і наладжваецца ў Admin UI. Ён працуе host-native і размаўляе са шлюзам праз inbound API, таму ён маштабуецца і перазапускаецца незалежна ад рухавіка ходаў.

Чаму пачынаць з Telegram

Telegram мае найменшае трэнне сярод усіх каналаў AiHummer: няма аператара, няма экрана OAuth-згоды, няма праверкі дадатка. Токена бота дастаткова, каб адпраўляць і прымаць паведамленні, і той самы канектар ахоплівае як унутраныя чаты супрацоўнікаў, так і ботаў, павернутых да кліентаў. Паколькі ён прадакшэн-узроўню і цалкам адпрацаваны, гэта канал, які мы рэкамендуем падключаць першым пры ацэнцы AiHummer.

Polling ці webhook

Канектар падтрымлівае абодва рэжымы прыёму, таму ён працуе незалежна ад таго, ці дасягальны ваш шлюз з публічнага інтэрнэту.

Long polling — канектар выцягвае абнаўленні з Telegram. Уваходны порт ці TLS не патрэбны, што робіць яго ідэальным для лакальнай распрацоўкі і прыватных сетак.
Webhook — Telegram пушыць абнаўленні на публічны HTTPS URL. Меншая затрымка і лепш падыходзіць для прадакшэну за рэверс-проксі, які тэрмінуе TLS.

Канектар праслухоўвае порт 8800 у звычайным разгортванні ці 8091 для лакальнага запуску. Кожнае ўваходнае паведамленне адпраўляецца на URL шлюза, наладжаны ў AIHUMMER_INBOUND_URL, аўтэнтыфікаванае агульным inbound-сакрэтам.

Насычаныя паведамленні, рэакцыі і апытанні

Акрамя простага тэксту, канал Telegram рэндэрыць Rich Messages — фарматаваныя адказы, якія адлюстроўваюць структураваны вывад агента на натыўныя магчымасці паведамленняў Telegram. Ён таксама падтрымлівае рэакцыі і апытанні, таму агент можа адрэагаваць на паведамленне карыстальніка ці паставіць хуткае апытанне ў чат як частку ходу.

[!TIP] Telegram — гэта канал, ідэнтыфікаваны для AiHummer як telegram. Выкарыстоўвайце гэты id канала, калі прывязваеце агента ці фільтруеце размовы па крыніцы.

Bot-to-bot з ахоўнікам ад цыклаў

Агенты могуць размаўляць з іншымі ботамі. Каб зрабіць гэта бяспечным, канектар пастаўляе ахоўнік ад цыклаў: ён выяўляе і разрывае некантралюемыя bot-to-bot абмены, перш чым яны ператворацца ў бясконцы пінг-понг. Гэта дазваляе вам кампанаваць шматботавыя працоўныя патокі без класічнага рэжыму збою са зваротнай сувяззю.

Брокерынг сакрэтаў праз OIDC

Токен бота і іншыя сакрэты канектара ніколі не зашываюцца ў сэрвіс. Замест гэтага канектар атрымлівае іх у рантайме з Secrets Service праз OIDC — ён аўтэнтыфікуецца, а потым атрымлівае патрэбныя ўліковыя даныя. Сакрэты застаюцца ў зашыфраваным сховішчы і па-за канфіг-файламі і аргументамі працэсу.

[!NOTE] Уваходныя паведамленні адпраўляюцца на AIHUMMER_INBOUND_URL і абароненыя агульным HMAC inbound-сакрэтам (AIHUMMER_INBOUND_SECRET). Шлюз павінен мець наладжаны працоўны прастор па змаўчанні, каб дыспетчарызаваць іх.

Куды далей

Параўнайце каналы ў дапаможніках MAX, Bitrix24 і SIP-тэлефанія.
Для нечатавых крыніц глядзіце Generic inbound.
Будуеце пад API? Глядзіце chat/completions.