Проверьте основу
Кому доступно создание MAX-бота
Создание бота в MAX доступно российским юридическим лицам, ИП и самозанятым, которые являются резидентами РФ. Это требование относится к подключению к платформе MAX для партнёров и её сервисам, включая чат-ботов. Перед работой со сценарием проверьте, что создаёте именно профиль организации, ИП или самозанятого, а не личный аккаунт в мессенджере.
Бот создаётся и проходит проверку на стороне MAX. Конструктор сценариев не может обойти эту процедуру и не выдаёт токен заранее. Такой порядок важен для планирования запуска: сначала профиль и карточка бота, затем модерация, после неё настройки, токен и подключение рабочих инструментов.
Если вы ведёте несколько направлений бизнеса, заранее определите, будет ли у каждого свой бот и профильный сценарий. У MAX один бот соответствует отдельной карточке и проходит собственную модерацию. Не переносите в описание данные другой компании: официальные требования MAX запрещают использовать в карточке и логотипе чужие данные, контент 18+ и ненормативную лексику.
До карточки бота
Создайте и верифицируйте профиль партнёра
Перейдите на платформу MAX для партнёров и подключитесь к сервису чат-ботов. По официальной инструкции, сначала нужно создать и верифицировать профиль организации, ИП или самозанятого. Только после этого доступно создание бота. Веб-версия платформы и мини-приложение MAX для бизнеса используют одинаковые шаги создания и редактирования.
В профиле заранее соберите сведения, которые понадобятся в карточке: название, описание задач бота, логотип и контакты для клиента. Описание должно совпадать с деятельностью организации. Если бот принимает вопросы только в часы работы оператора, лучше написать это в публичном описании, а не оставлять человека без объяснения после первого сообщения.
Публичная часть
Заполните карточку и дождитесь модерации
В разделе Чат-боты нажмите Создать и заполните карточку. MAX формирует никнейм автоматически, а остальные сведения заполняет владелец профиля. Проверьте название, логотип и описание перед отправкой. Пользователь увидит эти данные в мессенджере, поэтому текст должен объяснять, что бот делает, а не повторять внутреннее название проекта.
Откройте раздел чат-ботов
В профиле партнёра MAX перейдите в список ботов и нажмите кнопку создания.
Заполните карточку
Добавьте логотип, название и описание задач. Сверьте материалы с требованиями MAX и реальной деятельностью профиля.
Отправьте бота на модерацию
После создания появится статус На модерации. MAX указывает, что проверка занимает до 48 часов по рабочим дням.
Обработайте замечания, если они появятся
При статусе Нужны исправления откройте причину в карточке, исправьте сведения и отправьте их на повторную проверку.
Пока бот находится на модерации, его настройки недоступны для изменения. После успешной проверки он получает опубликованный статус, и пользователи смогут найти его в MAX по никнейму. Если позже поменять данные в карточке, MAX отправит изменения на повторную модерацию; до её завершения пользователи продолжают видеть прежнюю версию.
Ключ доступа
Получите токен после одобрения и сохраните его в секрете
После успешной модерации в настройках бота формируется токен. MAX называет его уникальным идентификатором, с которым бот взаимодействует с API. Чтобы скопировать его, откройте список Чат-боты, выберите нужного бота, перейдите в меню настроек и используйте кнопку копирования рядом с полем токена.
Не относитесь к токену как к обычному идентификатору. Он даёт прямой доступ к боту, поэтому его нельзя публиковать в задаче, присылать подрядчику без необходимости или оставлять в открытом документе. Если есть подозрение, что токен увидел посторонний, обновите его в настройках MAX. После обновления замените сохранённое подключение там, где бот использует API.
После MAX
Подключите токен и настройте первый сценарий
Когда токен получен, откройте в MultiBot Hub управление ботами, выберите добавление MAX-бота и вставьте токен в защищённую форму. Панель проверит бот через MAX API, после подключения зарегистрирует webhook и сможет получать сообщения, нажатия кнопок и событие старта. Это техническое подключение не меняет профиль и модерацию в MAX.
Для первого сценария достаточно одного полезного пути. Начните с приветствия и двух действий, например узнать условия или задать вопрос. Первое ведёт к сообщению с нужной информацией, второе собирает вопрос и при необходимости создаёт заявку для команды. Визуальный Flow Engine проекта поддерживает сообщения, условия, ввод, задержки, переменные и действие создания заявки.
Проверьте сценарий с обычного пользовательского аккаунта в MAX. Найдите бота, начните диалог, нажмите каждую кнопку и убедитесь, что любое ответвление заканчивается понятным следующим действием. Только после этого добавляйте ссылку на бота в сайт, рекламу или материалы для клиентов.
- Профиль партнёра создан и верифицирован как профиль российского юрлица, ИП или самозанятого.
- Карточка бота соответствует деятельности профиля и прошла модерацию MAX.
- Токен получен после одобрения, хранится в секрете и не попал в открытые источники.
- Подключение в MultiBot Hub прошло проверку бота.
- Сценарий проверен в MAX: старт, сообщение, кнопки и передача вопроса команде работают по ожидаемому маршруту.