Создание чат бота в МАКС начинается с одного сценария. Определите, кто пишет боту, какое действие хочет выполнить, какие данные для этого нужны и что должно произойти при ошибке. Конструктор и токен понадобятся позже.
Дальше понадобится профиль на платформе MAX для партнеров, карточка бота, модерация и способ связать сообщения с вашей логикой. Такой порядок сейчас закреплен в официальной документации. Сценарий, интеграции и правила приемки зависят от вашего бизнеса.
С чего начинается создание чат бота в МАКС?
- Создать и верифицировать профиль организации, ИП или самозанятого - резидента РФ.
- Открыть «Чат-боты» на платформе MAX для партнёров и нажать «Создать».
- Заполнить карточку и отправить бота на модерацию.
- После успешной модерации получить токен в настройках и подключить сценарий.
- Проверить сценарий, ошибки и передачу вопроса человеку, затем открыть его пользователям.
Те же действия доступны в мини-приложении «MAX для бизнеса». Проверка 26.10.2026: документация разрешает организации и ИП создать до пяти ботов, самозанятому - до двух. Токен храните как пароль от управления ботом. В текст статьи, снимок экрана и открытую задачу его не вставляют.
Что подготовить до создания бота?
Для первого варианта достаточно заполнить такую карточку:
Кто пользуется ботом:
Какое событие начинает диалог:
Какой результат должен получить человек:
Какие данные нужны для этого результата:
Какие ответы задаются жесткими правилами:
Когда вопрос передается человеку:
Какие ошибки и отказы нужно обработать:
Кто принимает готовый сценарий:
Кто хранит доступы и меняет настройки:Если создание чат бота в МАКС затрагивает несколько систем, составьте их список. После карточки составьте их список. Это может быть расписание, база товаров, CRM или внутренняя таблица, но их не нужно подключать заранее. Сначала зафиксируйте, какое действие бот читает или записывает, кто разрешает доступ и как проверить результат без реальных данных клиента.
Отдельно назначьте владельца профиля MAX. Профиль, токен и рабочая интеграция не должны оставаться на личном аккаунте случайного исполнителя без понятного порядка передачи. Пока идёт создание чат бота в МАКС, решите вопрос владения до модерации.
Кто может создать бота в MAX?
Порядок выглядит так:
- Зарегистрируйте аккаунт MAX, который будет связан с рабочим профилем.
- Создайте профиль на платформе MAX для партнеров и выберите подходящий тип владельца.
- Заполните запрошенные сведения и пройдите верификацию через Госуслуги по инструкции платформы.
- После подтверждения откройте раздел с чат-ботами и создайте карточку.
Карточку создают после того, как профиль получил доступ к разделу чат-ботов.
Когда выбирать конструктор, а когда Bot API?
Bot API дает вашей системе сообщения, события, кнопки и работу с файлами. Бизнес-логику все равно нужно описать и реализовать. API сам не подключает CRM. Правила записи и условия передачи диалога человеку задаются отдельно. Как написать такой обработчик самому, от токена до первого ответа, разобрано в статье как сделать бота на API MAX с Claude Code.
| Критерий | Сервис-партнер | Собственная интеграция с Bot API |
|---|---|---|
| Логика | Ограничена доступными блоками и настройками сервиса | Определяется вашим обработчиком |
| Интеграции | Только те, которые поддерживает выбранный сервис | Можно связать с нужной системой через ее доступный интерфейс |
| Доступы | Профиль MAX плюс учетная запись сервиса | Профиль MAX, токен и инфраструктура обработчика |
| Изменения | В интерфейсе и пределах возможностей сервиса | Через код, конфигурацию и процесс выпуска |
| Приемка | Проверка сценария внутри готового контура | Проверка сценария, API, внешних систем и обработки ошибок |
| Владение | Нужно заранее проверить экспорт и передачу настроек | Нужно владеть кодом, секретами, журналами ошибок и развертыванием |
Если готовый сервис не покрывает сценарий или компания должна владеть отдельной логикой, возможен другой маршрут - реализация бота для MAX под процессы и интеграции компании. На странице можно оставить заявку на аудит сценария и нужных интеграций. Для обсуждения достаточно описания процесса, без токенов и сведений реальных клиентов.
Где создать бота и что проходит модерацию?
Ниже создание чат бота в МАКС разобрано по действиям владельца профиля:
- Откройте верифицированный профиль на платформе MAX для партнеров.
- Перейдите в раздел чат-ботов и выберите создание новой карточки.
- Добавьте логотип 500х500 пикселей, до 5 Мб, в формате jpg/jpeg/png. Укажите название длиной 1-59 символов без эмодзи и описание до 200 символов. Контакты при необходимости можно включить в описание; отдельного поля для них нет.
- Проверьте карточку от имени владельца бизнеса и отправьте ее на модерацию.
- Следите за статусами «На модерации», «Опубликован», «Нужны исправления». Проверка занимает до 48 часов по рабочим дням. В статусе «На модерации» настройки изменить нельзя.
- После успешной проверки выберите бота в разделе «Чат-боты», нажмите «⋮ → Настройки» и значок копирования справа от поля токена.
Ник формирует платформа автоматически: idИНН_bot для организации и ИП, se(orgid)_bot для самозанятого. Текущая документация не обещает возможность выбрать или изменить его, поэтому не включайте свободный ник в критерии приемки. Если позже изменить сведения карточки, они проходят повторную модерацию и применяются после успешной проверки.
Как получить и хранить токен?
В запросах к platform-api2.max.ru передавайте токен заголовком Authorization; query-параметр больше не поддерживается.
Не путайте токен бота с секретом Webhook. Токен подтверждает исходящий запрос вашей системы к MAX. Отдельный Webhook secret помогает вашей системе проверить, что входящее событие пришло с ожидаемым заголовком.
Если создание чат бота в МАКС выполняет подрядчик, заранее согласуйте хранение доступов:
MAX_BOT_TOKEN: отдельный секрет в защищенном хранилище
MAX_WEBHOOK_SECRET: другой секрет для проверки входящих событий
Владелец доступа: назначенная роль или сотрудник
Порядок замены: где обновить секрет и какие системы перезапуститьНе копируйте рабочие значения в задачу, публичную документацию или пример кода.
Как бот получает события?
Адрес обработчика должен работать по HTTPS на порту 443 и возвращать HTTP 200 в течение 30 секунд. При ошибке MAX делает до 10 повторных попыток; если успешного ответа нет 8 часов, подписка снимается. Поэтому повтор события не должен повторять бизнес-действие. Эти условия приведены в документации Webhook.
Long Polling работает наоборот: ваша система вызывает GET /updates и получает накопившиеся события. Ответ содержит маркер продолжения, который передается в следующий запрос. Официальная документация относит этот механизм к разработке и тестированию.
| Вопрос | Webhook | Long Polling |
|---|---|---|
| Кто начинает обмен | MAX отправляет событие обработчику | Обработчик запрашивает новые события |
| Основное применение | Рабочая интеграция | Разработка и проверка |
| Что нужно | Доступный HTTPS-адрес и проверка secret | Процесс, который регулярно запрашивает обновления и хранит marker |
| Совместимость | При активной подписке отключает Long Polling | Не работает при активном Webhook |
| Основной риск | Принять неподтвержденный или повторный запрос | Потерять marker или остановить процесс запросов |
На этапе связи создание чат бота в МАКС можно принять, когда тестовое событие приходит выбранным способом, секрет проверяется, повторное событие не выполняет действие дважды, а ошибка внешней системы обрабатывается по записанному правилу.
Как собрать первый сценарий?
Чтобы создание чат бота в МАКС завершилось проверяемым сценарием, опишите переходы:
- Бот объясняет свою задачу и показывает доступные действия.
- Пользователь выбирает действие кнопкой или пишет сообщение.
- Бот запрашивает только те данные, которые нужны для выбранного результата.
- Перед записью во внешнюю систему бот показывает, что будет передано.
- После ответа внешней системы бот сообщает результат или понятную причину, по которой действие не выполнено.
- При непонятном вводе бот возвращает человека к доступным вариантам. Один и тот же ответ не должен повторяться бесконечно.
- Если сценарий не может продолжиться, бот передает обращение назначенному человеку вместе с нужным контекстом.
Для кнопок заранее разделите действия. callback отправляет событие обработчику, link открывает адрес, а запрос контакта или местоположения требует явного действия пользователя. Не воспринимайте контакт и геопозицию как обычный текст: это данные, для которых нужна понятная цель и отдельная проверка.
Если сценарий отправляет файл, Bot API сначала выдает адрес загрузки, затем принимает файл и возвращает токен вложения. Объект может еще обрабатываться, поэтому обработчик должен учитывать состояние attachment.not.ready. Первая неудачная отправка еще не означает окончательный сбой.
Учебный пример: бот сообщает статус заказа
Заказ DEMO-101: собирается
Заказ DEMO-102: передан в доставку
Пользователь DEMO-A имеет доступ только к DEMO-101Путь пользователя: открыть бота, выбрать «Статус заказа», ввести номер, получить разрешённый статус. Проверка принадлежности заказа выполняется вашей системой. Знание номера само по себе не даёт права получить чужие сведения.
| Вход в учебной проверке | Ожидаемый ответ или действие |
|---|---|
| DEMO-A запрашивает DEMO-101 | «Заказ собирается» |
| DEMO-A запрашивает DEMO-102 | Общий ответ об отсутствии доступного заказа, без чужого статуса |
| Номер не найден | Пояснение и возможность обратиться к сотруднику |
| Система заказов не отвечает | Сообщение о временной недоступности, без выдуманного статуса |
| Повторное нажатие кнопки | Нет повторного создания обращения |
Этот сценарий получает статус из системы заказов. Нейросеть для него не обязательна. Для первого запуска такая проверяемая задача удобнее свободного диалога обо всём. Отдельная база знаний для ИИ понадобится, если позже добавите ответы по документам компании.
Когда нужна нейросеть, а когда достаточно правил?
Модель можно добавить в отдельную ветку вопросов. Для нее заранее определите, из каких материалов разрешено отвечать, какие темы закрыты, какие данные нельзя передавать и что делать, если в базе нет надежного ответа. Действующие рабочие документы храните отдельно от черновиков и случайных файлов.
| Ситуация | Правила и кнопки | Нейросеть с базой знаний |
|---|---|---|
| Действие заранее известно | Основной вариант | Обычно не требуется |
| Нужен точный переход во внешней системе | Проверяемое правило | Только как помощник до подтверждения действия |
| Вопрос задан свободным текстом | Список тем и переход к человеку | Ответ в заданных границах |
| Источника ответа нет | Явное сообщение и следующий шаг | Отказ от догадки и передача человеку |
| Требуется приемка | Набор входов и ожидаемых переходов | Набор вопросов, источников, запрещенных тем и сценариев отказа |
Если создание чат бота в МАКС включает ответы нейросети, нужен отдельный компонент: Bot API передает сообщения, а выбранная модель и база знаний формируют ответ. Платформа не делает эту связку автоматически.
Как учесть контакты и другие данные?
| Поле карты | Что зафиксировать |
|---|---|
| Данные | Что приходит из профиля, сообщения, кнопки или внешней системы |
| Цель | Какое действие пользователя без этого поля невозможно |
| Хранилище | MAX, конструктор, сервер, CRM или другая система |
| Доступ | Кто и какой компонент читает или изменяет поле |
| Передача | Куда данные уходят после события |
| Исправление и удаление | Кто обрабатывает запрос и в каких системах меняет запись |
| Контроль | Как тестировщик подтверждает фактический маршрут |
Правила MAX требуют уведомлять пользователя о получении персональных данных и принимать меры их защиты. Платформа также перечисляет сведения и документы, которые разработчик должен довести до пользователя. Типовой текст политики нельзя считать подходящим автоматически, если реальная обработка устроена иначе.
Конкретный состав документов и мер сверяйте с фактическим сценарием и ответственным за данные в компании. Отдельная статья разбирает правила работы с персональными данными клиентов при подключении внешних моделей и систем.
Как проверить бота перед открытием пользователям?
| Проверка | Действие | Ожидаемый результат |
|---|---|---|
| Первый вход | Открыть бота без истории | Понятна задача бота и доступен следующий шаг |
| Основной путь | Пройти сценарий с корректными данными | Результат совпадает с карточкой приемки |
| Непонятный ввод | Отправить сообщение вне ожидаемой ветки | Бот объясняет доступные действия или передает вопрос человеку |
| Отказ от данных | Не передавать контакт или местоположение | Сценарий не зависает и показывает допустимый следующий шаг |
| Повторное событие | Повторить кнопку или отправку | Одно бизнес-действие не выполняется дважды |
| Сбой интеграции | Сделать внешнюю систему недоступной в тестовом контуре | Бот не сообщает ложный успех и фиксирует ошибку для владельца |
| Передача человеку | Запросить помощь на разных шагах | Ответственный получает нужный контекст, пользователь понимает статус обращения |
| Смена токена | Обновить тестовый секрет | Старое значение перестает использоваться, новое подключено во всех системах |
За создание чат бота в МАКС и его приёмку отвечают разные роли. Порядок проверки:
- Назначьте тесту идентификатор и владельца.
- Запишите входные данные и ожидаемый переход до запуска теста.
- Пройдите путь и сохраните только безопасное подтверждение результата без токенов и данных людей.
- Зафиксируйте отличие от ожидания и систему, в которой нужна правка.
- После изменения повторите сам тест и соседние ветки, которые используют тот же компонент.
Какие ошибки предусмотреть заранее?
- Ошибка доступа. Не повторяйте запрос бесконечно. Остановите действие, не показывайте пользователю секреты и отправьте событие владельцу интеграции.
- Повторное событие. Используйте идентификатор события или бизнес-действия, чтобы один вход не создавал несколько записей. Такой подход называют идемпотентностью - повтор не меняет результат второй раз.
- Файл не готов. Обработайте состояние готовности вложения и повторяйте отправку по правилу с растущим интервалом. Плотный цикл создает лишние запросы.
- Внешняя система недоступна. Не показывайте подтверждение до реального ответа системы. Предложите безопасный следующий шаг.
- В источниках модели нет подтвержденного ответа. Запретите ответ без подтвержденного источника. Верните границу темы, источник или передачу человеку.
- Человек не принял диалог. Покажите пользователю текущий статус и сохраните контекст, который нужен ответственному.
Подробная проверка ошибок чат-бота помогает отделить сбой сценария от проблемы интеграции. Заранее опишите поведение при отказе. Успешной демонстрации для приемки недостаточно.
Что передать владельцу после запуска?
| Объект | Кто владеет | Что должно быть записано |
|---|---|---|
| Профиль MAX | Представитель бизнеса | Связанный аккаунт, роли и порядок смены владельца |
| Карточка бота | Владелец канала | Название, описание, материалы и статус модерации |
| Токен и Webhook secret | Владелец интеграции | Место хранения, роли доступа и порядок замены без значений секретов |
| Конструктор или код | Технический владелец | Где находится логика, как выпускается изменение и как откатить ошибку |
| Внешние системы | Владельцы нужных процессов | Какие действия читает и записывает бот |
| Сценарии приемки | Владелец процесса | Входы, ожидаемые результаты и тестовые данные |
| Карта данных | Ответственный за данные | Цели, хранилища, передачи, доступы и удаление |
| Ошибки и изменения | Назначенная роль | Где смотреть сигнал, кто исправляет и кто принимает результат |
Где вы сейчас
- Профиля ещё нет. Начните с проверки статуса владельца и верификации на платформе MAX для партнёров.
- Бот прошёл модерацию. Получите токен безопасным способом и подключите один описанный сценарий.
- Сценарий отвечает на тестовый вопрос. Проверьте чужой заказ, повтор события и недоступность внешней системы.
- Нужны CRM и отдельная логика. Подготовьте карточку процесса для аудита на странице услуги бота для MAX.
Чек-лист перед открытием бота пользователям
- Профиль верифицирован, бот прошёл модерацию, доступы принадлежат назначенному владельцу.
- Токен и секрет входящих событий хранятся безопасно и не включены в открытые материалы.
- Описан один основной сценарий с ожидаемыми ответами и изменениями данных.
- Проверены права пользователя: знание номера заказа не раскрывает чужие сведения.
- Повтор события не создаёт повторное действие, ошибка внешней системы не выдаётся за успех.
- Доступна передача сотруднику с нужным контекстом и понятным статусом для пользователя.
- Владельцу переданы настройки, порядок смены доступов и критерии повторной проверки.
Источники
- Создание и модерация чат-бота - документация MAX
- Управление ботом и токеном - документация MAX
- Создание и верификация профиля - помощь MAX
- FAQ по чат-ботам - помощь MAX
- Подготовка к работе с Bot API - документация MAX
- Общая документация Bot API MAX
- Webhook и проверка secret - документация MAX
- Long Polling и получение обновлений - документация MAX
- Отправка сообщений и кнопок - документация MAX
- Загрузка изображений и файлов - документация MAX
- Сервисы-партнеры для чат-ботов - документация MAX
- Правила размещения для разработчиков - документация MAX
- Требования к содержанию и функциональности - документация MAX
- Типовая политика обработки данных - документация MAX
Материал журнала ClaudeLab. Порядок создания и требования API сверены с документацией MAX 26.10.2026. Живое создание бота, модерация и работа интеграции в этой подготовке не выполнялись.