AiHummer
Беларуская▾
УвайсціАсабісты кабінет
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Каналы/Тэлеграм

Тэлеграм

v1.0.x · абноўлена 2026-06-26

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

Падключальнік Telegram усталёўваецца праз прадукт Рынак і наладжваецца ў адміністрацыйным інтэрфейсе. Ён працуе на носьбіце хаста і злучаецца з шлюзам праз уваходны API, таму можа маштабавацца і перазапускацца незалежна ад рухавіка пераключэння.

Падключыце Telegram у 6 кроках

Вось поўны шлях ад нуля да бота, які адказвае вам у Telegram. Усё, што трэба, гэта ўліковы запіс Telegram і доступ да вэб-інтэрфейсу адміністратара AiHummer.

  1. Стварыце бота з BotFather. Адкрыйце ў Telegram @BotFather, адправіць /newbot, і ўсталявалі імя бота і імя карыстальніка. Што вы ўбачыце: BotFather вяртае токен як 123456789:AA… — гэта ключ доступу бота, скапіруйце яго.
  2. Усталюйце каннектор Telegram. Адкрыць у адміністрацыйным інтэрфейсе Плагіны/Маркетплэйсзнайдзіце злучальнік Telegram у каталог і націсніце «Усталяваць». Дачакайцеся, пакуль карта стане «ў сетцы» (ўстаноўка Паказваецца індыкатар прагрэсу.
  3. Устаўце токен. Ідзі да Каналы экран → гэты Настройка ўсталяваных каналаў блакіраваць, адкрыйце карту Telegram і ўстаўце токен бота у поле з формы злучальніка. Захаваць.
  4. Стварыць агента (калі ў вас яго яшчэ няма) — глядзіце АгентыІмя і сістэмны рэжым дастаткова.
  5. Прывяжыце агент да канала. На Каналы экран, у «Звязкі» блакаваць, выбраць па змаўчанні агент для Telegram — правіла «новыя размовы ў Telegram кіруюцца агентам Y». Выбар захоўваецца імгненна.
  6. Адпраўце паведамленне боту. Адкрыйце свайго бота ў Telegram і адпраўце яму паведамленне. Што вы ўбачыце: агент адказвае ў чаце, і з’яўляецца адпаведная размова на экране «Сесіі» ў адміністрацыйным інтэрфейсе.

[!NOTE] Па змоўчванні агент адказвае толькі вядомыя карыстальнікі (запісаныя людзі ў AiHummer). Калі бот не рэагуе на ваша паведамленне — дадайце сябе як прыклад карыстальніка, або адключыце «Адказваць толькі вядомым карыстальнікам» на Каналы экран

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

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

Апытанне або вэбхук

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

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

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

Багадыя паведамленні, рэакцыі на паведамленні і апытанні

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

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

Бот-да-бота з аховай цыкла

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

Сакрэтнае пасярэдніцтва з OIDC

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

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

Калі гэта не спрацавала

  • Падключэнне Telegram не з’яўляецца на экране «Каналы» — усталяваць гэта спачатку на гэты Плагіны/Маркетплэйс экран; пакуль не ўстаноўлены канал не паказваецца. У плане Community даступны толькі Telegram; астатнія патрабуюць абнаўлення (HTTP 402).
  • Робат не адказвае — праверце: (1) токен ўстаўлены правільна і Карта Telegram «онлайн»; (2) канал звязаны з агентам у «Прывязанасці». (3) адпраўнік зарэгістраваны ў сістэме (па змоўчанні агент адказвае толькі вядомыя карыстальнікі).
  • Адказы выглядаюць шаблоннымі — макетная мадэль, верагодна, яшчэ актыўная; падключыце правайдэр на Мадэлі старонка.
  • “Несанкцыянавана” / токен адхілены — токен няправільны або адкліканы; стварыце новы з @BotFather (/token) і ўставіць гэта зноў.
  • Webhoк не прыбывае — у рэжыме webhook шлюз павінен быць даступны па публічны URL HTTPS; у прыватнай сетцы выкарыстоўвайце доўгі апыт, які не патрабуе ўваходнага злучэння порт або TLS.

Куды далей