Web widget

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

POST /v1/web/session
GET  /v1/web/stream

**Web widget агенти AiHummer-ро дар вебсайти шумо** ҳамчун лончери чати ҷойгиршаванда мегузорад. Меҳмонон ба ҳубобак клик мекунанд, чоп мекунанд ва ҷавобҳоро аз ҳамон муҳаррики гардиш, ки ҳар канали дигарро қувват медиҳад, стрим мекунанд. Widget аз ҷониби худи gateway дар масири `/widget/` хидмат карда мешавад, бинобар ин ягон хидмати алоҳида барои иҷро лозим нест. ## Чӣ тавр ҷойгиркунӣ кор мекунад Widget дар се қабат расонида мешавад, ки барои ҷудо мондан аз сабкҳо ва скриптҳои худи саҳифаи шумо тарроҳӣ шудаанд: 1. Як **лончери `<script>`-и хурд**, ки шумо ба саҳифаи худ мегузоред. 2. Як **лончери shadow-root** — ҳубобак ва панели чат дар дохили Shadow DOM рендер мешаванд, бинобар ин CSS-и шумо ва CSS-и widget ҳеҷ гоҳ бархӯрд намекунанд. 3. Як **iframe-и same-origin**, ки сатҳи воқеии чатро мизбонӣ мекунад. ## Қисмати ҷойгиркунӣ Скрипти лончерро ба ҳар саҳифае, ки мехоҳед агент дар он дастрас бошад, одатан дақиқан пеш аз теги пӯшандаи `</body>`, илова кунед: ```html <script src="https://your-aihummer-host/widget/loader.js" async> </script> ``` Лончер аз ҳамон gateway, ки агентҳои шуморо иҷро мекунад, хидмат карда мешавад, бинобар ин сатҳи чат бо дороиҳои widget same-origin аст. ## Нуқтаҳои интиҳоии паси widget Widget бо ду нуқтаи интиҳоии gateway сӯҳбат мекунад: ```http POST /v1/web/session GET /v1/web/stream ``` - **`POST /v1/web/session`** як сессияи чати вебро мекушояд. - **`GET /v1/web/stream`** ҷавоби агентро тавассути **Server-Sent Events (SSE)** стрим мекунад, бинобар ин ҷавобҳо токен ба токен пайдо мешаванд. ## Конфигуратсия Барои он ки widget дуруст хидмат ва равон кунад, ду танзим бояд ҷой дошта бошанд: - **`AIHUMMER_WIDGET_DIR`** — феҳристи дороиҳои widget, ки gateway дар `/widget/` хидмат мекунад. - **`AIHUMMER_DEFAULT_WORKSPACE_ID`** — корфазои пешфарзе, ки сессияҳои веби воридшаванда ба он равон карда мешаванд. > [!NOTE] > Widget аз ҷониби gateway дар `/widget/` хидмат карда мешавад; шумо барои он > раванди алоҳида деплой намекунед. TLS-ро дар reverse proxy-и худ, мисли он ки > барои боқимондаи gateway мекунед, қатъ кунед. ## Қадами навбатӣ ба куҷо - Барои барномаҳои чат, [Telegram](/tg/v1.0/channels/telegram) ва [MAX](/tg/v1.0/channels/max)-ро бубинед. - Барои барномаи ватанӣ, [Mobile client](/tg/v1.0/channels/mobile-client)-ро бубинед. - Барои интегратсияҳои фармоишӣ, [Generic inbound](/tg/v1.0/channels/generic-inbound)-ро бубинед.