AiHummer
Oʻzbekcha▾
Kirish
v1.0.x▾
v1.0.xstable
{ }Swagger
Kanallar/Web widget

Web widget

v1.0.x · yangilandi 2026-06-26

Web widget AiHummer agentini sizning vebsaytingizga joylashtiriladigan chat ishga tushiruvchi sifatida qoʻyadi. Mehmonlar pufakchani bosadilar, yozadilar va boshqa har qanday kanalni quvvatlaydigan aynan oʻsha turn dvigatelidan javoblarni strim qilib oladilar.

Widget gateway’ning oʻzi tomonidan /widget/ yoʻlida xizmat qilinadi, shuning uchun ishlatish uchun alohida xizmat yoʻq.

Joylashtirish qanday ishlaydi

Widget uch qatlamda yetkaziladi, ular sahifangizning oʻz uslublari va skriptlaridan ajralgan holda qolish uchun moʻljallangan:

  1. Sahifangizga tashlaydigan kichik <script> yuklovchi.
  2. Shadow-root ishga tushiruvchi — chat pufakchasi va paneli Shadow DOM ichida render qilinadi, shuning uchun sizning CSS’ingiz va widgetning CSS’i hech qachon toʻqnashmaydi.
  3. Haqiqiy chat yuzasini joylaydigan same-origin iframe.

Joylashtirish snippeti

Agent mavjud boʻlishini istagan istalgan sahifaga yuklovchi skriptni qoʻshing, odatda yopiluvchi </body> tegidan bevosita oldin:

<script
  src="https://your-aihummer-host/widget/loader.js"
  async>
</script>

Yuklovchi agentlaringizni ishlatadigan aynan oʻsha gateway’dan xizmat qilinadi, shuning uchun chat yuzasi widget aktivlari bilan same-origin boʻladi.

Widget ortidagi endpointlar

Widget ikkita gateway endpointi bilan gaplashadi:

POST /v1/web/session
GET  /v1/web/stream
  • POST /v1/web/session web chat sessiyasini ochadi.
  • GET /v1/web/stream agentning javobini Server-Sent Events (SSE) orqali strim qiladi, shuning uchun javoblar token-ba-token paydo boʻladi.

Konfiguratsiya

Widget toʻgʻri xizmat qilishi va dispetcherlashi uchun ikkita sozlama joyida boʻlishi kerak:

  • AIHUMMER_WIDGET_DIR — gateway /widget/da xizmat qiladigan widget aktivlari katalogi.
  • AIHUMMER_DEFAULT_WORKSPACE_ID — kiruvchi web sessiyalar dispetcherlanadigan standart ish maydoni.

[!NOTE] Widget gateway tomonidan /widget/da xizmat qilinadi; uning uchun alohida jarayon joylashtirmaysiz. TLS’ni gateway’ning qolgan qismi uchun qilganingiz kabi teskari proksingizda tugating.

Keyingi qadam