AiHummer
Тоҷикӣ▾
ВоридшавӣКабинети шахсӣ
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Каналҳо/Телеграм

Телеграм

v1.0.x · навсозӣ шуд 2026-06-26

Телеграм канали аввалини пешниҳодшуда ва сатҳи истеҳсолии AiHummer мебошад. Ин роҳи зудтарини расонидани агенте мебошад, ки дар назди одамони воқеӣ кор кунад: бот эҷод кунед бо @BotFatherҶавҳари пайвасткунакро диҳед, ва паёмҳои воридотӣ ба дарвозавӣ оғоз мекунанд ба ҷараён афтанд.

Пайвасткунаки Telegram аз дохили маҳсулот насб карда шудааст Бозор ва дар Интерфейси Идоракунӣ танзим карда шудааст. Он ҳамчун хонаи мизбон кор мекунад ва бо қувваи воридшаванда тавассути API сӯҳбат мекунад, бинобар ин мустақилона паҳн мешавад ва барқарор мегардад, берун аз муҳаррики гардиш.

Пайваст кардани Telegram дар 6 қадам

Ин роҳномаи пурра аз сифр то ботест, ки ба шумо дар Телеграм ҷавоб медиҳад. Шумо танҳо ба ҳисоботи Телеграм ва дастрасӣ ба интерфейси идоракунии веби AiHummer ниёз доред.

  1. Бо BotFather як бот созед. Дар Telegram кушоед @BotFather, фиристед /newbot, ва номи ботро муайян кунед ва username. Он чизеро ки шумо мебинед: BotFather як ҷавоб медиҳад нишона монанд 123456789:AA… — Ин калиди дастрасии бот аст, онро нусха кунед.
  2. Пайвасткунаки Telegram-ро насб кунед. Дар UI маъмурият кушода Плагинҳо/Бозор, пайвасткунаки Telegram-ро дар каталог ёбед ва «Насб кардан»-ро пахш кунед. То «онлайн» шудани корт интизор шавед (ҳангоми насб сатри пешрафт нишон дода мешавад).
  3. Рамзро часпонед. Рав ба Каналҳо пардохт → он Танзим кардани каналҳои насбшуда қатъ кунед, корти Telegram-ро кушоед ва чоп кунед токени бот ба майдон аз шакли пайвасткунанда дохил шавед. Захира кунед.
  4. Як агент эҷод кунед (агар шумо ҳанӯз надошта бошед) — бинед Агентҳо: як ном ва як фармони системавӣ кифоя аст.
  5. Агентро ба канал пайванд кунед. Дар Каналҳо экран, дар Чаҳорчӯбаҳо монеъ кардан, интихоб кардан агенти пешфарз барои Телеграм — Қоида “сӯҳбатҳои нави Telegram аз ҷониби агент Y идора мешаванд” аст. Ин интихоби фавран захира мешавад.
  6. Ба бот паём фиристед. Ботатонро дар Телеграм боз кунед ва ба он паём фиристед. Чӣ шумо мебинед: агент дар чат ҷавоб медиҳад ва гуфтугӯи мувофиқ пайдо мешавад дар экрани “Ҷаласаҳо” дар интерфейси маъмури.

[!NOTE] Агент ба таври пешфарз посух медиҳад танҳо корбарони маълум (шахсоне, ки сабти ном шудаанд AiHummer). Агар бот ба паёми шумо посух надод — худатонро ҳамчун як илова кунед истифодабарандаи намуна, ё хомӯш кардани ‘Фақат ба истифодабарандагони маълум ҷавоб диҳед’ дар Каналҳо намоянда

Чаро бо Телеграм оғоз кунем

Телеграм камтарини масрафро дар муқоиса бо ҳар канал AiHummer дорад: ягон оператор нест, ягон экрани розигии OAuth нест, ягон баррасии барнома нест. Токени бот барои фиристодан ва гирифтани паёмҳо кофист, ва ҳамон коннектор ҳам ба чатҳои дохилии кормандон ва ҳам ба ботҳои рӯ ба муштариён хизмат мерасонад. Зеро он сатҳи истеҳсолотӣ дорад ва комилан санҷида шудааст, ин каналест, ки мо тавсия медиҳем аввалин истифода баред ҳангоми арзёбии AiHummer.

Рӯйпурсӣ ё вебхуки

Пайвасткунанда ҳар ду усули воридкуниро дастгирӣ мекунад, бинобар ин он кор мекунад, новобаста аз он ки дарвозаи шумо аз интернети оммавӣ дастрас аст ё не.

  • Пурсишҳои дарозмуддат — пайвасткунанда навсозиҳоро аз Телеграм мегирад. Порти воридотӣ нест ё TLS талаб карда мешавад, ки онро барои таҳияи маҳаллӣ ва хусусӣ комил мекунад шабакаҳо
  • Вебҳук — Telegram навсозиро ба URL-и умумии HTTPS фиристода, таъхири камтарро таъмин мекунад ва бехтар мувофиқи истеҳсолот паси проксии баръакс, ки TLS-ро анҷом медиҳад.

Пайвасткунӣ гӯш мекунад порти 8800 дар як ҷойгиркунии муқаррарӣ, ё 8091 барои давидан маҳаллӣ. Ҳар паёми воридшаванда ба URL-и дар дарвозаи муқарраршуда сабт мешавад AIHUMMER_INBOUND_URL, бо сирри умумии воридшаванда тасдиқ шудааст.

Паёмҳои бой, вокунишҳо ба паём ва назарсанҷӣ

Аз матни оддӣ гузашта, канали Телеграм пешниҳод мекунад Паёмҳои бой — ҷавобҳои форматшуда, ки натиҷаи сохташудаи агентро ба хусусиятҳои паёмҳои табиии Telegram пайваст мекунанд. Он инчунин дастгирӣ мекунад реаксияҳои паём ва назари омм, то агент метавонад ба паёми корбар ҷавоб диҳад ё як назарсанҷи зудро ҳамчун қисми гардиш ба сӯҳбат гузорад.

[!TIP] Telegram ин канале мебошад, ки барои AiHummer муайян шудааст telegramАз он канал истифода баред ид вақте ки шумо агентиеро маҳдуд мекунед ё суҳбатҳоро аз рӯи манбаъ филтр мекунед.

Бот бо бот бо муҳофизи давра

Агентҳо метавонанд бо дигар ботҳо сӯҳбат кунанд. Барои бехатар кардани он, пайвасткунанда интиқол медиҳад нигори ҳалқаон табодули номуътадили бот-ба-ботро ошкор ва бозмедорад пеш аз он ки онҳо ба пинг-понги беохир табдил шаванд. Ин ба шумо имкон медиҳад, ки равандҳои бисёрботиро бидуни ҳолати нокомии классикии кольбэки фикрӣ тартиб диҳед.

Миёнаравии махфӣ дар бораи OIDC

Токени бот ва дигар сиррҳои пайвасткунак ҳеҷгоҳ ба таври сахт дар хидмат коднашуданд. Ба ҷои ин пайвасткунак онҳоро ҳангоми иҷро гирифтан мекунад Хизматрасонии сирри дар бораи OIDC — он тасдиқ мекунад ва сипас маълумоти лозимашонро бармегардонад. Сиррҳо дар хонаи рамзгузошташуда мемонанд ва аз файлҳои конфигуратсия ва аргументҳои раванд берун.

[!NOTE] Паёмҳои воридшаванда ба AIHUMMER_INBOUND_URL ва бо таъмини сифри пинҳонии HMAC дохилшудаAIHUMMER_INBOUND_SECRET). Дарвозаро бояд дошта бошад Фазои кори пешфарз барои фиристодани онҳо танзим шудааст.

Агар кор намекард

  • Пайвасткунаки Telegram дар экрани “Каналҳо” вуҷуд надорад — аввал онро насб кунед он Плагинҳо/Бозор экрани; то насб шудан канал намоиш дода намешавад. Дар нақшаи Ҷамъиятӣ танҳо Telegram дастрас аст; бояд боқӣ такмил дода шаванд (HTTP 402).
  • Бот ҷавоб намедиҳад — тафтиш кунед: (1) токен дуруст часпида ва Корти Телеграм «онлайн» аст; (2) канал бо агент дар «Бастабандӣ» маҳдуд шудааст. (3) фиристанда дар система сабт шудааст (бо тавре ки пешфарз аст, агент танҳо ҷавоб медиҳад истифодабарандагони машҳур)
  • Посухҳо шаблонӣ менамояд — эҳтимолан модели сохташуда ҳанӯз фаъол аст; пайваст кунед провайдер дар Моделҳо саҳифа.
  • “Бе иҷозат” / нишонаро рад карданд — токен нодуруст аст ё бозхонд шуда; эҷод кардани нав бо @BotFather (/token) ва дубора часпонед.
  • Вебҳук наменӯзад — дар ҳолати вебхуки дарвозаро бояд дастрас бошад ба URL-и умумии HTTPS; дар шабакаи хусусӣ аз polling-и дароз истифода бурдан лозим аст, ки ҷараёни дохилиро талаб намекунад порти ё TLS.

Баъд ба куҷо