AiHummer
Беларуская▾
Увайсці
v1.0.x▾
v1.0.xstable
{ }Swagger
Каналы/Вэб-віджэт

Вэб-віджэт

v1.0.x · абноўлена 2026-06-26

Вэб-віджэт ставіць агента AiHummer на ваш сайт як убудоўваны чат-лаўнчар. Наведвальнікі націскаюць на бурбалку, набіраюць тэкст і стрымяць адказы назад з таго самага рухавіка ходаў, які забяспечвае кожны іншы канал.

Віджэт абслугоўваецца самім шлюзам па шляху /widget/, таму няма асобнага сэрвісу, які трэба запускаць.

Як працуе ўбудаванне

Віджэт дастаўляецца ў тры слаі, спраектаваных так, каб заставацца ізаляванымі ад уласных стыляў і скрыптаў вашай старонкі:

  1. Невялікі загрузчык <script>, які вы ўстаўляеце ў сваю старонку.
  2. Лаўнчар на shadow-root — чат-бурбалка і панэль рэндэрацца ўнутры Shadow DOM, таму ваш CSS і CSS віджэта ніколі не сутыкаюцца.
  3. Same-origin iframe, які хостыць саму чат-паверхню.

Сніпет убудавання

Дадайце скрыпт-загрузчык на любую старонку, дзе вы хочаце мець агента даступным, звычайна непасрэдна перад тэгам закрыцця </body>:

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

Загрузчык абслугоўваецца з таго самага шлюза, які запускае вашых агентаў, таму чат-паверхня з’яўляецца same-origin з ассетамі віджэта.

Эндпойнты за віджэтам

Віджэт размаўляе з двума эндпойнтамі шлюза:

POST /v1/web/session
GET  /v1/web/stream
  • POST /v1/web/session адкрывае вэб чат-сесію.
  • GET /v1/web/stream стрымяць адказ агента назад праз Server-Sent Events (SSE), таму адказы з’яўляюцца токен за токенам.

Канфігурацыя

Дзве налады павінны быць на месцы, каб віджэт абслугоўваў і дыспетчарызаваў правільна:

  • AIHUMMER_WIDGET_DIR — дырэкторыя ассетаў віджэта, якую шлюз абслугоўвае па /widget/.
  • AIHUMMER_DEFAULT_WORKSPACE_ID — працоўны прастор па змаўчанні, у які дыспетчарызуюцца ўваходныя вэб-сесіі.

[!NOTE] Віджэт абслугоўваецца шлюзам па /widget/; вы не разгортваеце для яго асобны працэс. Тэрмінуйце TLS на вашым рэверс-проксі, як і для астатняй часткі шлюза.

Куды далей