AiHummer
Română▾
Autentificare
v1.0.x▾
v1.0.xstable
{ }Swagger
Canale/Web widget

Web widget

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

Web widget-ul pune un agent AiHummer pe site-ul dumneavoastră ca un lansator de chat încorporabil. Vizitatorii dau clic pe bulă, scriu și primesc răspunsuri în flux de la același motor de tururi care alimentează orice alt canal.

Widget-ul este deservit de gateway-ul însuși la calea /widget/, deci nu există un serviciu separat de rulat.

Cum funcționează încorporarea

Widget-ul este livrat în trei straturi, concepute pentru a rămâne izolate de stilurile și scripturile proprii ale paginii dumneavoastră:

  1. Un mic loader <script> pe care îl puneți în pagina dumneavoastră.
  2. Un lansator shadow-root — bula și panoul de chat sunt redate în interiorul unui Shadow DOM, astfel încât CSS-ul dumneavoastră și CSS-ul widget-ului nu se ciocnesc niciodată.
  3. Un iframe same-origin care găzduiește suprafața de chat propriu-zisă.

Fragmentul de încorporare

Adăugați scriptul loader în orice pagină în care doriți ca agentul să fie disponibil, de obicei chiar înainte de tag-ul de închidere </body>:

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

Loader-ul este deservit de același gateway care vă rulează agenții, astfel încât suprafața de chat este same-origin cu activele widget-ului.

Endpoint-urile din spatele widget-ului

Widget-ul comunică cu două endpoint-uri de gateway:

POST /v1/web/session
GET  /v1/web/stream
  • POST /v1/web/session deschide o sesiune de chat web.
  • GET /v1/web/stream transmite în flux răspunsul agentului prin Server-Sent Events (SSE), astfel încât răspunsurile apar token cu token.

Configurare

Două setări trebuie să fie în vigoare pentru ca widget-ul să deservească și să expedieze corect:

  • AIHUMMER_WIDGET_DIR — directorul de active ale widget-ului pe care gateway-ul le deservește la /widget/.
  • AIHUMMER_DEFAULT_WORKSPACE_ID — spațiul de lucru implicit în care sunt expediate sesiunile web primite.

[!NOTE] Widget-ul este deservit de gateway la /widget/; nu implementați un proces separat pentru el. Terminați TLS la reverse proxy-ul dumneavoastră așa cum ați face pentru restul gateway-ului.

Unde mergem mai departe