AiHummer
Кыргызча▾
КирүүЖеке кабинет
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Каналдар/Телеграм

Телеграм

v1.0.x · жаңыланды 2026-06-26

Telegram - бул AiHummerдин өндүрүшкө ылайыктуу, сунушталган биринчи каналы. Бул чыныгы адамдардын алдында иштей турган агентти алуу үчүн эң ылдам жол: менен бот түзүңүз @BotFather, туташтыргычка токенди берип, кирүүчү билдирүүлөр шлюзге агып баштайт.

Телеграмм коннектори продукт ичинде орнотулат Базар жана Админ интерфейсинде конфигурацияланган. Ал хосттун өзүндө иштейт жана шлюз менен кирүүчү API аркылуу байланышат, андыктан ал айлануу кыймылдаткычынан көз карандысыз масштабдашып, кайра башталат.

Телеграмга 6 кадамда туташтырыңыз

Бул нөлдөн баштап Telegramда сага жооп берген ботко чейинки толук жол. Сенге керектүү нерсе – Telegram аккаунту жана AiHummer веб-админ UIга кирүү мүмкүнчүлүгү.

  1. BotFather менен бот түзүңүз. Телеграмды ачыңыз @BotFather, жибер /newbot, жана боттун атын коюп пайдалануучы аты. Сиз көрө турган нерсе: BotFather кайтарат токен сүйүү 123456789:AA… — Бул боттун кирүү ачкычы, аны көчүрүңүз.
  2. Телеграмм туташтыргычын орнотуңуз. Админ UIде ачуу Плагиндер/Маркетплейс, Telegram туташтыргычыны тап каталогду басып, “Орнотуу” баскычын басыңыз. Карта “онлайн” болуп калышын күтүңүз (орнотуу прогресс тилкеси көрсөтүлгөн).
  3. Токенди чаптаңыз. Каналдар экранына өтүңүз → Орнотулган каналдарды настройкалоо тоскоол кылуу, Telegram картасын ачып, чапта бот токен тук менен жерге киргизиңиз. Сактаңыз.
  4. Агентти түзүү (эгер сизде анысы жок болсо) — караңыз Агенттер: ат жана система сурамчасы жетиштүү.
  5. Агентти каналга байлаңыз. Он Каналдар экранда, ичинде “Байланыштар” токтотуу, тандап алуу адаттагы агент Telegram үчүн — эреже “жаңы Telegram сүйлөшүүлөрүн агент Y жүргүзөт”. Тандоо дароо сакталат.
  6. Ботко билдирүү жибер. Ботыңызды Telegramде ачыңыз жана ага билдирүү жөнөтүңүз. Эмне сиз көрөсүз: агент чатта жооп берет, жана шайкеш сүйлөшүү пайда болот админ UIдагы «Сессиялар» экранда.

[!NOTE] Адатта агент жооп берет чынында белгилүү колдонуучулар (катталган адамдар AiHummer). Эгер бот сиздин билдирүүңүзгө үн чыкпаса — өзүңүздү кошуңуз мисал колдонуучу, же “Жөн гана белгилүү колдонуучуларга жооп бер” функциясын өчүрүңүз Каналдар экран.

Эмне үчүн Telegram менен баштоо керек

Telegram AiHummer каналынын эң аз тоскоолдугу бар: оператор жок, OAuth макулдук экраны жок, колдонмо текшерүүсү жок. Билдирүүлөрдү жөнөтүү жана кабыл алуу үчүн бот токени жетет, жана ошол эле коннектор ички кызматкерлер чаттарын жана кардарларга багытталган ботторду камтыйт. Ал өндүрүшкө ылайыктуу жана толук колдонулгандыктан, AiHummerди баалоо учурунда биринчи кезекте туташтырууну сунуштаган каналыбыз ошол.

Сауалнама же вебхук

Коннектор эки киргизүү режимин колдойт, ошондуктан ал сиздин шлюз коомдук интернеттен жеткиликтүү болосо да, болбосо да иштейт.

  • Узун сурап алуу — кошулма Telegramдан жаңыртууларды алып турат. Кирген порт жок же TLS талап кылынат, бул аны жергиликтүү өнүктүрүү жана жеке колдонуу үчүн идеалдуу кылат тармактар.
  • Вебчок — Telegram жаңыртууларды коомдук HTTPS URL дарегине жиберет. Төмөнкү кечигүү жана 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) токен туура тиркелген жана Телеграмма карточкасы “онлайн”; (2) канал “Байланыштар” бөлүмүндө агентке туташтырылган; (3) жөнөткөн адам системага катталган (демейки боюнча агент гана жооп берет) таанышты колдонуучулар).
  • Жооптор шаблондооч менен окшош көрүнөт — шылтоо модели, анын мүмкүнчүлүгү дагы деле активдүү; туташтыр берүүчү боюнча Моделдер барак.
  • “Ырасмий эмес” / токен четке кутулду — токен туура эмес же жарактан чыккан; түзүңүз жаңысы менен @BotFather (/token) жана андан кийин кайра чаптаңыз.
  • Вебхук келген жок — webhook режиминде шлюз жеткиликтүү болушу керек: жалпыга ачык HTTPS URL; жеке тармакта кирүүчү байланышты талап кылбаган узак сурам колдонулат порт же TLS.

Келерки кайда