Документация /MAX-коннектор

MAX-коннектор

Подключение российского мессенджера MAX через бота — автоответы клиентам 24/7.

MAX-коннектор подключает российский мессенджер MAX как канал коммуникации с клиентами. ИИ-агент отвечает на входящие сообщения в личных и групповых чатах 24/7 от имени вашего бота — без номера телефона и подтверждающих кодов.

Время настройки: 2–3 минуты  ·  Что потребуется: аккаунт в MAX и бот, созданный через MasterBot
Это страница про MAX как канал общения с клиентами. Если вам нужны уведомления о работе агента в MAX для оператора — смотрите MAX-оповещения.

Возможности

  • Автоматические ответы — агент отвечает на входящие сообщения 24/7.
  • Личные и групповые чаты — бот работает и в диалогах 1-на-1, и в групповых чатах.
  • Многошаговые диалоги — полноценные продающие и консультационные сценарии с сохранением контекста.
  • Цитирование сообщений — агент может отвечать реплаем на конкретное сообщение клиента.
  • Комбинированная работа — один агент может обрабатывать MAX, Telegram, WhatsApp и Email одновременно.
  • Загрузка истории — при первом подключении можно подтянуть сообщения за последние 1–90 дней.

Предварительные требования

ТребованиеОписание
Аккаунт в MAXЛюбой активный аккаунт, с которого вы сможете создать бота
Бот через MasterBotOfficial bot-фабрика MAX — раздаёт токены доступа для ботов
Access TokenДлинная строка, которую MasterBot выдаст после создания бота
В отличие от Telegram, подключать личный номер телефона не нужно. Клиенты пишут вашему боту — агент отвечает от имени бота.

Пошаговая настройка

1

Создайте бота через MasterBot

  1. Откройте MAX и найдите чат с ботом @MasterBot — это официальный бот-администратор.
  2. Отправьте команду /newbot.
  3. Следуйте инструкциям: укажите имя, username и аватар для нового бота.
  4. В финальном сообщении MasterBot пришлёт Access Token — длинную буквенно-цифровую строку.
Access Token — это ключ к управлению ботом. Не публикуйте его и не передавайте третьим лицам. При утечке сразу перевыпустите токен через MasterBot.
2

Откройте форму коннектора в Leadarr

НастройкиКоннекторы«+ Подключить коннектор» → выберите MAX.

3

Вставьте Access Token

Скопируйте токен из сообщения MasterBot и вставьте в поле «Вставьте токен от MasterBot».

По желанию можно указать:

  • Название коннектора — подпись в списке коннекторов (по умолчанию — username бота).
  • Давность истории — сколько старых сообщений подтянуть при первом запуске: не загружать, 1 час, 7 дней, 14 дней, 30 дней, 90 дней (по умолчанию — 7 дней).
4

Подтвердите подключение

Нажмите «Подключить MAX». Leadarr проверит токен через MAX Bot API и подтянет личность бота (username и имя). Если токен корректен — коннектор появится в списке со значком MAX и названием @bot_username.

Если увидите ошибку «Токен выглядит слишком коротким» — убедитесь, что скопировали строку целиком, без пробелов в начале и конце.

Как это работает

Клиент пишет вашему боту в MAX
        ↓
Leadarr получает сообщение через MAX Bot API (long-polling)
        ↓
Система проверяет триггеры агента
        ↓
ИИ-агент анализирует контекст и генерирует ответ
        ↓
Ответ отправляется в MAX от имени бота

Логика чатов

  • Личные чаты (DM): каждый новый пользователь создаёт отдельный чат. Повторное сообщение от того же пользователя продолжает существующий диалог.
  • Групповые чаты: для каждого группового чата создаётся один диалог — агент видит сообщения всех участников в рамках одного контекста.
  • Идентификация клиента: по user_id MAX — один пользователь = один клиент, независимо от того, через какой чат он пишет.

MAX vs Telegram

АспектMAXTelegram
Что подключаемБот, созданный через MasterBotЛичный аккаунт по номеру телефона
АвторизацияAccess TokenКод подтверждения + 2FA-пароль
Время настройки2–3 минуты3–5 минут
Кому пишут клиентыВашему ботуВам на личный номер
Групповые чатыПоддерживаютсяПоддерживаются
Несколько подключенийКаждый бот — отдельный коннекторКаждый номер — отдельный коннектор

Частые вопросы

Можно ли подключить несколько MAX-ботов?
Да. Создайте отдельного бота через MasterBot и добавьте его как новый коннектор. Каждый бот работает независимо.
Нужно ли подключать личный аккаунт MAX?
Нет. Агент работает только через бота — ваш личный аккаунт и личные сообщения не затрагиваются.
Что делать, если Access Token утёк?
Откройте чат с MasterBot и перевыпустите токен для этого бота. Затем обновите токен в настройках коннектора в Leadarr.
Безопасно ли подключать бота?
Да. Leadarr работает через официальный MAX Bot API — подключение аналогично любому другому сервису, который взаимодействует с ботами MAX. Токен хранится в зашифрованном виде.
Агент отвечает в групповых чатах всем подряд?
Нет. Агент реагирует только на сообщения, соответствующие настроенным триггерам. В групповом чате он видит все сообщения, но отвечает только там, где это предусмотрено сценарием.