MAX არის რუსული მესენჯერი და AiHummer უკავშირდება მას როგორც არხს.
აგენტი ჩნდება MAX-ში როგორც ბოტი: ის იღებს შემომავალ შეტყობინებებს, უშვებს ჩვეულებრივ turn-ს
და აგზავნის პასუხს — ისევე როგორც Telegram და სხვა არხები.
MAX მოწოდებულია როგორც Marketplace არხის კონექტორი და აგებულია MAX Bot
API-ზე. ეს არ არის სერვისი, რომელსაც თქვენ თავად აშენებთ: თქვენ აყენებთ კონექტორს
პროდუქტში ჩაშენებული Marketplace-დან და კონფიგურირებთ მას Admin UI-დან, ისევე როგორც ნებისმიერ სხვა
არხს.
დააყენეთ Marketplace-დან
გახსენით პროდუქტში ჩაშენებული Marketplace და დააყენეთ
MAX მოდული. დაყენების შემდეგ არხი ჩნდება Admin UI-ის არხების სექციაში
არხის id-ით max — გამოიყენეთ ეს id, როდესაც აგენტს აკავშირებთ ან
საუბრებს ფილტრავთ წყაროს მიხედვით.
სურვილისამებრ დააყენეთ MAX Bot API ბაზური URL MAX_API_BASE-ში. ის ნაგულისხმევად არის
https://platform-api2.max.ru, ასე რომ ჩვეულებრივ შეგიძლიათ ეს ცარიელი დატოვოთ.
შეინახეთ — კონექტორი იწყებს შეტყობინებების მიღებას და გაგზავნას.
[!TIP]
MAX არის არხი, რომელიც AiHummer-ისთვის იდენტიფიცირებულია როგორც max. გამოიყენეთ ეს არხის id, როდესაც
აგენტს აკავშირებთ ან საუბრებს ფილტრავთ წყაროს მიხედვით.
რა არის მხარდაჭერილი
MAX კონექტორი მოიცავს ძირითად საუბრის ნაკადებს:
შეტყობინებების გაგზავნა და მიღება აგენტსა და MAX მომხმარებლებს შორის.
Long-poll შემომავალი — კონექტორი იწევს შემომავალ განახლებებს (მოხსენიებები,
პასუხები, მედია, ინტერაქტიული მოვლენები), ასე რომ შემომავალი საჯარო პორტი არ არის საჭირო.
ნატიური პასუხები კონკრეტულ შეტყობინებაზე.
ძირითადი inline კლავიატურები სწრაფი ინტერაქტიული ღილაკებისთვის.
Media-by-URL გამავალ შეტყობინებებში.
დედუპლიკაცია გასაღების მიხედვით, ასე რომ ხელახალი მიწოდება არასოდეს ქმნის დუბლირებას.
როგორ მოძრაობს შეტყობინებები
თითოეული შემომავალი MAX შეტყობინება აღწევს gateway-ს იმავე შემომავალი გზით, როგორც ყველა
სხვა არხი, დაცული გაზიარებული inbound-HMAC საიდუმლოთი. იქიდან turn
engine ამუშავებს მას როგორც ნებისმიერი სხვა არხის შეტყობინებას.
[!NOTE]
gateway-ს უნდა ჰქონდეს კონფიგურირებული ნაგულისხმევი workspace შემომავალი
შეტყობინებების გასაგზავნად.
**MAX არის რუსული მესენჯერი და AiHummer უკავშირდება მას როგორც არხს.**
აგენტი ჩნდება MAX-ში როგორც ბოტი: ის იღებს შემომავალ შეტყობინებებს, უშვებს ჩვეულებრივ turn-ს
და აგზავნის პასუხს — ისევე როგორც Telegram და სხვა არხები.
MAX მოწოდებულია როგორც **Marketplace არხის კონექტორი** და აგებულია **MAX Bot
API**-ზე. ეს არ არის სერვისი, რომელსაც თქვენ თავად აშენებთ: თქვენ აყენებთ კონექტორს
პროდუქტში ჩაშენებული Marketplace-დან და კონფიგურირებთ მას Admin UI-დან, ისევე როგორც ნებისმიერ სხვა
არხს.
## დააყენეთ Marketplace-დან
გახსენით პროდუქტში ჩაშენებული [Marketplace](/ka/v1.0/marketplace/overview-tiers) და დააყენეთ
**MAX** მოდული. დაყენების შემდეგ არხი ჩნდება Admin UI-ის არხების სექციაში
არხის id-ით `max` — გამოიყენეთ ეს id, როდესაც აგენტს აკავშირებთ ან
საუბრებს ფილტრავთ წყაროს მიხედვით.
## გამართეთ Admin UI-დან
1. შექმენით MAX ბოტი და მიიღეთ მისი token.
2. Admin UI-ში გახსენით **MAX** არხის პარამეტრები.
3. ჩასვით ბოტის token **`MAX_BOT_TOKEN`**-ში (საიდუმლო, აუცილებელი).
4. სურვილისამებრ დააყენეთ MAX Bot API ბაზური URL **`MAX_API_BASE`**-ში. ის ნაგულისხმევად არის
`https://platform-api2.max.ru`, ასე რომ ჩვეულებრივ შეგიძლიათ ეს ცარიელი დატოვოთ.
5. შეინახეთ — კონექტორი იწყებს შეტყობინებების მიღებას და გაგზავნას.
> [!TIP]
> MAX არის არხი, რომელიც AiHummer-ისთვის იდენტიფიცირებულია როგორც `max`. გამოიყენეთ ეს არხის id, როდესაც
> აგენტს აკავშირებთ ან საუბრებს ფილტრავთ წყაროს მიხედვით.
## რა არის მხარდაჭერილი
MAX კონექტორი მოიცავს ძირითად საუბრის ნაკადებს:
- **შეტყობინებების გაგზავნა და მიღება** აგენტსა და MAX მომხმარებლებს შორის.
- **Long-poll შემომავალი** — კონექტორი იწევს შემომავალ განახლებებს (მოხსენიებები,
პასუხები, მედია, ინტერაქტიული მოვლენები), ასე რომ შემომავალი საჯარო პორტი არ არის საჭირო.
- **ნატიური პასუხები** კონკრეტულ შეტყობინებაზე.
- **ძირითადი inline კლავიატურები** სწრაფი ინტერაქტიული ღილაკებისთვის.
- **Media-by-URL** გამავალ შეტყობინებებში.
- **დედუპლიკაცია გასაღების მიხედვით**, ასე რომ ხელახალი მიწოდება არასოდეს ქმნის დუბლირებას.
## როგორ მოძრაობს შეტყობინებები
თითოეული შემომავალი MAX შეტყობინება აღწევს gateway-ს იმავე შემომავალი გზით, როგორც ყველა
სხვა არხი, დაცული გაზიარებული **inbound-HMAC საიდუმლოთი**. იქიდან turn
engine ამუშავებს მას როგორც ნებისმიერი სხვა არხის შეტყობინებას.
> [!NOTE]
> gateway-ს უნდა ჰქონდეს კონფიგურირებული ნაგულისხმევი workspace შემომავალი
> შეტყობინებების გასაგზავნად.
## შემდეგ სად
- შეადარეთ მსგავს ჩატის არხს: [Telegram](/ka/v1.0/channels/telegram).
- კონექტორების ინსტალაციის შესახებ: [Marketplace](/ka/v1.0/marketplace/overview-tiers).
- ახლახან იწყებთ? იხილეთ [Quickstart](/ka/v1.0/getting-started/quickstart).