AiHummer
Русский▾
ВойтиЛичный кабинет
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Каналы/MAX

MAX

v1.1.x · обновлено 2026-07-21

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

Перед выбором канала оцените ограничения MAX Bot API: боту нужен токен, выданный платформой MAX; бот отвечает пользователям, которые сами начали с ним диалог; из типов сообщений коннектор поддерживает текст, ответы (reply), базовые инлайн-клавиатуры и медиа по URL — опросы, реакции и треды не поддерживаются. Сам мессенджер ориентирован на российский рынок: для учётной записи нужен номер телефона, а доступность сервиса за пределами РФ и Беларуси ограничена условиями платформы MAX.

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

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

Откройте встроенный Маркетплейс и установите модуль MAX. После установки канал появляется в разделе каналов админ-панели с идентификатором канала max — используйте этот id, когда привязываете агента или фильтруете диалоги по источнику.

[!NOTE] Канал MAX требует активной лицензии Starter, Business или Enterprise. На тарифе Community установка коннектора возвращает HTTP 402 «требуется повышение тарифа» (код plan_limit) — подробнее в Лицензировании.

Настройка в админ-панели

  1. Создайте бота MAX и получите его токен.
  2. В админ-панели откройте настройки канала MAX.
  3. Вставьте токен бота в поле MAX_BOT_TOKEN (секрет, обязательное).
  4. При необходимости задайте базовый URL MAX Bot API в поле MAX_API_BASE. По умолчанию используется https://platform-api2.max.ru, поэтому в большинстве случаев это поле можно оставить пустым.
  5. Сохраните — коннектор начинает принимать и отправлять сообщения.

Ожидаемый результат: карточка канала MAX показывает статус «онлайн»; сообщение, отправленное боту в MAX, появляется как диалог на экране «Сессии», и агент отвечает в чате.

[!TIP] MAX идентифицируется в AiHummer как канал max. Указывайте этот id канала при привязке агента или фильтрации диалогов.

Что поддерживается

Коннектор MAX покрывает основные сценарии диалога:

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

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

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

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

Куда дальше