AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
Kanallar/Web widget

Web widget

v1.0.x · täzelendi 2026-06-26

Web widget AiHummer agentini web sahypaňyza ýerleşdirilýän söhbet işe goýberiji hökmünde goýýar. Myhmanlar köpürjige basýar, ýazýar we her başga kanaly güýçlendirýän şol bir gezek hereketlendirijisinden jogaplary yzyna akdyrýarlar.

Widget gatewaýyň özi tarapyndan /widget/ ýolunda hyzmat edilýär, şonuň üçin işletmäge aýratyn hyzmat ýok.

Ýerleşdirme nähili işleýär

Widget üç gatlakda eltilýär, sahypaňyzyň öz stilinden we skriptlerinden üzňe galmak üçin döredilen:

  1. Sahypaňyza taşlaýan kiçi <script> ýükleýjisi.
  2. shadow-root işe goýberiji — söhbet köpürjigi we paneli Shadow DOM-yň içinde görkezilýär, şonuň üçin siziň CSS-iňiz we widgetiň CSS-i hiç haçan çaknyşmaýar.
  3. Hakyky söhbet ýüzüni göterýän şol bir gelip çykyşly iframe.

Ýerleşdirme bölegi

Ýükleýji skripti agentiň elýeterli bolmagyny isleýän islendik sahypaňyza goşuň, adatça ýapylýan </body> tegiden hut öň:

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

Ýükleýji agentleriňizi işledýän şol bir gatewaýdan hyzmat edilýär, şonuň üçin söhbet ýüzi widget aktiwleri bilen şol bir gelip çykyşlydyr.

Widgetiň aňyrsyndaky nokatlar

Widget iki gatewaý nokady bilen gepleşýär:

POST /v1/web/session
GET  /v1/web/stream
  • POST /v1/web/session web söhbet sessiýasyny açýar.
  • GET /v1/web/stream agentiň jogaby Server-Sent Events (SSE) üstünde yzyna akdyrýar, şonuň üçin jogaplar token-token peýda bolýar.

Konfiguratsiýa

Widgetiň dogry hyzmat etmegi we ýönkemegi üçin iki sazlama ýerinde bolmaly:

  • AIHUMMER_WIDGET_DIR — gatewaýyň /widget/-de hyzmat edýän widget aktiwleriniň katalogy.
  • AIHUMMER_DEFAULT_WORKSPACE_ID — gelýän web sessiýalarynyň ýönkelýän deslapky iş giňişligi.

[!NOTE] Widget gatewaý tarapyndan /widget/-de hyzmat edilýär; munuň üçin aýratyn proses ýerleşdirmeýärsiňiz. Gatewaýyň galan bölegi üçin edişiňiz ýaly TLS-i reverse proxy-ňyzda tamamlaň.

Indiki nirä