AiHummer
Монгол▾
НэвтрэхБүртгэл
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Суваг/Телеграм

Телеграм

v1.1.x · шинэчилсэн 2026-06-26

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

Телеграм залгуур бүтээгдэхүүн дотроос суулгагдана Зах зээл болон Админ UI-д тохируулагдсан. Энэ нь хост-д суурилуулагдаж ажилладаг бөгөөд чиглүүлэгчтэй inbound API-ээр холбогддог тул эргүүлгийн хөдөлгүүрээс хараат бусгаар өргөжиж, дахин эхлэх боломжтой.

Телеграмыг 6 алхамаар холбох

Энд Telegram-д танд хариу өгөх ботоор хүрэх тэгээс эхлэн бүх зам байна. Танд зөвхөн Telegram аккаунт болон AiHummer вэб удирдлагын хэрэглэгчийн интерфэйсэд нэвтрэх эрх хэрэгтэй.

  1. BotFather-оор бот үүсгээрэй. Телеграмд нээнэ үү @BotFather, илгээх /newbot, мөн ботыг нэрлэх ба хэрэглэгчийн нэр. Та юу харах вэ: BotFather нь буцааж өгнө токен дуртай 123456789:AA… — энэ нь боты нэвтрэх түлхүүр бөгөөд үүнийг хуулна уу.
  2. Telegram холбох төхөөрөмжийг суулгана уу. Админ интерфэйсийг нээнэ үү Нэмэлтүүд/Зах зээл, Telegram холбогчийг олоорой каталогийг нээгээд «Суулгах» дээр дарна уу. Карт «онлайнаар» шилжихийг хүлээнэ үү (суулгалт) дэвшлийн мөрийг харуулна).
  3. Токенийг наа. руу оч Суваг дэлгэц → энэ Суулгасан сувгуудыг тохируулах блоклох, Telegram карт нээж, наа бот токен Холбогчийн формоос талбар руу оруулах. Хадгалах.
  4. Эгент үүсгэх (хэрвээ танд одоогоор нэг байхгүй бол) — үзнэ үү Төлөөлөгчид: нэр ба системийн сануулга хангалттай.
  5. Агентийг сувгаар холбож өг. Дээр Суваг дэлгэц, дотор Бэхэлгээ блок, нэгийг нь сонгох анхдагч агент Telegram-д зориулсан — дүрэм “Шинэ Telegram яриаг агент Y удирдана”. Сонголт нь шууд хадгалагдана.
  6. Ботод мессеж илгээ. Телеграмд ботоо нээж, түүнд зурвас илгээгээрэй. Юу чи харна: төлөөлөгч чатанд хариу өгнө, тэгээд таарч буй яриа гарч ирнэ админ UI-д байгаа “Sessions” дэлгэцэн дээр.

[!NOTE] Өгөгдсөн байдлаар төлөөлөгч хариулна зөвхөн мэддэг хэрэглэгчид (бүртгүүлсэн хүмүүс AiHummer). Хэрэв бот таны мессеж дээр чимээгүй байгаа бол — өөрийгөө нэмээрэй жишээ хэрэглэгч, эсвэл “Зөвхөн мэддэг хэрэглэгчдэд хариулах” тохиргоог унтраа Суваг дэлгэц.

Яагаад Telegram-оор эхлэх ёстой вэ

Телеграм нь аливаа AiHummer сувгуудаас хамгийн бага саад тотгортой: ямар ч дамжуулагч хэрэггүй, ямар ч OAuth зөвшөөрлийн дэлгэцгүй, ямар ч аппын хяналт шаардлагагүй. Мессеж илгээх, хүлээн авахад ботын токен хангалттай бөгөөд ижил холбогч нь дотоод ажилтны чат болон хэрэглэгчдэд чиглэсэн ботуудыг хоёуланг нь хамардаг. Учир нь энэ нь үйлдвэрлэлийн түвшний, бүрэн туршигдсан тул AiHummer-ийг үнэлэх үед хамгийн түрүүнд холбохыг бид санал болгодог сувгаа юм.

Сорилт эсвэл вэбхүүк

Энэхүү холбогч нь хоёулангийн оролтод дэмжлэг үзүүлдэг тул таны гарц олон нийтийн интернетээс ханддаг эсэхээс үл хамааран ажиллана.

  • Урт удаан асуух — залгуур Telegram-аас шинэчлэлтийг татна. Орж ирэх порт байхгүй эсвэл TLS шаардагддаг ба энэ нь орон нутгийн хөгжүүлэлт болон хувийн хэрэглээнд тохиромжтой болгодог сүлжээүүд.
  • Вэбхук — Телеграм нийтлэг HTTPS URL руу шинэчлэлүүдийг илгээдэг. Илүү бага сааталтай бөгөөд TLS-ийг төгсгөдөг урвуу проксины ард үйлдвэрлэлд илүү зохимжтой.

Холбогч нь сонсож байна порт 8800 ердийн байрлуулалтад, эсвэл 8091 орчны ажилд. Бүх орж ирсэн мессежийг тохируулсан үүдний URL хаяг руу илгээдэг AIHUMMER_INBOUND_URL, хамтран ашиглах нийтлэг нууц үгээр баталгаажуулсан.

Баялаг мессежүүд, мессежийн хариу үйлдлүүд болон санал асуулгууд

Энгийн текстээс гадна, Telegram суваг нь үзүүлдэг Өргөн мэдээ — агентын бүтцийн гаралтыг Telegram-ийн төрөлхийн мессежийн функцуудтай холбодог форматлагдсан хариултууд. Мөн үүнийг дэмждэг мессежийн урвалууд болон санал асуулга, ингэснээр агент нь хэрэглэгчийн мессежид хариу үйлдэл үзүүлэх эсвэл ээлжинд хэсэгчилсэн хурдан санал асуулгыг чат руу оруулж чадна.

[!TIP] Телеграм нь AiHummer-тэй холбогдсон сувгийн нэр юм telegram. Тэр сувгийг ашигла Нэгж эсвэл эх сурвалжаар яриа шүүлтүүрлэх үед id.

Бот-боттой давталт хамгаалагчтай

Төлөөлөгчид бусад ботуудтай ярилцаж чадна. Үүнийг аюулгүй болгохын тулд холбогч нь хүргэж өгдөг цикл хамгаалагч: энэ нь хяналтгүй бот хоорондын солилцоог хязгаарлаж, үүрд үргэлжлэх пинг-понг болж хэвшмэгц тасалдуулдаг. Энэ нь танд олон ботын ажлын урсгалыг классик давтагдсан алдааны горимгүйгээр зохион байгуулах боломжийг олгодог.

OIDC дээр нууц зуучлал

Ботын токен болон бусад холбогч нууц үгсийг үйлчилгээ рүү хатуу кодлож огт оруулдаггүй. Үүний оронд холбогч нь тэдгээрийг ажиллах хугацаанд авчирдаг OIDC дээрх нууц үйлчилгээ — энэ нь баталгаажуулсны дараа шаардлагатай гэрчилгээг нь авчирдаг. Нууцлалуудад шифрлэгдсэн сейфэнд хадгалагдаж, тохиргооны файлууд болон процессийн аргументуудаас гардаггүй.

[!NOTE] Ирж буй мессежүүд нь дараах руу байрлуулна AIHUMMER_INBOUND_URL мөн хамгаалагдсан хуваалцсан HMAC орж ирж буй нууц (AIHUMMER_INBOUND_SECRET). Энэ хаалга нь заавал байх ёстой тэдгээрийг илгээхээр анхдагч ажлын орчин тохируулагдсан.

Хэрвээ энэ ажиллаж байсангүй бол

  • Телеграм холбогч нь “Суваг” дэлгэц дээр байхгүй байна — үүнийг эхлээд суулга тийм Нэмэлтүүд/Зах зээл дэлгэц; суурилуулагдсан хүртэл сувгийг харуулахгүй байна. Зөвхөн Community төлөвлөгөөнд Telegram л ашиглах боломжтой; бусад нь шинэчлэлт шаардлагатай (HTTP 402).
  • Бот хариу өгөхгүй байна — шалгах: (1) токен зөв наалдсан эсэх ба Telegram карт нь “онлайн” байдаг; (2) суваг нь “Bindings”-д агенттай холбогдсон байдаг; (3) илгээгч системд бүртгэлтэй байна (анхдагчаар агент зөвхөн хариу өгдөг) танил хэрэглэгчид).
  • Хариултууд загвартай мэт харагдаж байна — дуурайлган хийсэн загвар магадгүй одоо ч идэвхтэй байгаа; холбох нөхцөл дээр үйлчилгээ үзүүлэгч Загварууд хуудас.
  • “Зөвшөөрөлгүй” / токен татгалзав — токен буруу эсвэл цуцлагдсан; үүсгэ шинэ нэгтэй @BotFather (/token) дахин наа.
  • Вебхүүк ирэхгүй байна — вэбхүүк горимд гарц нь хүрч очих боломжтой байх ёстой нийтийн HTTPS URL; хувийн сүлжээнд урт polling ашиглана, үүнд дотоод хандалт хэрэггүй порт эсвэл TLS.

Дараа хаашаа явах вэ