AiHummer
Кыргызча
Кирүү
v1.0.x
{ }Swagger

MAX

v1.0.x · жаңыланды 2026-06-27

MAX — бул орус мессенджери, жана AiHummer ага канал катары туташат. Агент MAX’те бот катары көрүнөт: ал кирүүчү билдирүүлөрдү алат, кадимки кезекти иштетет жана жоопту артка жөнөтөт — Telegram жана башка каналдар сыяктуу эле.

MAX Marketplace канал коннектору катары жеткирилет жана MAX Bot API негизинде курулган. Бул өзүңүз курган кызмат эмес: сиз коннекторду продукттун ичиндеги Marketplace’тен орнотосуз жана аны, башка каналдар сыяктуу, Admin UI’ден конфигурациялайсыз.

Marketplace’тен орнотуу

Продукттун ичиндеги Marketplace ачыңыз жана MAX модулун орнотуңуз. Орнотулгандан кийин канал Admin UI’нин каналдар бөлүмүндө max канал id’си менен пайда болот — агентти байлаганда же сүйлөшүүлөрдү булагы боюнча чыпкалаганда ошол id’ди колдонуңуз.

Аны Admin UI’ден орнотуу

  1. MAX бот түзүп, анын токенин алыңыз.
  2. Admin UI’де MAX каналынын жөндөөлөрүн ачыңыз.
  3. Бот токенин 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 кирүүчү — коннектор кирүүчү жаңыртууларды (белгилөөлөр, жооптор, медиа, интерактивдүү окуялар) тартып алат, ошондуктан кирүүчү ачык порт талап кылынбайт.
  • Белгилүү бир билдирүүгө нативдик жооптор.
  • Тез интерактивдүү баскычтар үчүн негизги инлайн клавиатуралар.
  • Чыгуучу билдирүүлөрдөгү медиа-URL аркылуу.
  • Ачкыч боюнча дедуп, ошондуктан кайра жеткирүү эч качан кайталанган билдирүү жаратпайт.

Билдирүүлөр кантип агат

Ар бир кирүүчү MAX билдирүүсү шлюзга башка ар бир канал сыяктуу эле кирүүчү жол аркылуу жетет, бөлүшүлгөн inbound-HMAC сыры менен корголгон. Ал жерден кезек кыймылдаткычы аны башка каналдын билдирүүсү сыяктуу иштетет.

[!NOTE] Кирүүчү билдирүүлөрдү жөнөтүү үчүн шлюзда демейки жумушчу мейкиндик конфигурацияланган болушу керек.

Андан ары кайда

  • Окшош маек каналы менен салыштырыңыз: Telegram.
  • Коннекторлорду орнотуу боюнча: Marketplace.
  • Жаңы баштап жатасызбы? Quickstart караңыз.