Почему перенос — это адаптация, а не копирование
Telegram и MAX строятся на разных технических решениях. Структура API-запросов, способы аутентификации, форматы данных — всё это различается на уровне кода. Скопировать Telegram-бота в MAX без правок не получится: первый же запрос вернёт ошибку.
Схожесть есть на уровне архитектуры: оба мессенджера работают через REST, поддерживают Webhook и Long Polling, отдают JSON. Разработчик, знакомый с одной платформой, разберётся во второй без долгого погружения. Для конструкторов задача проще — платформа берёт технические различия на себя.
Технические расхождения, которые влияют на объём работы
Первое расхождение — структура запросов. Отправка сообщения в Telegram: POST /sendMessage, chat_id и текст в теле. В MAX: POST /messages, где chat_id уходит в query-параметры URL, а текст передаётся в объекте NewMessageBody внутри тела.
Второе — аутентификация. MAX принимает токен только через заголовок Authorization. Передача через query-параметры, которая работает в Telegram, здесь не поддерживается. Это первое место где Telegram-код падает без адаптации.
Третье — форматирование. HTML совпадает в обоих мессенджерах. Markdown различается: подчёркивание в MAX пишется как ++текст++, в Telegram MarkdownV2 — __текст__. Упоминания пользователей тоже разные — MAX использует max://user/id, Telegram tg://user?id=.
Четвёртое — лимит сообщений. MAX принимает до 4 000 символов против 4 096 в Telegram. Разница незначительная, но длинные автоматически генерируемые ответы стоит проверить.
Что в MAX пока не реализовано
Inline-режим — вызов бота из любого чата — в MAX отсутствует. Спойлеры, блочные цитаты, кастомные эмодзи не поддерживаются. Локальный Bot API для развёртывания на собственном сервере недоступен. Тестовой среды нет — отладка идёт сразу в рабочем окружении.
Мини-приложения переносятся, но требуют переработки. Меняется JS-библиотека: вместо telegram-web-app.jsподключается max-web-app.js. Глобальный объект другой: window.WebApp вместо window.Telegram.WebApp. Диплинки различаются — в MAX формат max.ru/?startapp=, в Telegram t.me/<bot>/app?startapp=.
Что переходит без изменений
Бизнес-логика сценариев не привязана к конкретному мессенджеру. Ветвления, условия, переменные, сегментация аудитории — всё это работает одинаково в любом канале. Интеграции с CRM, таблицами, платёжными системами тоже сохраняются: они общаются с внешними сервисами напрямую, минуя API мессенджера. Тексты сообщений и структура воронок переезжают без правок.
Два сценария для конструкторов чат-ботов
На примере LEADTEX хорошо видны два ключевых подхода, которые закрывают разные задачи.
Первый — MAX подключается как дополнительный канал к уже работающему боту. В разделе «Каналы» выбирается логотип MAX, вставляется токен — и существующие цепочки, условия, переменные начинают работать в новом мессенджере без пересборки. База контактов и аналитика остаются общими. Этот путь закрывает большинство задач: отлаженная логика из Telegram просто получает второй канал доставки.
Второй сценарий нужен реже — когда под MAX строится отдельный бот с другим сценарием. Например, аудитория в MAX приходит через другую точку входа и требует иного прогрева. В этом случае создаётся новый бот, токен MAX подключается к нему, сценарий собирается отдельно — при этом оба бота управляются из одного кабинета.
Клавиатура: ключевое отличие для конструктора
MAX поддерживает только inline-клавиатуру — кнопки располагаются под сообщением. Отдельного меню внизу экрана, привычного по Telegram, нет. В LEADTEX это настраивается на вкладке MAX в блоке «Настройка клавиатуры». Ограничения платформы: до 7 кнопок в строке, не более 30 строк.
Кнопки со ссылками работают иначе чем в Telegram. При выключенном отслеживании переходов кнопка выдаёт ссылку и останавливается — пользователь не идёт дальше по сценарию. Чтобы воронка продолжалась после клика, отслеживание включается явно в настройках кнопки.
Сколько времени занимает перенос
Линейный бот с командами, кнопками и стандартными сценариями адаптируется за несколько часов. Через конструктор — ещё быстрее, большую часть различий платформа закрывает сама. Бот с мини-приложением, нестандартными интеграциями и сложным интерфейсом потребует от нескольких дней до двух-трёх недель — в зависимости от объёма переработки JS-библиотеки и пользовательских сценариев.
Перенос Telegram-бота в MAX — адаптация существующей логики, а не разработка с нуля. Сценарии, интеграции и воронки сохраняются. Адаптация затрагивает структуру запросов, аутентификацию, форматирование Markdown и работу с мини-приложениями. Через конструктор, например LEADTEX, порог входа минимальный: MAX добавляется как канал к готовому боту, токен вставляется за минуты, модерация занимает до 48 часов.
