Как создать бота в MAX и подключить его к каналу

Создать собственного чат-бота в MAX сейчас можно через платформу MAX для партнёров или мини-приложение «MAX для бизнеса». Для этого нужен верифицированный профиль организации, ИП или самозанятого, соответствующего текущим требованиям платформы. Обычное физическое лицо без подходящего статуса собственного бота создать не может.

После заполнения карточки бот отправляется на модерацию. Проверка может занимать до 48 часов по рабочим дням. После успешной проверки становятся доступны расширенные настройки и токен. Затем бот настраивается через конструктор без кода или через MAX API. Чтобы подключить его к каналу, сначала нужно разрешить добавление бота в групповые чаты, затем добавить его в канал и при необходимости назначить администратором с нужными правами.

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

Официальный MAX позволяет создавать чат-ботов через верифицированные профили:

• · Организаций;
• · Индивидуальных предпринимателей;
• · Самозанятых.

Платформа MAX для партнёров указывает дополнительные требования к резидентству РФ. Обычный личный аккаунт без соответствующего статуса сейчас не может зарегистрировать собственного чат-бота.

Сколько ботов можно создать

Текущие лимиты зависят от профиля.

Тип профиля	Количество ботов
Организация	До 5
ИП	До 5
Самозанятый	До 2

Каждый бот создаётся и проходит модерацию отдельно.

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

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

Понадобятся:

• · Верифицированный профиль MAX для партнёров;
• · Название;
• · Логотип;
• · Короткое описание;
• · Понимание задачи бота;
• · При необходимости — сайт и телефон;
• · Выбор способа разработки: конструктор или API.

Перед созданием ответьте:

Что конкретно должен делать бот после запуска?

Например: отвечать на FAQ, принимать заявки, публиковать посты, модерировать комментарии, передавать обращения оператору или запускать мини-приложение.

Как создать бота в MAX пошагово

Шаг 1. Откройте MAX для партнёров

Перейдите в свой верифицированный профиль. Создавать и редактировать чат-бота можно также через мини-приложение «MAX для бизнеса» — официальный MAX указывает, что основные шаги совпадают.

Шаг 2. Перейдите в «Чат-боты»

Откройте:

Чат-боты → Создать

Если у вас уже есть бот и нужен ещё один, используйте переключатель текущего бота и добавление нового.

Шаг 3. Заполните карточку

Загрузите логотип, укажите название и описание. Телефон и сайт заполняются при необходимости.

Ник сейчас создаётся платформой автоматически.

Шаг 4. Перепроверьте данные

Проверьте название, логотип, описание, контакты и соответствие реальной деятельности. Пока бот находится в статусе «на модерации», изменить настройки нельзя.

Шаг 5. Нажмите «Создать»

Бот отправится на модерацию. Уведомления о статусе приходят через MAX для бизнеса.

Как заполнить карточку бота

Логотип

Требования официальной документации:

• · 500 × 500 px;
• · Соотношение 1
  ;
• · До 5 МБ;
• · JPG, JPEG или PNG.

Не используйте чужую айдентику или данные другой компании.

Название

Требования:

• · От 1 до 59 символов;
• · Латиница, кириллица и цифры;
• · Эмодзи не поддерживаются.

Название должно быстро объяснять назначение.

Example Поддержка

понятнее, чем:

Assistant 4

Описание

Лимит — до 200 символов.

Укажите, что бот делает и чем полезен.

Бот Example помогает проверить статус заказа, найти нужную услугу и связаться с поддержкой.

Телефон и сайт

Эти поля необязательные. Сайт должен начинаться с https://, а требования к номеру телефона нужно проверять по актуальной карточке MAX для партнёров.

Если контакт должен быть виден пользователю прямо в профиле, имеет смысл продублировать его в описании.

Какой ник получает бот

Сейчас MAX генерирует ник автоматически.

Для организации или ИП используется шаблон на основе ИНН:

idИНН_bot

Для самозанятого — шаблон на основе идентификатора профиля:

se(orgid)_bot

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

После создания появляется публичная ссылка вида:

max.ru/<ник_бота>

Ею можно делиться напрямую или через QR-код.

Сколько длится модерация

После создания бот получает статус «на модерации». Проверка может занимать до 48 часов по рабочим дням.

Статус	Что означает
На модерации	MAX проверяет карточку
Создан	Проверка пройдена
Требует исправлений	Нужно устранить замечания и отправить повторно

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

Что появляется после модерации

После успешной проверки становятся доступны:

• · Расширенные настройки;
• · Токен;
• · Настройка сценариев;
• · Интеграции партнёров;
• · Подключение мини-приложения;
• · Разрешение или запрет добавления бота в групповые чаты и каналы.

Созданный бот ещё не становится автоматически «умным». Логику нужно настроить отдельно.

Как получить токен бота MAX

После модерации откройте:

Чат-боты → Перейти → Расширенные настройки → Настроить

Токен находится в отдельном поле.

Он нужен для:

• · MAX API;
• · Конструктора ботов;
• · CRM;
• · Чат-платформы поддержки;
• · Других поддерживаемых интеграций.

Что делать при утечке токена

Обновите токен в расширенных настройках, затем:

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

Как создать бота без программирования

MAX официально поддерживает интеграции с конструкторами и сервисами партнёров.

Без кода можно собрать:

• · Меню;
• · FAQ;
• · Формы;
• · Сбор заявок;
• · Простые воронки;
• · Передачу диалога оператору;
• · Базовые автоматизации.

Схема:

1. Создайте и промодерируйте бота.
2. Получите токен.
3. Выберите сервис в актуальном каталоге интеграций MAX.
4. Подключите токен через защищённое поле.
5. Соберите сценарий.
6. Проверьте его на тестовом аккаунте.

Как настроить бота через API

Для собственной логики используйте MAX API.

Актуальный базовый домен:

https://platform-api2.max.ru

Токен передаётся в заголовке:

Authorization: <token>

Передача access token через query-параметры больше не поддерживается.

Пример:

curl -X GET "https://platform-api2.max.ru/me" \
  -H "Authorization: <TOKEN>"

В production храните токен в переменной окружения или secret manager.

Какой лимит запросов у MAX API

Официальная документация рекомендует для стабильной работы не превышать 30 запросов в секунду к platform-api2.max.ru.

При 429 нужно снижать частоту и использовать задержку повторных запросов.

Полезно заранее реализовать:

• · Rate limiting;
• · Очередь запросов;
• · Backoff;
• · Обработку временных ошибок;
• · Логирование кодов ответа.

Webhook или Long Polling

MAX поддерживает оба механизма, но для production рекомендует Webhook.

Webhook

MAX сам отправляет HTTPS POST на ваш endpoint при событии.

Например:

https://example.com/webhook

Актуальные требования включают:

• · HTTPS;
• · Порт 443;
• · Доверенный TLS-сертификат;
• · Отсутствие самоподписанного сертификата;
• · Ответ HTTP 200 в течение 30 секунд.

При создании подписки можно передать secret и затем проверять заголовок X-Max-Bot-Api-Secret.

Long Polling

Long Polling можно использовать в разработке и тестировании, но официальная документация говорит, что этот способ ограничен по скорости и сроку хранения событий и не подходит для production.

Для рабочего публичного бота закладывайте Webhook как основной механизм.

Как подписаться на события

Используется:

POST /subscriptions

Пример:

curl -X POST "https://platform-api2.max.ru/subscriptions" \
  -H "Authorization: <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhook",
    "update_types": ["message_created", "bot_started"],
    "secret": "your_secret"
  }'

Секрет из примера использовать не нужно — сгенерируйте свой.

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

Одного токена недостаточно. Бот должен быть добавлен в канал и получить нужные права.

Схема:

разрешить добавление → добавить в канал → назначить администратором → выбрать права → протестировать.

Шаг 1. Разрешите добавление бота в канал

После модерации откройте:

Чат-боты → нужный бот → Расширенные настройки → Настроить

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

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

По умолчанию у нового бота установлен запрет.

Шаг 2. Добавьте бота в канал как участника

Перед назначением администратором бот должен присутствовать в канале как участник / подписчик.

Если бот не появляется среди кандидатов на роль администратора, проверьте:

• · Завершена ли модерация;
• · Включено ли разрешение добавления;
• · Того ли бота вы добавляете;
• · Является ли бот участником / подписчиком канала.

Шаг 3. Назначьте бота администратором

В интерфейсе канала:

1. Откройте канал.
2. Нажмите на его название.
3. Перейдите в «Администраторы».
4. Нажмите «Добавить администратора».
5. Выберите бота.
6. Укажите необходимые права.
7. Подтвердите.

Для обычного канала MAX поддерживает до 50 администраторов.

Какие права дать боту

Не выдавайте все права «на всякий случай».

Задача	Обычно нужен доступ
Публиковать посты	write
Читать доступные администратору события/сообщения	read_all_messages
Редактировать посты и комментарии	edit
Удалять посты и комментарии	delete
Управлять участниками	Только соответствующее право при необходимости
Назначать администраторов	add_admins только для специального сценария

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

Для автопостинга

Обычно достаточно write. Если сервис должен менять опубликованный материал, понадобится edit.

Для модерации комментариев

Официальный MAX приводит сценарий с набором:

• · read_all_messages;
• · edit;
• · write;
• · delete.

Почему не нужно выдавать add_admins

Если бот только публикует, ему не нужно управлять администраторами.

Принцип: только минимальные права, без которых сценарий не работает.

Как получить ID канала

Для API-сценариев нужен chat_id.

Актуальная документация MAX указывает, что для чата или канала ID можно получить из объекта Update, который приходит через Webhook или Long Polling — например, после добавления бота.

Практический сценарий:

1. Настройте Webhook.
2. Добавьте бота в канал.
3. Получите событие.
4. Извлеките chat_id.
5. Сохраните его в конфигурации.

Не пытайтесь вычислять ID по названию или публичной ссылке канала.

Как проверить, что бот подключён правильно

Не ограничивайтесь тем, что бот появился в списке администраторов.

Для бота-публикатора

• · Отправьте тестовый пост;
• · Проверьте текст;
• · Проверьте вложение;
• · Попробуйте редактирование, если оно нужно;
• · Удалите тестовый материал.

Для бота-модератора

• · Оставьте тестовый комментарий;
• · Проверьте получение события;
• · Убедитесь, что правило срабатывает;
• · Не тестируйте удаление на важной реальной ветке.

Для бота поддержки

• · Запустите его с обычного аккаунта;
• · Пройдите сценарий полностью;
• · Проверьте тупиковые ветки;
• · Проверьте передачу оператору.

Как бот публикует посты в канал

После добавления и выдачи права публикации бот может отправлять материалы через MAX API.

Поддерживаются:

• · Текст;
• · Изображения;
• · Видео;
• · Аудио;
• · Файлы;
• · Форматирование;
• · Кнопки;
• · Редактирование;
• · Удаление.

Для отдельной технической работы с публикациями используйте как публиковать посты в MAX.

Можно ли модерировать комментарии ботом

Да. MAX официально описывает сценарий модерации комментариев через API.

Логика может выглядеть так:

новый комментарий → Webhook → проверка правила → оставить / обработать / удалить.

Бот может проверять:

• · Стоп-слова;
• · Подозрительные ссылки;
• · Повторяющийся спам;
• · Частоту сообщений;
• · Собственные правила проекта.

Автоматическая модерация не должна путать негативную обратную связь с нарушением.

Для ручной настройки и правил используйте комментарии в канале MAX.

Можно ли сделать бота для автопостинга

Да.

Архитектура может быть такой:

CMS → очередь → MAX API → канал.

Бот способен:

• · Публиковать готовые материалы;
• · Загружать медиа;
• · Редактировать свои публикации;
• · Удалять ошибочные материалы;
• · Получать контент из внешней CMS;
• · Реагировать на события других систем.

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

Бот оправдан, когда нужна именно автоматизация логики, а не просто расписание.

Можно ли подключить мини-приложение

Да. После успешной модерации в расширенных настройках можно указать URL мини-приложения и настроить кнопку запуска.

Мини-приложение подходит для:

• · Каталога;
• · Оформления заказа;
• · Личного кабинета;
• · Формы;
• · Игры;
• · Сервисного интерфейса.

Бот остаётся точкой входа в такой сценарий.

Можно ли изменить название и описание после запуска

Да, но через MAX для партнёров, а не прямо в мессенджере.

Можно менять название, аватар, описание и другие доступные поля. Ник сейчас изменить нельзя.

После изменения карточка снова отправляется на модерацию, а до её завершения пользователи видят прежнюю одобренную версию.

Можно ли сделать бота непубличным

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

Поэтому не стройте безопасность на предположении:

Никто не знает ссылку, значит бот приватный.

Если бот выполняет административные функции:

• · Проверяйте пользователя;
• · Проверяйте его роль;
• · Не открывайте админ-команды всем;
• · Не отправляйте секреты в сообщения;
• · Не используйте только «секретный ник» как защиту.

Почему бот не добавляется в канал

Проверяйте по порядку.

Бот ещё на модерации

Дождитесь статуса «создан».

Запрещено добавление в групповые чаты

Включите разрешение в расширенных настройках. Этот запрет распространяется и на каналы.

Бот ещё не участник канала

Сначала добавьте его, затем назначайте администратором.

Выданы не те права

Бот может числиться администратором, но не иметь write, delete или другого нужного доступа.

Используется старый токен

Если токен обновлялся, сервер или конструктор должны использовать новый.

Неверный chat_id

Получайте ID из событий API.

Webhook не получает события

Проверьте:

• · HTTPS;
• · Порт 443;
• · TLS-сертификат;
• · Ответ HTTP 200;
• · Secret;
• · Активную подписку.

Превышен лимит запросов

Если API отвечает 429, добавьте rate limiting и backoff.

Что делать, если бот есть в канале, но не публикует

Проверьте цепочку:

1. Токен действителен.
2. Запросы идут на platform-api2.max.ru.
3. Токен передаётся через Authorization.
4. chat_id относится к нужному каналу.
5. Бот находится в канале.
6. Бот имеет роль администратора, если она нужна сценарию.
7. Выдано право публикации.
8. Код обрабатывает ответ API.
9. Нет ошибок 401, 403, 429 или 503.

Код ответа обычно полезнее, чем попытка удалить и создать бота заново.

Основные ошибки при создании бота

Использовать устаревшую инструкцию

Проверяйте текущие MAX для партнёров и dev.max.ru.

Планировать произвольный ник

Сейчас он генерируется автоматически.

Считать создание бота готовой автоматизацией

После регистрации нужно отдельно реализовать сценарий.

Опубликовать токен

Токен должен оставаться секретом.

Выдать все права в канале

Используйте принцип минимальных привилегий.

Использовать Long Polling в production

MAX рекомендует Webhook.

Хранить токен прямо в коде

Используйте переменные окружения или secret manager.

Не обрабатывать ошибки API

Различайте авторизацию, недостаток прав, rate limit и временную недоступность.

Минимальный безопасный чек-лист

Перед запуском проверьте:

• · Профиль верифицирован;
• · Бот прошёл модерацию;
• · Описание соответствует реальной функции;
• · Токен нигде не опубликован;
• · Используется актуальный API-домен;
• · Авторизация идёт через заголовок;
• · Для production настроен Webhook;
• · Webhook работает по HTTPS;
• · Бот получает только нужные права;
• · Административные сценарии защищены;
• · Ошибки логируются;
• · Продуман быстрый способ обновить токен.

Что подтверждено, а что нет

Утверждение	Статус
Собственного бота создают через MAX для партнёров	Подтверждено MAX
Нужен верифицированный профиль организации, ИП или самозанятого	Подтверждено MAX
Обычное физлицо без подходящего статуса создать своего бота не может	Подтверждено MAX
Для организации/ИП доступно до 5 ботов	Подтверждено MAX
Для самозанятого доступно до 2 ботов	Подтверждено MAX
Модерация может занимать до 48 часов по рабочим дням	Подтверждено MAX
Ник сейчас генерируется автоматически	Подтверждено MAX
Изменить ник сейчас нельзя	Подтверждено MAX
Токен появляется после успешной модерации	Подтверждено MAX
По умолчанию добавление бота в групповые чаты запрещено	Подтверждено MAX
При таком запрете добавить бота в канал тоже нельзя	Подтверждено MAX
Бота можно назначить администратором канала	Подтверждено MAX
Актуальный API-домен — platform-api2.max.ru	Подтверждено MAX
Токен передаётся через Authorization	Подтверждено MAX
Для стабильной работы указан ориентир 30 rps	Подтверждено MAX
Для production MAX рекомендует Webhook	Подтверждено MAX
Long Polling одинаково рекомендован для production	Нет, MAX рекомендует обратное
Любой личный аккаунт может создать бота командой /create	Не соответствует текущему официальному процессу
При создании можно выбрать любой свободный ник	Сейчас не подтверждено
Созданный бот автоматически начинает публиковать в канал	Нет — нужны сценарий, добавление и права

Главное

Создание бота в MAX состоит из нескольких уровней:

профиль → бот → модерация → токен → логика → канал → права → события → тестирование.

Для простого сценария без разработки после модерации можно подключить подходящий конструктор или партнёрский сервис.

Для собственной логики используйте MAX API, актуальный домен platform-api2.max.ru, храните токен как секрет и для production принимайте события через Webhook.

При подключении к каналу особенно важны два шага:

1. Разрешить добавление бота в групповые чаты — иначе его нельзя будет добавить и в канал.
2. Выдать только необходимые права — например, write для публикации или расширенный набор для модерации.

Если канал ещё не создан, используйте как создать канал в MAX. Для ручного и отложенного постинга смотрите как публиковать посты в MAX, а для общей стратегии — как продвигать канал в MAX.

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

Как создать бота в MAX?

Нужен верифицированный профиль организации, ИП или самозанятого на платформе MAX для партнёров. Откройте «Чат-боты», нажмите «Создать», заполните карточку и отправьте её на модерацию. После проверки получите токен и настройте сценарий через конструктор или API.

Можно ли создать бота MAX обычному физическому лицу?

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

Сколько ботов можно создать в MAX?

Организация или ИП может создать до пяти ботов на один профиль, самозанятый — до двух. Каждый бот проходит модерацию отдельно.

Сколько длится модерация бота MAX?

Официальная документация указывает срок до 48 часов по рабочим дням. При статусе «требует исправлений» нужно устранить замечания и отправить данные повторно.

Можно ли выбрать ник бота в MAX?

Сейчас нет. Ник генерируется платформой автоматически и, по актуальной официальной документации, изменить его пока нельзя.

Где получить токен бота MAX?

После успешной модерации откройте «Чат-боты → Перейти → Расширенные настройки → Настроить». Токен находится в отдельном поле. Не публикуйте его и обновите при подозрении на утечку.

Как добавить бота в канал MAX?

Сначала разрешите добавление бота в групповые чаты в расширенных настройках — этот переключатель влияет и на каналы. Затем добавьте бота участником / подписчиком канала и при необходимости назначьте администратором.

Какие права нужны боту для публикации в канал?

Для публикации используется право write. Если бот должен менять или удалять материалы, дополнительно нужны edit и delete. Выдавайте только необходимые права.

Почему бот не добавляется в канал MAX?

Частая причина — запрет добавления в групповые чаты, который включён по умолчанию и также блокирует добавление в канал. Также проверьте модерацию и присутствие бота в канале.

Можно ли создать бота MAX без программирования?

Да. После модерации и получения токена можно подключить совместимый конструктор или партнёрскую интеграцию и собрать сценарий без собственного кода.

Какой API-домен использовать для бота MAX?

Актуальная документация рекомендует platform-api2.max.ru. Токен передаётся через заголовок Authorization: <token>.

Что лучше для MAX-бота: Webhook или Long Polling?

Для production MAX рекомендует Webhook. Long Polling ограничен по скорости и сроку хранения событий и подходит прежде всего для разработки и тестирования.

Можно ли ботом модерировать комментарии в канале MAX?

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