Ошибки при переносе бота в MAX: чек-лист миграции

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

Транспортный слой переписывается целиком: другой Bot API, вебхуки только по HTTPS, своя клавиатура и свои лимиты. Платежи Telegram внутри MAX не работают, оплату собирают заново под СБП. Бота в каталоге MAX публикует владелец верифицированного юрлица РФ. База подписчиков сама не переезжает, аудиторию пересаживают руками.

Без изменений остаются логика диалогов, тексты и интеграции с CRM. Перенос бота в MAX я делаю под заказ, эта статья про то, что ломается и каких ошибок избежать.

Что действительно ломается при переносе

Перенос это адаптация, а не разработка с нуля. Логика диалогов, тексты, интеграции с CRM, хостинг и база данных переезжают без изменений. Переписывается транспортный слой: методы Bot API, форматы событий и лимиты. «Скопировать и поменять токен» не работает, бот должен корректно взаимодействовать с другой платформой.

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

Telegram и MAX: что меняется при переносе

Bot API MAX похож на Telegram по духу, но построчно не совместим: механизмы узнаются, а вызовы переписываются. Сравнивать платформы полезнее по устройству, чем по числам, лимиты Telegram в этом тексте не проверены и не приводятся.

Обновления о событиях в MAX приходят двумя способами: Webhook через подписку POST /subscriptions и Long Polling через GET /updates, одновременно использовать оба нельзя. Long Polling ограничен по скорости и сроку хранения событий и не подходит для постоянной работы бота, на всех этапах рекомендован Webhook.

• Получение обновлений: в Telegram это getUpdates и setWebhook, в MAX подписка Webhook POST /subscriptions или Long Polling GET /updates, одновременно оба режима включать нельзя.
• Вебхук: в MAX только HTTPS с сертификатом доверенного центра, включая сертификаты Минцифры; с 25 мая 2026 вебхуки по HTTP и с самоподписными сертификатами не поддерживаются.
• Клавиатура: вместо InlineKeyboardMarkup вложение inline_keyboard, до 210 кнопок, 30 рядов, до 7 кнопок в ряду, для кнопок link, open_app, request_geo_location и request_contact не более 3 в ряду; текст кнопки обрезается, при пересылке сообщения кнопки не пересылаются.
• Медиа: загрузка через POST /uploads, один токен на один файл, изображение до 50 МБ и не более 7680 x 7680 пикселей, до 12 вложений в сообщении, тип вложения photo заменён на image.
• Оплата: платежи Telegram внутри MAX не работают, платёжных методов в Bot API нет, оплату принимают через СБП.
• Публикация: в Telegram достаточно аккаунта и BotFather, в MAX бота выпускает владелец верифицированного юрлица РФ.

Чек-лист миграции: 8 ошибок и как их избежать

• Перенос как «поменять токен». Методы и форматы другие: домен platform-api2.max.ru, токен только в заголовке Authorization, GET /chats с июня 2026 не работает и заменён на POST /subscriptions, тип вложения photo заменён на image.
• Вебхук по HTTP или с самоподписным сертификатом. С 25 мая 2026 платформа такие вебхуки не поддерживает, нужен HTTPS с сертификатом доверенного центра, включая сертификаты Минцифры.
• Вебхук и Long Polling одновременно. Режимы взаимоисключающие, Long Polling ограничен по скорости и сроку хранения событий и для постоянной работы бота не подходит.
• Меню из Telegram «один в один». Лимиты клавиатуры свои: до 210 кнопок, 30 рядов, 7 кнопок в ряду и только 3 для link, open_app, request_geo_location и request_contact, текст кнопки обрезается по границе кнопки.
• Платёжная ветка «как есть». Платежи Telegram в MAX не действуют, платёжных методов в Bot API нет, платёжную ветку собирают заново под СБП.
• Мини-приложение «просто включить». Telegram WebApp и мини-приложения MAX устроены по-разному, интерфейс адаптируется отдельно, chat_id в мини-приложении получают через window.WebApp.initData библиотеки MAX Bridge.
• Расчёт на то, что подписчики переедут сами. База между мессенджерами не переносится, аудиторию пересаживают ссылкой в шапке канала, рассылкой по старой базе, QR-кодами и автоответом, пока работают оба канала.
• Юрлицо и модерация «потом». Публикацию ведёт владелец верифицированного юрлица РФ, требование действует с конца лета 2025 года, этот вопрос проверяют первым, сроки верификации не контролируют ни заказчик, ни разработчик.

Коротко

Ошибки при переносе концентрируются в четырёх местах: транспорт, оплата, публикация и пересадка аудитории. Сама логика бота переезжает целиком. API MAX при этом меняется под ногами: метод добавления участников POST /chats/{chatId}/members ограничен с 9 сентября 2026 и удаляется 30 сентября 2026, готового способа добавить участника через API после этого нет. Перед стартом переноса сверяются с актуальной документацией dev.max.ru.

Если бота ещё нет, соберу бота для MAX под ваш процесс. Остальные сценарии с мессенджерами собраны в каталоге ботов.