Перед началом

Юрлицо или ИП — резидент РФ с верифицированным профилем на платформе MAX для партнёров.
Созданный чат-бот в разделе «Чат-боты», прошедший модерацию.
Аккаунт Adminica с балансом токенов.

Не подходит: обычная группа или канал без бота — у них нет API-токена. Adminica работает только с MAX Bot API (platform-api.max.ru).

После подключения пользователи пишут боту в MAX, Adminica отвечает по вашей библиотеке; токены списываются с вашего баланса.

Шаг 1. Создайте бота в MAX

Войдите на business.max.ru → Чат-боты → создайте бота или выберите существующего.
Заполните название, аватар и описание — это видят пользователи в чате.
Дождитесь успешной модерации. Пока бот на проверке, пользователи могут его не найти в поиске.
Откройте Расширенные настройки → Настроить и скопируйте токен (API key).
При необходимости разрешите добавление бота в групповой чат.

Ник бота генерируется автоматически, например id301808700317_bot. Публичная ссылка:

https://max.ru/<username_бота>

Пример: max.ru/id301808700317_bot

Шаг 2. Подключите бота в Adminica

Войдите на adminica.ru под своим аккаунтом.
Откройте Профиль → Безопасность и интеграции.
В секции MAX (мессенджер) вставьте токен бота.
Нажмите Подключить бота.

Adminica проверит токен, зарегистрирует webhook и сохранит токен в зашифрованном виде. В интерфейсе токен повторно не показывается. Один бот на один аккаунт Adminica.

Шаг 2.1. Персональная ссылка (опционально)

Если у вас есть персональная ссылка с выбранными документами (вкладка «Ссылки» в профиле):

Убедитесь, что в ссылке выбран хотя бы один документ.
Нажмите кнопку с иконкой бота в карточке ссылки — она станет зелёной.
Бот MAX будет отвечать только по документам этой ссылки (и с её настройками характера).

Одновременно активна одна ссылка на аккаунт.

Шаг 3. Как пользователи находят бота

Способ	Действие
Ссылка	Отправьте `https://max.ru/<username_бота>`
Поиск в MAX	Введите полный ник (`id…_bot`), не только отображаемое имя
Группа	Добавьте бота в группу (если разрешено в настройках MAX)

Шаг 4. Проверка

Откройте бота в MAX и отправьте короткий вопрос по вашей тематике.
Ответ должен прийти в личный чат с ботом.
В профиле проверьте, что баланс токенов уменьшается после ответов.

Частые проблемы

Бота не находят в поиске MAX

Проверьте модерацию на business.max.ru.
Ищите по нику (username из API), не по красивому имени.
Дайте прямую ссылку https://max.ru/<username>.

«Не удалось проверить токен»

Токен скопирован целиком, без пробелов.
Бот не удалён на платформе MAX; при сомнении — перевыпустите токен.

Бот молчит после сообщения

Бот подключён с того же аккаунта Adminica.
На балансе достаточно токенов.
Пишите в личку боту (ответ в группу в v1 не дублируется).
Если включена персональная ссылка — проверьте документы в ссылке.

Аналог для VK: инструкция VK · API Adminica · MAX Bot API

Отключение

Профиль → Безопасность → MAX → Отключить. Webhook в MAX снимается, бот в MAX остаётся.

Подключение чат-бота MAX