AiHummer
Қазақша▾
КіруЖеке кабинет
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Арналар/Телеграм

Телеграм

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

Telegram — AiHummer-дың өндірістік сападағы, бірінші кезекте ұсынылатын арнасы. Бұл нақты адамдардың алдында жұмыс істейтін агентті алудың ең жылдам жолы: бот құру @BotFather, коннектормен токенді беріңіз, және кіріс хабарламалар шлюзге ағыла бастайды.

Telegram қосқышы өнім ішінен орнатылады Нарық және Әкімші интерфейсінде бапталған. Ол хост-туған түрде жұмыс істейді және шлюзбен кіріс API арқылы сөйлеседі, сондықтан ол айналдыру қозғалтқышынан тәуелсіз түрде масштабталады және қайта іске қосылады.

Телеграмға 6 қадамда қосылыңыз

Міне, нөлден бастап Telegram-да сізге жауап беретін ботқа дейінгі толық жол. Сізге тек Telegram есептік жазбасы және AiHummer веб-әкімшілік интерфейсіне қолжетімділік қажет.

  1. BotFather арқылы бот жасаңыз. Телеграмда ашу @BotFather, жіберу /newbot, және боттың атын орнатыңыз және қолданушы аты. Сіз көретін нәрсе: BotFather қайтарады токен ұқсас 123456789:AA… — бұл боттың кіру кілті, көшіріп алыңыз.
  2. Telegram қосқышын орнатыңыз. Әкімші UI-де ашыңыз Плагиндер/Нарық, Telegram қосқышын табыңыз каталогты ашып, «Орнату» түймесін басыңыз. Картаның «онлайн» күйге оралуын күтіңіз (орнату) прогресс жолақ көрсетіледі).
  3. Токенді қойыңыз. Арналар экранына өтіңіз → Орнатылған арналарды баптау блоктау, Telegram картасын ашып, қойыңыз бот токені коннектор формасынан өріске. Сақтаңыз.
  4. Агент жасаңыз (әлі жоқ болса) — қараңыз Агенттер: аты мен жүйелік сұрау жеткілікті.
  5. Агентті арнаға байлаңыз. Үстінде Каналдар экранда, ішінде “Байланыстар” блок, таңда әдепкі агент Телеграм үшін — Ереже «Жаңа Telegram әңгімелері агент Y арқылы жүргізіледі». Таңдау дереу сақталады.
  6. Ботқа хабар жіберіңіз. Телеграмда ботыңызды ашып, оған хабарлама жіберіңіз. *Не Сіз көресіз: * агент чатта жауап береді, және сәйкес әңгіме пайда болады әкімші интерфейсіндегі «Сессиялар» экранында.

[!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. Сол арнаны пайдаланыңыз агентті байлаған кезде немесе әңгімелерді көз бойынша сүзгенде идентификатор.

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

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

OIDC арқылы құпия делдалдық

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

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

Егер бұл жұмыс істемесе

  • Telegram коннекторы «Арналар» экранында жоқ — алдымен оны орнатыңыз Плагиндер/Нарық экранында орнатыңыз; орнатылғанға дейін канал көрсетілмейді. Тек Community жоспарына арналған Telegram қолжетімді; қалғандары жаңартуды қажет етеді (HTTP 402).
  • Бот жауап бермейді — тексеру: (1) токен дұрыс қойылған ба және Телеграм картасы «онлайн»; (2) арна «Байланыстарда» агентке байланған; (3) жіберуші жүйеге тіркелген (әдепкі бойынша агент тек жауап береді танымал пайдаланушылар).
  • Жауаптар дайын үлгіде сияқты көрінеді — еліктіргіш модель әлі де белсенді болуы мүмкін; қосыңыз жеткізуші туралы Модельдер бет.
  • «Рұқсат етілмеген» / токен қабылданбады — белгі дұрыс емес немесе тоқтатылған; жасаңыз жаңа біреуімен @BotFather (/token) және оны қайта қою.
  • Вебхук жетпейді — вебхук режимінде шлюзге қол жеткізу мүмкін болуы керек қоғамдық HTTPS URL; жеке желіде кіріс сұрау қажет емес ұзақ сұрауды қолданыңыз порт немесе TLS.

Келесі қайда