Как создать бота в Макс: от регистрации до первого ответа

Что подготовить до регистрации бота в MAX

MAX - мессенджер от VK. Боты в нем регистрируются на организацию через платформу MAX для партнеров. Поэтому до технической части нужна организационная.

• Статус и реквизиты. Бот оформляется на юрлицо или ИП. Если у вас нет статуса, уточните актуальные условия на платформе: правила для разных категорий пользователей меняются.
• Кто будет администратором. Сотрудник, у которого останется доступ к кабинету и токену. Не оформляйте все на подрядчика.
• Название и адрес бота. Короткое, узнаваемое, желательно совпадает с названием компании.
• Аватар и описание. Логотип квадратом и 1-2 предложения о том, чем бот поможет.
• Где будет работать логика. Свой сервер с HTTPS, облачная функция или сервис автоматизации вроде n8n.
• Тексты первого сценария. Приветствие, меню, ответы на 10-20 частых вопросов.

Если вы еще выбираете, нужен ли бот в MAX вообще, сначала прочитайте обзор боты в MAX: какие бывают и зачем они бизнесу.

Как создать бота в Макс пошагово: инструкция

Названия разделов в кабинете могут отличаться от описанных: платформа обновляется. Логика шагов при этом остается той же.

Шаг 1. Регистрация организации на платформе для партнеров

На экране вы увидите форму с данными компании. Введите реквизиты и контакты ответственного, подтвердите их способом, который предложит платформа. Проверка может занять время, закладывайте его в план запуска.

Шаг 2. Создание бота в кабинете

После проверки в кабинете появится раздел для чат-ботов. Создайте бота: укажите имя, адрес, описание и загрузите аватар. Бот может проходить модерацию перед тем, как станет доступен пользователям.

Шаг 3. Токен

В настройках бота вы получите токен - ключ доступа к API. Храните его как пароль: не пересылайте в чатах, не выкладывайте в открытый репозиторий. Если токен утек, перевыпустите его в кабинете.

Шаг 4. Получение сообщений

Есть два способа узнавать о новых сообщениях. Первый - ваш сервер сам периодически запрашивает обновления у API, это удобно для теста. Второй - вебхук: MAX отправляет события на ваш адрес с HTTPS, это правильный вариант для рабочего бота.

Шаг 5. Первый ответ

Напишите обработчик: когда пользователь начинает диалог, бот отправляет приветствие и меню. На любое другое сообщение пока отвечает «Передал ваш вопрос менеджеру» и пересылает текст в рабочий чат.

Шаг 6. Проверка в приложении

Найдите бота по адресу в MAX, начните диалог с телефона и с компьютера. Проверьте кнопки, длинные сообщения, отправку фото и что будет, если написать ерунду.

Технические детали запросов, формат событий и лимиты смотрите в официальной документации API MAX. Мы сверяемся с ней на каждом проекте: платформа молодая, и детали меняются.

Как написать меню для чат-бота MAX

Меню решает, дойдет ли клиент до заявки. Хорошее меню отвечает на вопрос «зачем я сюда пришел» с первого экрана.

Правила

• На первом экране 3-5 кнопок. Остальное прячьте во второй уровень.
• Текст кнопки - действие клиента: «Записаться», «Узнать цену», а не «Услуги» и «Информация».
• Кнопка «Связаться с человеком» есть всегда.
• Каждый ответ заканчивается следующим шагом: кнопкой или вопросом.
• Если бот с ИИ, клиент может просто написать вопрос словами. Скажите ему об этом в приветствии.

Пример меню для салона красоты

Приветствие: «Здравствуйте, это салон «Лаванда». Могу записать вас, подсказать цены или позвать администратора. Выберите кнопку или просто напишите вопрос».

Какие типы кнопок доступны сейчас, например запрос контакта или ссылка, проверьте в документации: список расширяется.

Как подключить ИИ к боту в MAX

Кнопочный бот отвечает только на нажатия. Чтобы бот понимал вопросы, написанные своими словами, между MAX и клиентом ставится языковая модель.

1. Клиент пишет вопрос, MAX присылает его на ваш сервер или в сценарий n8n.
2. Сервер находит в базе ответов подходящие фрагменты: прайс, условия, адреса.
3. Отправляет в модель вопрос, найденные фрагменты и инструкцию: отвечай только по базе, не придумывай цены, не знаешь - зови человека.
4. Получает ответ и отправляет его клиенту через API MAX.
5. Если в ответе метка «нужен человек», пересылает диалог менеджеру.

Модель чаще выбирают российскую: GigaChat или YandexGPT. Подключение описано в материалах GigaChat API и YandexGPT API. Оплата модели идет по тарифам поставщика. Без программирования связку можно собрать в n8n через узлы вебхука и HTTP-запроса. Что это за инструмент, объясняет словарь: n8n.

Персональные данные клиентов, например телефоны и имена, обрабатываются по 152-ФЗ: нужно согласие и понятное место хранения.

Сделать чат-бот в Максе для бизнеса самому или заказать

Граница проходит там, где ошибка бота стоит денег: неверная цена, потерянная заявка, двойная запись. Разработку под задачи компании и перенос из Telegram описывает страница чат-бот в MAX для бизнеса. Пакет «Старт» стоит 19 900 ₽, а если бот уже работает в Telegram, MAX подключается как новый канал за 12 000 ₽.

Частые ошибки при запуске бота в MAX

• Токен у подрядчика. Доступ к кабинету и токену должен остаться у компании.
• Нет выхода на человека. Клиент застревает в меню и уходит.
• Надежда на рассылки. Бот может писать только тем, кто сам начал с ним диалог. Приглашайте клиентов через сайт, другие мессенджеры и QR-код в точке продаж.
• Тест только своими вопросами. Попросите пять знакомых написать как клиенты, с опечатками и сокращениями.
• Нет согласия на обработку данных. Если бот собирает телефон, добавьте согласие и ссылку на политику.

Если вы уже делали бота в Telegram, сравните шаги с инструкцией для Telegram: логика похожа, отличаются регистрация и детали API.