AiHummer
Azərbaycanca▾
Daxil ol
v1.0.x▾
v1.0.xstable
{ }Swagger
Kanallar/Web widget

Web widget

v1.0.x · yeniləndi 2026-06-26

Web widget AiHummer agentini veb saytınıza yerləşdirilə bilən söhbət başladıcısı kimi qoyur. Ziyarətçilər qabarcığa klikləyir, yazır və hər digər kanalı işə salan eyni turn mühərrikindən cavabları axın edir.

Widget gateway-in özü tərəfindən /widget/ yolunda təqdim olunur, ona görə də işə salınacaq ayrıca xidmət yoxdur.

Yerləşdirmə necə işləyir

Widget səhifənizin öz stillərindən və skriptlərindən izolyasiya olmaq üçün nəzərdə tutulmuş üç qatda çatdırılır:

  1. Səhifənizə qoyduğunuz kiçik <script> yükləyicisi.
  2. shadow-root başladıcı — söhbət qabarcığı və paneli Shadow DOM içində render edilir, ona görə də CSS-iniz və widget-in CSS-i heç vaxt toqquşmur.
  3. Faktiki söhbət səthini host edən eyni-mənbəli iframe.

Yerləşdirmə fraqmenti

Agentin əlçatan olmasını istədiyiniz hər hansı səhifəyə, adətən bağlanan </body> teqindən bir az əvvəl yükləyici skriptini əlavə edin:

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

Yükləyici agentlərinizi işə salan eyni gateway-dən təqdim olunur, ona görə də söhbət səthi widget aktivləri ilə eyni-mənbəlidir.

Widget arxasındakı endpoint-lər

Widget iki gateway endpoint-i ilə danışır:

POST /v1/web/session
GET  /v1/web/stream
  • POST /v1/web/session veb söhbət sessiyası açır.
  • GET /v1/web/stream agentin cavabını Server-Sent Events (SSE) üzərindən axın edir, ona görə də cavablar token-token görünür.

Konfiqurasiya

Widget-in düzgün təqdim və dispetçer etməsi üçün iki parametr yerində olmalıdır:

  • AIHUMMER_WIDGET_DIR — gateway-in /widget/-də təqdim etdiyi widget aktivlərinin qovluğu.
  • AIHUMMER_DEFAULT_WORKSPACE_ID — daxil olan veb sessiyalarının dispetçer edildiyi default işçi sahə.

[!NOTE] Widget gateway tərəfindən /widget/-də təqdim olunur; onun üçün ayrıca proses yerləşdirmirsiniz. TLS-i gateway-in qalan hissəsi üçün etdiyiniz kimi reverse proxy-nizdə sonlandırın.

Növbəti addım