Создание чат бота в МАКС: инструкция по запуску в 2026

Создание чат бота в МАКС начинается с одного сценария. Определите, кто пишет боту, какое действие хочет выполнить, какие данные для этого нужны и что должно произойти при ошибке. Конструктор и токен понадобятся позже.

Дальше понадобится профиль на платформе MAX для партнеров, карточка бота, модерация и способ связать сообщения с вашей логикой. Такой порядок сейчас закреплен в официальной документации. Сценарий, интеграции и правила приемки зависят от вашего бизнеса.

Что включает создание чат бота в МАКС?

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

Второй контур принимает события из MAX и отправляет ответы. Его можно собрать через сервис-партнер или собственную интеграцию с Bot API. Сам по себе транспорт не определяет, когда записывать клиента, куда передавать обращение и какой ответ считать допустимым.

Третий контур - сценарий. В нем находятся кнопки, правила, обращения к внешним системам, передача человеку и, если она действительно нужна, нейросеть. Четвертый контур отвечает за доступы, данные, наблюдение за ошибками и изменения после запуска.

Такое разделение не дает принять созданную карточку за готовый продукт. Если один контур не проверен, создание чат бота в МАКС еще не завершено, даже когда бот уже виден в интерфейсе.

Что подготовить до создания бота?

Начните с процесса. Канал выбирайте после того, как определено действие для автоматизации. Если непонятно, какое действие стоит отдавать боту, проведите аудит процесса до выбора сценария. Результатом должен стать один повторяемый путь, у которого есть вход, ожидаемый итог и владелец со стороны бизнеса.

Для первого варианта достаточно заполнить такую карточку:

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

После карточки составьте список систем, которых касается сценарий. Это может быть расписание, база товаров, CRM или внутренняя таблица, но их не нужно подключать заранее. Сначала зафиксируйте, какое действие бот читает или записывает, кто разрешает доступ и как проверить результат без реальных данных клиента.

Отдельно назначьте владельца профиля MAX. Профиль, токен и рабочая интеграция не должны оставаться на личном аккаунте случайного исполнителя без понятного порядка передачи. Когда вы планируете создание чат бота в МАКС, решите этот вопрос до модерации. Первый сбой для передачи доступов уже слишком поздний момент.

Кто может создать бота в MAX?

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

Порядок выглядит так:

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

Точный набор полей и доступных типов профиля может меняться, поэтому не сохраняйте эту часть как внутреннюю инструкцию навсегда. Перед очередным запуском сверяйте ее с разделом помощи MAX. Само создание чат бота в МАКС начинается только после того, как нужный профиль получил доступ к разделу чат-ботов.

Когда выбирать конструктор, а когда Bot API?

MAX публикует список сервисов-партнеров, с которыми можно собирать ботов без собственного кода. Этот список изменяется. Сверяйте возможности с вашей карточкой: какие события принимает сервис, какие кнопки поддерживает, куда передает данные и как выгружаются настройки при смене исполнителя. Количество логотипов на странице ничего об этом не говорит.

Bot API дает вашей системе сообщения, события, кнопки и работу с файлами. Бизнес-логику все равно нужно описать и реализовать. API сам не подключает CRM. Правила записи и условия передачи диалога человеку задаются отдельно. Как написать такой обработчик самому, от токена до первого ответа, разобрано в статье как сделать бота на API MAX с Claude Code.

Если готовый сервис не покрывает сценарий или компания должна владеть отдельной логикой, возможен другой маршрут - реализация бота для MAX под процессы и интеграции компании. Это один из вариантов архитектуры. Инструкция не требует переходить к нему.

Для создания чат бота в МАКС можно выбрать любой из двух маршрутов. Критерий один: команда понимает, где находится логика, кому принадлежат доступы и как проверить каждую интеграцию.

Где создать бота и что проходит модерацию?

Старая цепочка с командой /create в @MasterBot не соответствует текущей официальной инструкции. Сам MasterBot существует, но действующая документация создания ведет через профиль и раздел чат-ботов. Поэтому рабочую памятку стоит строить по интерфейсу платформы. Старое сообщение в мессенджере для этого не подходит.

Порядок действий:

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

Ник формирует платформа автоматически. Текущая документация не обещает возможность выбрать или изменить его, поэтому не включайте свободный ник в критерии приемки. Если позже изменить сведения карточки, они проходят повторную модерацию и применяются после успешной проверки.

На этом этапе создание чат бота в МАКС дает рабочую карточку и доступ к настройкам. Ответы, интеграции и обработка ошибок появляются только после подключения выбранного технического маршрута.

Как получить и хранить токен?

Токен нужен вашему конструктору или обработчику, чтобы обращаться к Bot API от имени бота. Актуальная документация требует передавать его в заголовке Authorization. Параметр URL больше не поддерживается. Рабочий API использует домен platform-api2.max.ru.

Не путайте токен бота с секретом Webhook. Токен подтверждает исходящий запрос вашей системы к MAX. Отдельный Webhook secret помогает вашей системе проверить, что входящее событие пришло с ожидаемым заголовком.

Безопасная схема хранения выглядит так:

MAX_BOT_TOKEN: отдельный секрет в защищенном хранилище
MAX_WEBHOOK_SECRET: другой секрет для проверки входящих событий
Владелец доступа: назначенная роль или сотрудник
Порядок замены: где обновить секрет и какие системы перезапустить

Не копируйте рабочие значения в задачу, публичную документацию или пример кода. Для создания чат бота в МАКС достаточно описать имена секретов и порядок их замены. Реальные значения должны оставаться только в тех системах, которым они нужны.

Как бот получает события?

Webhook похож на служебное уведомление: в MAX произошло действие, и платформа отправила данные вашему обработчику. Подписка создается методом POST /subscriptions. Точка приема должна быть доступна по HTTPS с доверенным сертификатом, а обработчик должен сверять отдельный секрет из заголовка X-Max-Bot-Api-Secret до обработки события.

Long Polling работает наоборот: ваша система вызывает GET /updates и получает накопившиеся события. Ответ содержит маркер продолжения, который передается в следующий запрос. Официальная документация относит этот механизм к разработке и тестированию.

Создание чат бота в МАКС на уровне связи завершено, когда тестовое событие приходит выбранным способом, секрет проверяется, повторное событие не выполняет действие дважды, а ошибка внешней системы обрабатывается по записанному правилу.

Как собрать первый сценарий?

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

Пример нейтрального контура:

1. Бот объясняет свою задачу и показывает доступные действия.
2. Пользователь выбирает действие кнопкой или пишет сообщение.
3. Бот запрашивает только те данные, которые нужны для выбранного результата.
4. Перед записью во внешнюю систему бот показывает, что будет передано.
5. После ответа внешней системы бот сообщает результат или понятную причину, по которой действие не выполнено.
6. При непонятном вводе бот возвращает человека к доступным вариантам. Один и тот же ответ не должен повторяться бесконечно.
7. Если сценарий не может продолжиться, бот передает обращение назначенному человеку вместе с нужным контекстом.

Для кнопок заранее разделите действия. callback отправляет событие обработчику, link открывает адрес, а запрос контакта или местоположения требует явного действия пользователя. Не воспринимайте контакт и геопозицию как обычный текст: это данные, для которых нужна понятная цель и отдельная проверка.

Если сценарий отправляет файл, Bot API сначала выдает адрес загрузки, затем принимает файл и возвращает токен вложения. Объект может еще обрабатываться, поэтому обработчик должен учитывать состояние attachment.not.ready. Первая неудачная отправка еще не означает окончательный сбой.

Создание чат бота в МАКС лучше расширять по одному принятому сценарию. Так проще увидеть, какая ветка действительно нужна, и не прятать ошибку за большим меню.

Когда нужна нейросеть, а когда достаточно правил?

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

Модель можно добавить в отдельную ветку вопросов. Для нее заранее определите, из каких материалов разрешено отвечать, какие темы закрыты, какие данные нельзя передавать и что делать, если в базе нет надежного ответа. Отдельный разбор поможет собрать подготовку базы знаний для ИИ без смешения рабочих документов и случайных файлов.

Создание чат бота в МАКС с нейросетью требует отдельного компонента: Bot API передает сообщения, а выбранная модель и база знаний формируют ответ. Платформа не делает эту связку автоматически.

Как учесть контакты и другие данные?

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

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

Конкретный состав документов и мер сверяйте с фактическим сценарием и ответственным за данные в компании. Отдельная статья разбирает правила работы с персональными данными клиентов при подключении внешних моделей и систем.

Для создания чат бота в МАКС недостаточно выбрать российскую платформу или сервис. Проверьте всю цепочку: сообщение, обработчик, модель, база знаний, внешняя система, журналы ошибок и резервные копии.

Как проверить бота перед открытием пользователям?

Проводите проверку на тестовых данных, которые не относятся к реальным клиентам. Сначала убедитесь, что команда может безопасно отменить созданные записи и отличить тестовое событие от рабочего.

Порядок приемки:

1. Назначьте тесту идентификатор и владельца.
2. Запишите входные данные и ожидаемый переход до запуска теста.
3. Пройдите путь и сохраните только безопасное подтверждение результата без токенов и данных людей.
4. Зафиксируйте отличие от ожидания и систему, в которой нужна правка.
5. После изменения повторите сам тест и соседние ветки, которые используют тот же компонент.

Создание чат бота в МАКС можно считать принятым только по записанным критериям. Количество открытых экранов, сообщений или подключенных блоков само по себе готовность не доказывает.

Какие ошибки предусмотреть заранее?

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

• Ошибка доступа. Не повторяйте запрос бесконечно. Остановите действие, не показывайте пользователю секреты и отправьте событие владельцу интеграции.
• Повторное событие. Используйте идентификатор события или бизнес-действия, чтобы один вход не создавал несколько записей. Такой подход называют идемпотентностью - повтор не меняет результат второй раз.
• Файл не готов. Обработайте состояние готовности вложения и повторяйте отправку по правилу с растущим интервалом. Плотный цикл создает лишние запросы.
• Внешняя система недоступна. Не показывайте подтверждение до реального ответа системы. Предложите безопасный следующий шаг.
• В источниках модели нет подтвержденного ответа. Запретите ответ без подтвержденного источника. Верните границу темы, источник или передачу человеку.
• Человек не принял диалог. Покажите пользователю текущий статус и сохраните контекст, который нужен ответственному.

Подробная проверка ошибок чат-бота помогает отделить сбой сценария от проблемы интеграции. Создание чат бота в МАКС включает заранее описанный отказ. Успешной демонстрации для приемки недостаточно.

Что передать владельцу после запуска?

Соберите единый реестр без самих секретов:

После изменения карточки, сценария, интеграции или токена повторяйте связанные проверки. Создание чат бота в МАКС переводит проект в рабочий режим с назначенными владельцами. Проект передан, когда назначенный владелец может проверить сценарий, заменить доступ и поставить задачу на изменение по единому реестру.