MAX — bu rus messenjeri va AiHummer unga kanal sifatida ulanadi. Agent MAX’da
bot sifatida koʻrinadi: u kiruvchi xabarlarni qabul qiladi, oddiy turn’ni bajaradi
va javobni qaytaradi — xuddi Telegram va boshqa kanallar kabi.
MAX Marketplace kanal konnektori sifatida yetkaziladi va MAX Bot API
asosida qurilgan. Bu siz oʻzingiz quradigan xizmat emas: siz konnektorni ichki
mahsulot Marketplace’dan oʻrnatasiz va uni boshqa har qanday kanal kabi Admin UI
orqali sozlaysiz.
Marketplace’dan oʻrnatish
Ichki mahsulot Marketplaceni oching va
MAX modulini oʻrnating. Oʻrnatilgandan soʻng kanal Admin UI’ning kanallar
boʻlimida max kanal id’si bilan paydo boʻladi — agentni bogʻlaganingizda yoki
suhbatlarni manba boʻyicha filtrlaganingizda aynan shu id’dan foydalaning.
Ixtiyoriy ravishda MAX Bot API asosiy URL’ini **MAX_API_BASE**da belgilang.
U standart sifatida https://platform-api2.max.ruga teng, shuning uchun odatda
buni boʻsh qoldirishingiz mumkin.
Saqlang — konnektor xabarlarni qabul qila va yubora boshlaydi.
[!TIP]
MAX — AiHummerga max deb tanilgan kanal. Agentni bogʻlaganingizda yoki
suhbatlarni manba boʻyicha filtrlaganingizda aynan shu kanal id’sidan
foydalaning.
Nimalar qoʻllab-quvvatlanadi
MAX konnektori asosiy suhbat oqimlarini qamrab oladi:
Agent va MAX foydalanuvchilari oʻrtasida xabar yuborish va qabul qilish.
Long-poll kiruvchi — konnektor kiruvchi yangilanishlarni (eslatmalar,
javoblar, media, interaktiv hodisalar) tortib oladi, shuning uchun kiruvchi
ochiq port talab qilinmaydi.
Maʼlum bir xabarga native javoblar.
Tezkor interaktiv tugmalar uchun oddiy inline klaviaturalar.
Chiquvchi xabarlarda URL orqali media.
Kalit boʻyicha dedupe, shuning uchun qayta yetkazib berish hech qachon
takroriy xabar hosil qilmaydi.
Xabarlar qanday harakatlanadi
Har bir kiruvchi MAX xabari boshqa har qanday kanal kabi aynan oʻsha kiruvchi
yoʻl orqali gateway’ga yetib boradi, umumiy inbound-HMAC siri bilan
himoyalangan. U yerdan turn dvigateli uni boshqa har qanday kanal xabari kabi
qayta ishlaydi.
[!NOTE]
Kiruvchi xabarlarni dispetcherlash uchun gateway’da standart ish maydoni
sozlangan boʻlishi kerak.
Keyingi qadam
Oʻxshash chat kanali bilan solishtiring: Telegram.
**MAX — bu rus messenjeri va AiHummer unga kanal sifatida ulanadi.** Agent MAX’da
bot sifatida koʻrinadi: u kiruvchi xabarlarni qabul qiladi, oddiy turn’ni bajaradi
va javobni qaytaradi — xuddi Telegram va boshqa kanallar kabi.
MAX **Marketplace kanal konnektori** sifatida yetkaziladi va **MAX Bot API**
asosida qurilgan. Bu siz oʻzingiz quradigan xizmat emas: siz konnektorni ichki
mahsulot Marketplace’dan oʻrnatasiz va uni boshqa har qanday kanal kabi Admin UI
orqali sozlaysiz.
## Marketplace’dan oʻrnatish
Ichki mahsulot [Marketplace](/uz/v1.0/marketplace/overview-tiers)ni oching va
**MAX** modulini oʻrnating. Oʻrnatilgandan soʻng kanal Admin UI’ning kanallar
boʻlimida `max` kanal id’si bilan paydo boʻladi — agentni bogʻlaganingizda yoki
suhbatlarni manba boʻyicha filtrlaganingizda aynan shu id’dan foydalaning.
## Admin UI orqali sozlash
1. MAX boti yarating va uning tokenini oling.
2. Admin UI’da **MAX** kanal sozlamalarini oching.
3. Bot tokenini **`MAX_BOT_TOKEN`**ga joylang (sir, majburiy).
4. Ixtiyoriy ravishda MAX Bot API asosiy URL’ini **`MAX_API_BASE`**da belgilang.
U standart sifatida `https://platform-api2.max.ru`ga teng, shuning uchun odatda
buni boʻsh qoldirishingiz mumkin.
5. Saqlang — konnektor xabarlarni qabul qila va yubora boshlaydi.
> [!TIP]
> MAX — AiHummerga `max` deb tanilgan kanal. Agentni bogʻlaganingizda yoki
> suhbatlarni manba boʻyicha filtrlaganingizda aynan shu kanal id’sidan
> foydalaning.
## Nimalar qoʻllab-quvvatlanadi
MAX konnektori asosiy suhbat oqimlarini qamrab oladi:
- Agent va MAX foydalanuvchilari oʻrtasida **xabar yuborish va qabul qilish**.
- **Long-poll kiruvchi** — konnektor kiruvchi yangilanishlarni (eslatmalar,
javoblar, media, interaktiv hodisalar) tortib oladi, shuning uchun kiruvchi
ochiq port talab qilinmaydi.
- Maʼlum bir xabarga **native javoblar**.
- Tezkor interaktiv tugmalar uchun **oddiy inline klaviaturalar**.
- Chiquvchi xabarlarda **URL orqali media**.
- **Kalit boʻyicha dedupe**, shuning uchun qayta yetkazib berish hech qachon
takroriy xabar hosil qilmaydi.
## Xabarlar qanday harakatlanadi
Har bir kiruvchi MAX xabari boshqa har qanday kanal kabi aynan oʻsha kiruvchi
yoʻl orqali gateway’ga yetib boradi, umumiy **inbound-HMAC siri** bilan
himoyalangan. U yerdan turn dvigateli uni boshqa har qanday kanal xabari kabi
qayta ishlaydi.
> [!NOTE]
> Kiruvchi xabarlarni dispetcherlash uchun gateway’da standart ish maydoni
> sozlangan boʻlishi kerak.
## Keyingi qadam
- Oʻxshash chat kanali bilan solishtiring: [Telegram](/uz/v1.0/channels/telegram).
- Konnektorlarni oʻrnatish boʻyicha: [Marketplace](/uz/v1.0/marketplace/overview-tiers).
- Endi boshlayapsizmi? [Quickstart](/uz/v1.0/getting-started/quickstart)ni koʻring.