Web ვიჯეტი ათავსებს AiHummer-ის აგენტს თქვენს ვებსაიტზე როგორც ჩასასმელ ჩატის
გამშვებს. სტუმრები აჭერენ ბუშტს, კრეფენ და უკან ისტრიმავენ პასუხებს იმავე
turn engine-დან, რომელიც ამოძრავებს ყველა სხვა არხს.
ვიჯეტი მოწოდებულია თავად gateway-ის მიერ /widget/ გზაზე, ასე რომ არ არის
გასაშვები ცალკე სერვისი.
როგორ მუშაობს ჩასმა
ვიჯეტი მიეწოდება სამ ფენად, რომლებიც შექმნილია იმისთვის, რომ იზოლირებული დარჩეს თქვენი
გვერდის საკუთარი სტილებისა და სკრიპტებისგან:
პატარა <script> ჩამტვირთველი, რომელსაც თქვენს გვერდზე ჩასვამთ.
shadow-root გამშვები — ჩატის ბუშტი და პანელი ირენდერება Shadow
DOM-ის შიგნით, ასე რომ თქვენი CSS და ვიჯეტის CSS არასოდეს ეჯახება.
same-origin iframe, რომელიც მასპინძლობს ჩატის რეალურ ზედაპირს.
ჩასმის snippet
დაამატეთ ჩამტვირთველის სკრიპტი ნებისმიერ გვერდზე, სადაც გსურთ აგენტი ხელმისაწვდომი იყოს, ჩვეულებრივ
დამხურავი </body> ტეგის უშუალოდ წინ:
ჩამტვირთველი მოწოდებულია იმავე gateway-დან, რომელიც უშვებს თქვენს აგენტებს, ასე რომ ჩატის
ზედაპირი same-origin-ია ვიჯეტის აქტივებთან.
ვიჯეტის უკან მდებარე endpoint-ები
ვიჯეტი ესაუბრება ორ gateway endpoint-ს:
POST /v1/web/sessionGET /v1/web/stream
POST /v1/web/session ხსნის web ჩატის სესიას.
GET /v1/web/stream ისტრიმავს აგენტის პასუხს უკან Server-Sent
Events (SSE)-ით, ასე რომ პასუხები ჩნდება ტოკენ-ტოკენ.
კონფიგურაცია
ორი პარამეტრი უნდა იყოს ადგილზე, რომ ვიჯეტმა სწორად მოგვცეს და გაგზავნოს:
AIHUMMER_WIDGET_DIR — ვიჯეტის აქტივების დირექტორია, რომელსაც gateway აწვდის
/widget/-ზე.
AIHUMMER_DEFAULT_WORKSPACE_ID — ნაგულისხმევი workspace, რომელშიც შემომავალი web
სესიები იგზავნება.
[!NOTE]
ვიჯეტი მოწოდებულია gateway-ის მიერ /widget/-ზე; თქვენ მისთვის ცალკე
პროცესს არ ანერგავთ. შეწყვიტეთ TLS თქვენს reverse proxy-ზე, ისევე როგორც gateway-ის
დანარჩენი ნაწილისთვის.
**Web ვიჯეტი ათავსებს AiHummer-ის აგენტს თქვენს ვებსაიტზე** როგორც ჩასასმელ ჩატის
გამშვებს. სტუმრები აჭერენ ბუშტს, კრეფენ და უკან ისტრიმავენ პასუხებს იმავე
turn engine-დან, რომელიც ამოძრავებს ყველა სხვა არხს.
ვიჯეტი მოწოდებულია თავად gateway-ის მიერ `/widget/` გზაზე, ასე რომ არ არის
გასაშვები ცალკე სერვისი.
## როგორ მუშაობს ჩასმა
ვიჯეტი მიეწოდება სამ ფენად, რომლებიც შექმნილია იმისთვის, რომ იზოლირებული დარჩეს თქვენი
გვერდის საკუთარი სტილებისა და სკრიპტებისგან:
1. პატარა **`<script>` ჩამტვირთველი**, რომელსაც თქვენს გვერდზე ჩასვამთ.
2. **shadow-root გამშვები** — ჩატის ბუშტი და პანელი ირენდერება Shadow
DOM-ის შიგნით, ასე რომ თქვენი CSS და ვიჯეტის CSS არასოდეს ეჯახება.
3. **same-origin iframe**, რომელიც მასპინძლობს ჩატის რეალურ ზედაპირს.
## ჩასმის snippet
დაამატეთ ჩამტვირთველის სკრიპტი ნებისმიერ გვერდზე, სადაც გსურთ აგენტი ხელმისაწვდომი იყოს, ჩვეულებრივ
დამხურავი `</body>` ტეგის უშუალოდ წინ:
```html
<script
src="https://your-aihummer-host/widget/loader.js"
async>
</script>
```
ჩამტვირთველი მოწოდებულია იმავე gateway-დან, რომელიც უშვებს თქვენს აგენტებს, ასე რომ ჩატის
ზედაპირი same-origin-ია ვიჯეტის აქტივებთან.
## ვიჯეტის უკან მდებარე endpoint-ები
ვიჯეტი ესაუბრება ორ gateway endpoint-ს:
```http
POST /v1/web/session
GET /v1/web/stream
```
- **`POST /v1/web/session`** ხსნის web ჩატის სესიას.
- **`GET /v1/web/stream`** ისტრიმავს აგენტის პასუხს უკან **Server-Sent
Events (SSE)**-ით, ასე რომ პასუხები ჩნდება ტოკენ-ტოკენ.
## კონფიგურაცია
ორი პარამეტრი უნდა იყოს ადგილზე, რომ ვიჯეტმა სწორად მოგვცეს და გაგზავნოს:
- **`AIHUMMER_WIDGET_DIR`** — ვიჯეტის აქტივების დირექტორია, რომელსაც gateway აწვდის
`/widget/`-ზე.
- **`AIHUMMER_DEFAULT_WORKSPACE_ID`** — ნაგულისხმევი workspace, რომელშიც შემომავალი web
სესიები იგზავნება.
> [!NOTE]
> ვიჯეტი მოწოდებულია gateway-ის მიერ `/widget/`-ზე; თქვენ მისთვის ცალკე
> პროცესს არ ანერგავთ. შეწყვიტეთ TLS თქვენს reverse proxy-ზე, ისევე როგორც gateway-ის
> დანარჩენი ნაწილისთვის.
## შემდეგ სად
- ჩატის აპლიკაციებისთვის იხილეთ [Telegram](/ka/v1.0/channels/telegram) და
[MAX](/ka/v1.0/channels/max).
- ნატიური აპლიკაციისთვის იხილეთ [Mobile client](/ka/v1.0/channels/mobile-client).
- კასტომ ინტეგრაციებისთვის იხილეთ [Generic inbound](/ka/v1.0/channels/generic-inbound).
