Бот в мессенджере MAX: как устроен Bot API и что он даёт бизнесу

Кратко. Бот в мессенджере MAX работает через Bot API — в документации это раздел «API ботов» — и отвечает по событиям платформы. Чтобы запустить бота, компания подключается к платформе партнёров MAX, проходит верификацию, создаёт бота, получает токен и отправляет его на модерацию — по данным партнёрских гайдов, она занимает до 48 часов в рабочие дни. Дальше — сценарии, продвижение и связка с CRM.

Что такое Bot API в MAX

Документация MAX (dev.max.ru/docs) разделяет два контура. Первый — «API ботов» (Bot API): он предназначен именно для ботов, которые общаются по событиям платформы и в типовой модели отвечают или инициируют действия в рамках своих сценариев. Второй — «Open Client API»: отдельный контур для клиентских интеграций, не для ботов.

Как технически работает Bot API

Bot API — REST-интерфейс поверх HTTPS: бот отправляет HTTP-запросы и получает события платформы. События приходят двумя способами: в работающем боте — вебхуками на HTTPS-адрес вашей системы (нужен доверенный сертификат), в разработке — long polling, когда бот сам опрашивает сервер и не требует ни белого IP, ни открытых портов. Лимит — 30 запросов в секунду: при превышении API возвращает ошибку 429.

Работа строится вокруг событий: message_created — новое сообщение от пользователя. Схема минимального бота на официальной JS-библиотеке (для Golang есть своя), упрощённая по примеру из статьи на Habr:

import { Bot } from '@maxhub/max-bot-api';

const bot = new Bot('ВАШ_ТОКЕН');

// событие: пользователь написал боту
bot.on('message_created', async (ctx) => {
  await ctx.reply('Приняли! Менеджер ответит в ближайшее время.');
});

bot.startPolling(); // long polling для разработки

У каждого сообщения есть идентификатор (mid) и отправитель со своим ID — по ним бот связывает диалог с конкретным клиентом. На этой паре построен кейс «бота обратной связи» с Habr: клиент пишет боту, бот пересылает сообщение админу и запоминает соответствие mid → ID клиента; админ отвечает реплаем, бот находит mid в своей базе и отправляет ответ нужному клиенту.

Как создать бота: шаги по официальной документации

Порядок в документации MAX такой:

1. Подключиться к платформе MAX для партнёров. Ограничение: подключение доступно только юрлицам, ИП и самозанятым — резидентам РФ.
2. Создать профиль организации, ИП или самозанятого: понадобятся ИНН, корпоративный телефон или почта.
3. Пройти верификацию профиля: быстрее всего — через Госуслуги (несколько минут); есть банковские способы (Alfa ID, T-Business ID) и ручная проверка документов — до 4 рабочих дней (по гайду Альбато).
4. Создать бота.
5. Пройти модерацию — после неё бот становится доступен пользователям.

На шаге создания боту назначается никнейм — его адрес в MAX. Выбрать или изменить его нельзя: платформа генерирует никнейм сама — у юрлиц и ИП по шаблону idИНН_bot, у самозанятых — se(orgid)_bot (официальный FAQ MAX). Единственный способ повлиять на никнейм — простой путь через служебного бота @MasterBot, где его выбирают сами: латиница и цифры, окончание bot или _bot, минимум 11 символов (гайд М.Видео).

После создания платформа выдаёт токен — ключ доступа к Bot API: где его взять и куда вставить, разбираем в FAQ ниже.

Модерация по данным партнёрских гайдов занимает до 48 часов в рабочие дни; лимит ботов — 5 на юрлицо или ИП и 2 на самозанятого (официальный FAQ MAX).

Без кода или с кодом

Документация MAX описывает два пути. Первый — сценарии бота без кода: конструкторы партнёров, где сценарий собирается визуально. Самый короткий старт — через служебного бота @MasterBot: команда /create создаёт бота, /set_picture задаёт аватар, /set_description — описание, /set_commands — меню команд; в финале MasterBot присылает токен доступа (гайд М.Видео).

Второй — разработка с кодом через API — то, что разобрано в разделе выше. Конструктор быстрее закрывает типовые сценарии (приветствие, меню, ответы на частые вопросы), API-путь нужен, когда бот должен быть встроен в собственную инфраструктуру — например, в CRM или бэкенд компании. Интеграции с CRM-сервисами MAX заявляет в бизнес-разделе — собираются они через партнёрские коннекторы и API (business.max.ru).

Конкретные имена: в реестре партнёров MAX — по гайду Альбато — 15 конструкторов, среди них SaleBot, Botmother и Aimylogic; актуальный список ведёт документация в разделе о ботах без кода. Для связок без программирования гайды называют интегратор Albato: готовые маршруты MAX → amoCRM и MAX → Google Таблицы.

Типовой маршрут данных при этом одинаков: клиент пишет боту → бот или конструктор передаёт событие дальше → заявка и контакт попадают в CRM или таблицу. Разница в том, кто настраивает маршрут — конструктор или ваш разработчик.

Что настроить в боте в первую очередь: четыре сценария

Не пытайтесь сразу научить бота всему. Начните с четырёх базовых сценариев — они покрывают большинство первых обращений:

• Приветствие. Одно сообщение, из которого за пять секунд понятно, что бот умеет и какая кнопка что даёт.
• Ответы на частые вопросы. 5–10 вопросов, которые звучат каждый день: график, цена, доставка, адрес, как оставить заявку. Каждый вопрос — отдельная ветка с коротким ответом.
• Сбор заявок. Имя, контакт, суть вопроса — три поля вместо десяти: чем короче форма, тем больше людей её досоздаёт.
• Передача на менеджера. Кнопка «позвать человека» и понятный маршрут: кто и когда подхватывает диалог. Клиент не должен застревать между ботом и живым ответом.

Сценарный бот или бот на базе знаний

Сценарный (кнопочный) бот отвечает по заранее собранным веткам: предсказуемо и дёшево в настройке, но ломается на первом живом вопросе вне сценария. Бот на базе знаний отвечает вольным текстом по вашему прайсу, FAQ и документам, но требует, чтобы эту базу знаний сначала собрали и поддерживали.

Практичное правило: стартуйте со сценарного бота на типовых вопросах, а AI подключайте там, где вопросы каждый день разные. И помните: даже самый умный бот не ведёт воронку — статусы, напоминания и историю клиента берёт на себя CRM.

Бот в MAX или бот в Telegram

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

• аудитория: по данным Mediascope за апрель 2026, MAX впервые стал №1 в РФ по среднесуточному охвату — 68 млн человек в день против 50,3 млн у Telegram;
• доступ: MAX работает без VPN, серверы — в РФ, данные клиентов под 152-ФЗ; Telegram в РФ ограничен Роскомнадзором;
• оплаты: в MAX заявлены нативные оплаты СБП прямо в чате, в Telegram — через сторонних ботов;
• зрелость Bot API: у Telegram экосистема ботов старше и богаче; Bot API MAX — растущий, документация ещё обновляется.

Вывод в гайде MeerBot: MAX — не замена Telegram, а дополнительный канал к растущей аудитории. Заведите один канал, второй добавьте, когда процесс заработает — связка с CRM у них общая, о ней ниже.

Как бот MAX попадает в CRM: механика Самовара

Bot API — канал общения, а не учётная система: карточки клиентов, статусы и историю сделок ведёт CRM, а не бот (как выбрать CRM под MAX и что сравнивать при выборе, мы писали отдельно). Самовар CRM соединяет мессенджеры и Twenty CRM: MAX подключается по Bot API — как бот, Telegram — через обычный пользовательский аккаунт (MTProto; подробнее — в материале про CRM для Telegram). Новый человек из диалога автоматически становится контактом в CRM, LLM пишет резюме диалога и ведёт статус клиента, а ответ клиенту отправляет менеджер — не бот. Детали механики — агрегация сообщений, вебхуки, автосинхронизация сделок — на странице «MAX для бизнеса».

При подключении Самовара мы разворачиваем Twenty CRM и коннектор за вас. Инструменты с открытым исходным кодом размещаются на вашем сервере, а диалоги анализирует наша собственная обученная модель на основе KIMI 3. Первые два месяца — бесплатно, далее 3000 ₽ в месяц.

Попробовать связку можно на главной странице Самовара — первые два месяца бесплатны. Что делать дальше — тоже разобрали: четыре уровня автоматизации продаж — путь от бота-визитки до CRM со статусами из переписки. Остальные материалы — в блоге Самовара.

Как рассказать клиентам о боте

Бот без анонса молчит — о нём нужно сказать в каждом месте, где бывает клиент:

• прямая ссылка на бота — на сайт, в подпись почты и в профили соцсетей;
• QR-код — в офисе, на визитках, упаковке и чеках: клиент сканирует — и сразу в чате;
• анонс там, где уже есть ваша аудитория: рассылка, соцсети, канал;
• точка входа в рекламе вместо формы: «Напишите нам в MAX — ответим в чате».

Ограничения и чек-лист перед запуском

Что стоит знать заранее (по официальному FAQ MAX и партнёрским гайдам):

• подключение к платформе ботов — для юрлиц, ИП и самозанятых — резидентов РФ; физлицу без статуса самозанятого создать бота не получится;
• любые правки настроек бота после модерации отправляют его на повторную проверку — имя, аватар и описание лучше утвердить до отправки; никнейм не меняется никогда;
• передать бота другому владельцу нельзя — он привязан к профилю, с которого создан;
• по умолчанию добавление бота в групповые чаты запрещено — включается в настройках, но типовой сценарий рассчитывайте на личные диалоги;
• готового переноса базы подписчиков из Telegram в MAX нет — каждую аудиторию собирают отдельно;
• платформа ботов ещё молода: перед выбором конструктора проверьте, что он поддерживает нужные связки — например, с вашей CRM.

Перед открытым запуском пройдите чек-лист:

• пройдите все ветки сценария сами — включая случайные ответы и тупики;
• проверьте граничные случаи: опечатки, длинные сообщения, несколько сообщений подряд, фото и файлы;
• убедитесь, что заявки доходят до получателя (CRM, таблица, почта) быстро и без потерь;
• сначала запустите бота на узком круге — коллеги и постоянные клиенты, потом открывайте всем.

FAQ