AiHummer
Қазақша▾
КіруЖеке кабинет
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Арналар/МАКС

МАКС

v1.2.x · жаңартылды 2026-07-05

MAX — орыс мессенджері, ал AiHummer оған арна ретінде қосылады. Агент MAX жүйесінде бот ретінде көрінеді: ол келіп түскен хабарламаларды алады, әдеттегі айналымды орындайды және жауапты қайта жібереді — дәл Telegram мен басқа арналдар сияқты.

MAX ретінде жіберіледі Маркетплейс арнасының коннекторы және оның негізінде салынған MAX Бот API. Бұл өзіңіз жасайтын қызмет емес: сіз коннекторды өнім ішіндегі Marketplace-тен орнатып, оны Admin UI арқылы басқа арналар сияқты баптайсыз.

Маркетплейстен орнату

Өнімнің ішін ашыңыз Нарық және орнатыңыз МАКС модуль. Орнатылғаннан кейін, арна Admin UI-дің арналар бөлімінде арна идентификаторы көрсетілген түрде пайда болады max — агентті тіркегенде немесе әңгімелерді көзі бойынша сүзгіден өткізгенде осы идентификаторды пайдаланыңыз.

[!NOTE] MAX арнасы белсенділікті қажет етеді Бастауыш, Кәсіпкерлік немесе Кәсіпорын лицензия. Қауымдастық жоспары бойынша, коннекторды орнату нәтижесінде қайтарылады HTTP 402 «жаңарту қажет» (код plan_limit) — қараңыз Лицензиялау.

Оны әкімші интерфейсінен орнатыңыз

  1. MAX ботын жасап, оның токенін алыңыз.
  2. Әкімші интерфейсінде ашыңыз МАКС арна параметрлері.
  3. Бот токенін кірістіру MAX_BOT_TOKEN (құпия, міндетті).
  4. Қалауы бойынша MAX Bot API негізгі URL мекенжайын орнатыңыз MAX_API_BASE. Ол әдепкі бойынша тағайындалады https://platform-api2.max.ru, сондықтан әдетте бұл жерді бос қалдыруға болады.
  5. Сақтау — қосқыш хабарларды қабылдай бастайды және жібереді.

[!TIP] MAX AiHummer-ге анықталған арна болып табылады max. Сол арна идентификаторын қолданған кезде агентті байлау немесе әңгімені көз бойынша сүзу.

Қандай қолдау көрсетіледі

MAX қосқышы негізгі әңгімелесу ағындарын қамтиды:

  • Хабарларды жіберу және алу агент пен MAX пайдаланушыларының арасында.
  • Ұзақ сұрау кіріс — қосқыш кіріп жатқан жаңартуларды (атап өту) тартады, жауаптар, медиа, интерактивті оқиғалар), сондықтан кіріске арналған ашық порт қажет емес.
  • Туған тілдегі жауаптар нақты хабарламаға.
  • Негізгі ішкі пернетақталар жылдам интерактивті батырмалар үшін.
  • Медиа бойынша URL шығарылатын хабарларда.
  • Кілт бойынша қайталануды жою, сондықтан қайта жеткізу ешқашан көшірмені жасамайды.

Хабарламалар қалай ағылады

Әрбір кіріс MAX хабары басқа арналардың әрқайсысымен бірдей кіріс жолы арқылы шлюзге жетеді, бірлескен қорғаумен қамтамасыз етілген кіру-HMAC құпиясы. Сол жерден айналу қозғалтқышы оны кез келген басқа арна хабарламасы сияқты өңдейді.

[!NOTE] Шлюзде кіріс жіберу үшін әдепкі жұмыс алаңы орнатылуы керек хабарламалар.

Келесі қайда