# MAX Bot

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

Следите за обновлениями.
{% endhint %}

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

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

## Подключение

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

1. Войти на платформу MAX для партнёров или зарегистрироваться.
2. Создать и верифицировать профиль организации.
3. Перейти в раздел `Чат-боты` и нажать `Создать`.
4. Заполнить карточку бота и дождаться модерации.
5. После модерации открыть `Чат-боты -> Интеграция -> Получить токен` и скопировать `Access Token`.

{% hint style="info" %}
По официальной документации MAX создание чат-ботов на платформе доступно юрлицам и ИП - резидентам РФ. Если нужен полный порядок регистрации, смотрите [создание чат-бота](https://dev.max.ru/docs/chatbots/bots-create) и [подключение к платформе и создание профиля организации](https://dev.max.ru/docs/maxbusiness/connection).
{% endhint %}

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

1. Перейдите на страницу [Интеграции - MAX Bot](https://app.nextbot.ru/integrations?tab=MaxBotSettings).
2. В блоке `Подключение MAX Bot` вставьте `Access Token` в поле подключения.
3. Нажмите `Подключить бота`.

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

{% hint style="warning" %}
Один `Access Token` можно привязать только к одному ИИ-агенту. Если этот ключ уже используется в другом агенте, для нового подключения потребуется другой токен.
{% endhint %}

<figure><img src="/files/lXAsFgJ9Lq4a6FVAqvH1" alt=""><figcaption></figcaption></figure>

## Настройка MAX Bot

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

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

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

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

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

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

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

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

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

### Имя бота

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

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

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

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

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

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

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

Подробнее о настройке отправки отчётов через MAX Bot смотрите в статье [получение отчётов в MAX Bot](/functional/functions/sending-result/adminu-v-messendzher/max-bot.md).

<figure><img src="/files/A6zrZUHEHQeIofSh5xKi" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.nextbot.ru/functional/integrations/max/max-bot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.