MAX — ресейлік мессенджер, ал AiHummer оған арна ретінде қосылады. Агент
MAX-та бот ретінде көрінеді: ол кіріс хабарламаларды қабылдайды, қалыпты раунд
орындайды және жауапты кері жібереді — дәл Telegram және басқа арналар сияқты.
MAX Marketplace арна коннекторы ретінде жеткізіледі және MAX Bot
API негізінде құрылған. Бұл сіз өзіңіз құратын қызмет емес: коннекторды
өнім ішіндегі Marketplace-тен орнатасыз және оны Admin UI-ден кез келген басқа
арна сияқты баптайсыз.
Marketplace-тен орнату
Өнім ішіндегі Marketplace ашып, MAX
модулін орнатыңыз. Орнатылғаннан кейін арна Admin UI-дегі арналар бөлімінде
max арна идентификаторымен пайда болады — агентті байлаған кезде немесе
сөйлесулерді дереккөз бойынша сүзген кезде осы идентификаторды қолданыңыз.
Қажет болса, MAX_API_BASE өрісінде MAX Bot API базалық URL-ін
орнатыңыз. Әдепкі мәні https://platform-api2.max.ru, сондықтан мұны
әдетте бос қалдыруға болады.
Сақтаңыз — коннектор хабарламаларды қабылдап, жіберуді бастайды.
[!TIP]
MAX — AiHummer-ге max деп идентификацияланатын арна. Агентті байлаған кезде
немесе сөйлесулерді дереккөз бойынша сүзген кезде осы арна идентификаторын
қолданыңыз.
Не қолдау көрсетіледі
MAX коннекторы негізгі сөйлесу ағындарын қамтиды:
Агент пен MAX пайдаланушылары арасында хабарламаларды жіберу және қабылдау.
Long-poll кіріс — коннектор кіріс жаңартуларды (еске салулар,
жауаптар, медиа, интерактивті оқиғалар) тартып алады, сондықтан кіріс ашық
порт талап етілмейді.
Нақты бір хабарламаға нативті жауаптар.
Жылдам интерактивті түймелерге арналған қарапайым инлайн пернетақталар.
Шығыс хабарламалардағы URL арқылы медиа.
Кілт бойынша дедупликация, сондықтан қайта жіберілген жеткізу ешқашан
қайталанба тудырмайды.
Хабарламалар қалай ағады
Әрбір кіріс MAX хабарламасы шлюзге барлық басқа арналар сияқты дәл сол кіріс
жолымен жетеді, ортақ inbound-HMAC құпиясымен қорғалған. Одан әрі раунд
қозғалтқышы оны кез келген басқа арна хабарламасы сияқты өңдейді.
[!NOTE]
Кіріс хабарламаларды диспетчерлеу үшін шлюзде әдепкі жұмыс кеңістігі
бапталған болуы керек.
**MAX — ресейлік мессенджер, ал AiHummer оған арна ретінде қосылады.** Агент
MAX-та бот ретінде көрінеді: ол кіріс хабарламаларды қабылдайды, қалыпты раунд
орындайды және жауапты кері жібереді — дәл Telegram және басқа арналар сияқты.
MAX **Marketplace арна коннекторы** ретінде жеткізіледі және **MAX Bot
API** негізінде құрылған. Бұл сіз өзіңіз құратын қызмет емес: коннекторды
өнім ішіндегі Marketplace-тен орнатасыз және оны Admin UI-ден кез келген басқа
арна сияқты баптайсыз.
## Marketplace-тен орнату
Өнім ішіндегі [Marketplace](/kk/v1.0/marketplace/overview-tiers) ашып, **MAX**
модулін орнатыңыз. Орнатылғаннан кейін арна Admin UI-дегі арналар бөлімінде
`max` арна идентификаторымен пайда болады — агентті байлаған кезде немесе
сөйлесулерді дереккөз бойынша сүзген кезде осы идентификаторды қолданыңыз.
## Admin UI-ден баптау
1. MAX боты құрып, оның токенін алыңыз.
2. Admin UI-де **MAX** арнасының баптауларын ашыңыз.
3. Бот токенін **`MAX_BOT_TOKEN`** өрісіне қойыңыз (құпия, міндетті).
4. Қажет болса, **`MAX_API_BASE`** өрісінде MAX Bot API базалық URL-ін
орнатыңыз. Әдепкі мәні `https://platform-api2.max.ru`, сондықтан мұны
әдетте бос қалдыруға болады.
5. Сақтаңыз — коннектор хабарламаларды қабылдап, жіберуді бастайды.
> [!TIP]
> MAX — AiHummer-ге `max` деп идентификацияланатын арна. Агентті байлаған кезде
> немесе сөйлесулерді дереккөз бойынша сүзген кезде осы арна идентификаторын
> қолданыңыз.
## Не қолдау көрсетіледі
MAX коннекторы негізгі сөйлесу ағындарын қамтиды:
- Агент пен MAX пайдаланушылары арасында **хабарламаларды жіберу және қабылдау**.
- **Long-poll кіріс** — коннектор кіріс жаңартуларды (еске салулар,
жауаптар, медиа, интерактивті оқиғалар) тартып алады, сондықтан кіріс ашық
порт талап етілмейді.
- Нақты бір хабарламаға **нативті жауаптар**.
- Жылдам интерактивті түймелерге арналған **қарапайым инлайн пернетақталар**.
- Шығыс хабарламалардағы **URL арқылы медиа**.
- **Кілт бойынша дедупликация**, сондықтан қайта жіберілген жеткізу ешқашан
қайталанба тудырмайды.
## Хабарламалар қалай ағады
Әрбір кіріс MAX хабарламасы шлюзге барлық басқа арналар сияқты дәл сол кіріс
жолымен жетеді, ортақ **inbound-HMAC құпиясымен** қорғалған. Одан әрі раунд
қозғалтқышы оны кез келген басқа арна хабарламасы сияқты өңдейді.
> [!NOTE]
> Кіріс хабарламаларды диспетчерлеу үшін шлюзде әдепкі жұмыс кеңістігі
> бапталған болуы керек.
## Әрі қарай қайда
- Ұқсас чат арнасымен салыстырыңыз: [Telegram](/kk/v1.0/channels/telegram).
- Коннекторларды орнату туралы: [Marketplace](/kk/v1.0/marketplace/overview-tiers).
- Жаңадан бастап жатырсыз ба? [Жылдам бастау](/kk/v1.0/getting-started/quickstart) қараңыз.