MAX Bot

Подключение MAX Bot к ИИ-агенту через Access Token

Канал "MAX Bot" находится в режиме альфа-теста и будет доступен в ближайшие дни.

Следите за обновлениями.

О типе подключения

MAX Bot — это тип подключения, который позволяет связать ИИ-агента с чат-ботом MAX. Такой бот становится отдельным каналом связи в MAX, а ответы в групповых чатах включаются и настраиваются отдельно в Nextbot.

Подключение

Если у вас ещё нет MAX Bot, сначала создайте его на стороне MAX. По официальной документации MAX для этого нужно:

1. Войти на платформу MAX для партнёров или зарегистрироваться.

2. Создать и верифицировать профиль организации.

3. Перейти в раздел Чат-боты и нажать Создать.

4. Заполнить карточку бота и дождаться модерации.

5. После модерации открыть Чат-боты -> Интеграция -> Получить токен и скопировать Access Token.

По официальной документации MAX создание чат-ботов на платформе доступно юрлицам и ИП - резидентам РФ. Если нужен полный порядок регистрации, смотрите создание чат-бота и подключение к платформе и создание профиля организации.

Далее подключите бота в Nextbot:

1. Перейдите на страницу Интеграции - MAX Bot.

2. В блоке Подключение MAX Bot вставьте Access Token в поле подключения.

3. Нажмите Подключить бота.

После этого Nextbot автоматически настроит webhook и проверит подписку на события. Если подключение прошло успешно, в блоке подключения отобразится статус Подключено.

Один Access Token можно привязать только к одному ИИ-агенту. Если этот ключ уже используется в другом агенте, для нового подключения потребуется другой токен.

Настройка MAX Bot

Стартовое сообщение

Это сообщение бот отправляет в ответ на команду /start и при первом запуске бота пользователем.

Если поле оставить пустым, команда /start будет обрабатываться как обычное сообщение.

Работа в группах

В этом блоке настраивается поведение MAX Bot в групповых чатах.

Разрешить ответы в групповых чатах

Эта опция включает ответы бота в групповых чатах. Если она выключена, бот игнорирует сообщения в группах. В группе боту необходимо предоставить права администратора.

Считать группу одним диалогом

Когда опция включена, сообщения из одной группы обрабатываются как единый диалог. Когда выключена — каждый написавший участник группы будет обрабатываться в отдельном диалоге.

Имя бота

Если задать Имя бота, бот будет отвечать только на сообщения, которые начинаются с этого имени. Это помогает ограничить ответы в группе и не реагировать на каждое сообщение подряд.

Отчёты администратору

Этот блок нужен для привязки получателя отчётов в MAX. Получателем станет тот, кто первым отправит пароль вашему боту.

Если пароль отправить в личный чат с ботом, отчёты будут приходить лично. Если отправить его в групповом чате, отчёты будут приходить в эту группу.

Одноразовый пароль администратора

Этот пароль используется один раз для привязки получателя отчётов. После успешной привязки вы увидите предупреждение Вы получили права администратора, а сам пароль обнулится.

Пока пароль не задан и получатель не привязан, отчёты отправляться не будут.

Подробнее о настройке отправки отчётов через MAX Bot смотрите в статье получение отчётов в MAX Bot.