AiHummer доки
v1.0.x ▾
v1.0.x stable
RU EN
Каналы /MAX

MAX

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

MAX — это российский мессенджер, и AiHummer подключается к нему как к каналу. Агент появляется в MAX как бот: он принимает входящие сообщения, выполняет обычный ход (turn) и отправляет ответ обратно — так же, как в Telegram и других каналах.

MAX поставляется как коннектор канала из Marketplace и построен на MAX Bot API. Это не отдельный сервис, который вы собираете сами: вы устанавливаете коннектор из встроенного Marketplace и настраиваете его в Admin UI, как любой другой канал.

Установка из Marketplace

Откройте встроенный Marketplace и установите модуль 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 приём — коннектор сам забирает входящие обновления (упоминания, ответы, медиа, интерактивные события), поэтому входящий публичный порт не нужен.
  • Нативные ответы (reply) на конкретное сообщение.
  • Базовые инлайн-клавиатуры для быстрых интерактивных кнопок.
  • Медиа по URL в исходящих сообщениях.
  • Дедупликация по ключу, поэтому повторная доставка не создаёт дубликат.

Как ходят сообщения

Каждое входящее сообщение MAX попадает в gateway по тому же входящему пути, что и у остальных каналов, и защищено общим inbound-HMAC секретом. Дальше оно обрабатывается turn-движком как сообщение любого другого канала.

[!NOTE] Чтобы входящие сообщения диспетчеризовались, в gateway должно быть задано рабочее пространство по умолчанию.

Куда дальше