AiHummer
Беларуская▾
Увайсці
v1.0.x▾
v1.0.xstable
{ }Swagger
Каналы/MAX

MAX

v1.0.x · абноўлена 2026-06-27

MAX — гэта расійскі месэнджар, і AiHummer падключаецца да яго як да канала. Агент з’яўляецца ў MAX як бот: ён прымае ўваходныя паведамленні, выконвае звычайны ход і адпраўляе адказ назад — гэтак жа, як Telegram і іншыя каналы.

MAX пастаўляецца як канальны канектар з Маркетплейса і пабудаваны на MAX Bot API. Гэта не сэрвіс, які вы будуеце самі: вы ўсталёўваеце канектар з убудаванага Маркетплейса і наладжваеце яго з Admin UI, як і любы іншы канал.

Усталяванне з Маркетплейса

Адкрыйце ўбудаваны Маркетплейс і ўсталюйце модуль MAX. Пасля ўсталявання канал з’яўляецца ў раздзеле каналаў Admin UI з ідэнтыфікатарам канала max — выкарыстоўвайце гэты id, калі прывязваеце агента ці фільтруеце размовы па крыніцы.

Наладка з Admin UI

  1. Стварыце бота MAX і атрымайце яго токен.
  2. У Admin UI адкрыйце налады канала MAX.
  3. Устаўце токен бота ў MAX_BOT_TOKEN (сакрэт, абавязковы).
  4. Пры жаданні задайце базавы URL MAX Bot API ў MAX_API_BASE. Па змаўчанні ён роўны https://platform-api2.max.ru, таму звычайна гэта поле можна пакінуць пустым.
  5. Захавайце — канектар пачынае прымаць і адпраўляць паведамленні.

[!TIP] MAX — гэта канал, ідэнтыфікаваны для AiHummer як max. Выкарыстоўвайце гэты id канала, калі прывязваеце агента ці фільтруеце размовы па крыніцы.

Што падтрымліваецца

Канектар MAX ахоплівае асноўныя патокі размовы:

  • Адпраўка і прыём паведамленняў паміж агентам і карыстальнікамі MAX.
  • Long-poll уваходны паток — канектар выцягвае ўваходныя абнаўленні (згадкі, адказы, медыя, інтэрактыўныя падзеі), таму ўваходны публічны порт не патрэбны.
  • Натыўныя адказы на канкрэтнае паведамленне.
  • Базавыя інлайн-клавіятуры для хуткіх інтэрактыўных кнопак.
  • Медыя-па-URL у зыходных паведамленнях.
  • Дэдуплікацыя па ключы, таму паўторная дастаўка ніколі не стварае дубліката.

Як рухаюцца паведамленні

Кожнае ўваходнае паведамленне MAX дасягае шлюза па тым самым уваходным шляху, што і кожны іншы канал, абаронены агульным inbound-HMAC сакрэтам. Адтуль рухавік ходаў апрацоўвае яго, як і любое іншае канальнае паведамленне.

[!NOTE] Шлюз павінен мець наладжаны працоўны прастор па змаўчанні, каб дыспетчарызаваць уваходныя паведамленні.

Куды далей