ClaudeLab

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

Автоматизация бизнеса14 минобновлено 26 октября 2026 г.
Опубликовано 5 июля 2026 г.Beginner
Что вы узнаете
  • Путь от верификации профиля до модерации и получения токена
  • Выбор между сервисом-партнёром и собственной интеграцией
  • Условия Webhook и Long Polling, защита и повторная доставка событий
  • Учебная проверка статуса заказа: чужой заказ, сбой и повтор кнопки
  • Что передать владельцу бота после запуска
Новичок
110просмотров

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

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

С чего начинается создание чат бота в МАКС?

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

Те же действия доступны в мини-приложении «MAX для бизнеса». Проверка 26.10.2026: документация разрешает организации и ИП создать до пяти ботов, самозанятому - до двух. Токен храните как пароль от управления ботом. В текст статьи, снимок экрана и открытую задачу его не вставляют.

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

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

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

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

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

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

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

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

Карточку создают после того, как профиль получил доступ к разделу чат-ботов.

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

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

КритерийСервис-партнерСобственная интеграция с Bot API
ЛогикаОграничена доступными блоками и настройками сервисаОпределяется вашим обработчиком
ИнтеграцииТолько те, которые поддерживает выбранный сервисМожно связать с нужной системой через ее доступный интерфейс
ДоступыПрофиль MAX плюс учетная запись сервисаПрофиль MAX, токен и инфраструктура обработчика
ИзмененияВ интерфейсе и пределах возможностей сервисаЧерез код, конфигурацию и процесс выпуска
ПриемкаПроверка сценария внутри готового контураПроверка сценария, API, внешних систем и обработки ошибок
ВладениеНужно заранее проверить экспорт и передачу настроекНужно владеть кодом, секретами, журналами ошибок и развертыванием

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

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

Ниже создание чат бота в МАКС разобрано по действиям владельца профиля:

  1. Откройте верифицированный профиль на платформе MAX для партнеров.
  2. Перейдите в раздел чат-ботов и выберите создание новой карточки.
  3. Добавьте логотип 500х500 пикселей, до 5 Мб, в формате jpg/jpeg/png. Укажите название длиной 1-59 символов без эмодзи и описание до 200 символов. Контакты при необходимости можно включить в описание; отдельного поля для них нет.
  4. Проверьте карточку от имени владельца бизнеса и отправьте ее на модерацию.
  5. Следите за статусами «На модерации», «Опубликован», «Нужны исправления». Проверка занимает до 48 часов по рабочим дням. В статусе «На модерации» настройки изменить нельзя.
  6. После успешной проверки выберите бота в разделе «Чат-боты», нажмите «⋮ → Настройки» и значок копирования справа от поля токена.

Ник формирует платформа автоматически: 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 и получает накопившиеся события. Ответ содержит маркер продолжения, который передается в следующий запрос. Официальная документация относит этот механизм к разработке и тестированию.

ВопросWebhookLong Polling
Кто начинает обменMAX отправляет событие обработчикуОбработчик запрашивает новые события
Основное применениеРабочая интеграцияРазработка и проверка
Что нужноДоступный HTTPS-адрес и проверка secretПроцесс, который регулярно запрашивает обновления и хранит marker
СовместимостьПри активной подписке отключает Long PollingНе работает при активном Webhook
Основной рискПринять неподтвержденный или повторный запросПотерять marker или остановить процесс запросов

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

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

Чтобы создание чат бота в МАКС завершилось проверяемым сценарием, опишите переходы:

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

Для кнопок заранее разделите действия. 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 требуют уведомлять пользователя о получении персональных данных и принимать меры их защиты. Платформа также перечисляет сведения и документы, которые разработчик должен довести до пользователя. Типовой текст политики нельзя считать подходящим автоматически, если реальная обработка устроена иначе.

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

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

ПроверкаДействиеОжидаемый результат
Первый входОткрыть бота без историиПонятна задача бота и доступен следующий шаг
Основной путьПройти сценарий с корректными даннымиРезультат совпадает с карточкой приемки
Непонятный вводОтправить сообщение вне ожидаемой веткиБот объясняет доступные действия или передает вопрос человеку
Отказ от данныхНе передавать контакт или местоположениеСценарий не зависает и показывает допустимый следующий шаг
Повторное событиеПовторить кнопку или отправкуОдно бизнес-действие не выполняется дважды
Сбой интеграцииСделать внешнюю систему недоступной в тестовом контуреБот не сообщает ложный успех и фиксирует ошибку для владельца
Передача человекуЗапросить помощь на разных шагахОтветственный получает нужный контекст, пользователь понимает статус обращения
Смена токенаОбновить тестовый секретСтарое значение перестает использоваться, новое подключено во всех системах

За создание чат бота в МАКС и его приёмку отвечают разные роли. Порядок проверки:

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

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

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

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

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

ОбъектКто владеетЧто должно быть записано
Профиль MAXПредставитель бизнесаСвязанный аккаунт, роли и порядок смены владельца
Карточка ботаВладелец каналаНазвание, описание, материалы и статус модерации
Токен и Webhook secretВладелец интеграцииМесто хранения, роли доступа и порядок замены без значений секретов
Конструктор или кодТехнический владелецГде находится логика, как выпускается изменение и как откатить ошибку
Внешние системыВладельцы нужных процессовКакие действия читает и записывает бот
Сценарии приемкиВладелец процессаВходы, ожидаемые результаты и тестовые данные
Карта данныхОтветственный за данныеЦели, хранилища, передачи, доступы и удаление
Ошибки и измененияНазначенная рольГде смотреть сигнал, кто исправляет и кто принимает результат

Где вы сейчас

  • Профиля ещё нет. Начните с проверки статуса владельца и верификации на платформе MAX для партнёров.
  • Бот прошёл модерацию. Получите токен безопасным способом и подключите один описанный сценарий.
  • Сценарий отвечает на тестовый вопрос. Проверьте чужой заказ, повтор события и недоступность внешней системы.
  • Нужны CRM и отдельная логика. Подготовьте карточку процесса для аудита на странице услуги бота для MAX.

Чек-лист перед открытием бота пользователям

  • Профиль верифицирован, бот прошёл модерацию, доступы принадлежат назначенному владельцу.
  • Токен и секрет входящих событий хранятся безопасно и не включены в открытые материалы.
  • Описан один основной сценарий с ожидаемыми ответами и изменениями данных.
  • Проверены права пользователя: знание номера заказа не раскрывает чужие сведения.
  • Повтор события не создаёт повторное действие, ошибка внешней системы не выдаётся за успех.
  • Доступна передача сотруднику с нужным контекстом и понятным статусом для пользователя.
  • Владельцу переданы настройки, порядок смены доступов и критерии повторной проверки.

Источники

Частые вопросы

По документации MAX на 26.10.2026 подключение доступно организациям, ИП и самозанятым, которые являются резидентами РФ. Нужен верифицированный профиль на платформе для партнёров. Для организации или ИП указан предел в пять ботов, для самозанятого - два; перед запуском сверьте требования.
Максим Самусь
Автор
Основатель ClaudeLab

Десять лет в маркетинге: агентства, продвижение услуг, трафик из таргета и контекста. Весной 2026 взял в руки Claude Code и собрал первый собственный продукт и систему ИИ-агентов под свои задачи. С тех пор строит на этом агентство - сайты, автоматизацию и заказную разработку для бизнеса. Пишет о том, что делает сам: разбирает задачи, которые проходит на своих проектах и проектах клиентов. Свои продукты - Photogenia, нейрофотосессии с сайтом и Telegram-ботом, и Reachen, сервис генерации рекламных креативов. Ведёт Telegram-канал о Claude Code и нейросетях для бизнеса - @ai_smart_usage.

Эта статья была полезна?

Похожие статьи

Распознавание накладных нейросетью: УПД, ТОРГ-12 и как проверить результат

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

11 мин

Нейросеть для составления сметы: что делает сама и что проверять руками

Разбираем, что нейросеть для составления сметы делает сама: раскладывает работы по строкам и берёт цены из вашего прайса. Даём запрос с запретами, восемь проверок итога, учебный пример с условными числами и порядок встраивания расчёта в CRM.

10 мин

Лимиты DeepSeek: достигнут лимит в Дипсике - что делать

Лимиты DeepSeek: что делать, если Дипсик пишет «достигнут лимит», как перенести задачу в новый чат и отличить перегрузку от ограничения API. Таблица ошибок, подтверждённые квоты и цены API. Официальные источники проверены 2 ноября 2026 года.

11 мин

Лимиты ChatGPT в 2026: что ограничено в Free, Go, Plus и Pro

Разберите лимиты ChatGPT по тарифам Free, Go, Plus и Pro: что безлимитно, что считается отдельно, сколько файлов и часов голоса подтверждает справка OpenAI, где смотреть время сброса и почему поддержка лимит не обнуляет. Данные на 19 ноября 2026.

14 мин

Самое читаемое за 7 дней

  1. Лимиты DeepSeek: достигнут лимит в Дипсике - что делать
    Нейросети для бизнеса448 просмотров
  2. Лимиты Gemini: бесплатный доступ, подписки и цена API
    Нейросети для бизнеса94 просмотра