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. Нақты чат бетін орналастыратын бір-текті iframe.

Кірістіру сниппеті

Агент қолжетімді болуын қалайтын кез келген бетке жүктеуші скриптін қосыңыз, әдетте жабылатын </body> тегінің алдында:

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

Жүктеуші агенттеріңізді іске қосатын дәл сол шлюзден ұсынылады, сондықтан чат беті виджет активтерімен бір-текті болады.

Виджет артындағы эндпойнттар

Виджет екі шлюз эндпойнтымен сөйлеседі:

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-ті шлюздің қалған бөлігіне жасайтындай кері проксиде тоқтатыңыз.

Әрі қарай қайда