Бот в Telegram и MAX на одном ядре: что общее и что разное

Кому и когда это нужно

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

Как это делается: 6 шагов

1. Опишите сценарий без привязки к мессенджеру: шаги записи, вопросы, подтверждение, перенос, отмена. Это ядро.
2. Заведите единую модель исходящего сообщения: текст, ряды кнопок, фото или файл. Ядро говорит только на ней, адаптер переводит её в вызов API.
3. Заведите единую модель входящего: кто пишет, из какого канала, текст это или нажатая кнопка.
4. Храните людей в одной таблице с полями «канал» и «id в канале». Идентификаторы Telegram и MAX живут в разных пространствах, без пометки канала их легко перепутать.
5. Связывайте карточки только по действию клиента: он сам делится номером в обоих ботах или вводит в MAX код, который получил в Telegram. Склейка по совпавшему имени подмешивает чужого человека. По 152-ФЗ (ст. 5, проверено по тексту на garant.ru) данные обрабатывают для заявленных целей, а базы с несовместимыми целями не объединяют. Нужно ли отдельное согласие на склейку, решает юрист, см. мифы о 152-ФЗ.
6. Прогоните чек-лист из раздела ниже на обоих мессенджерах до запуска.

В моём семейном ассистенте один код обслуживает Telegram и MAX, но устроено это несимметрично. Обработчики написаны под Telegram, а рядом стоит переводчик: события MAX превращаются в обновления Telegram, ответы уходят в API MAX. Человека из MAX я храню под id со сдвигом, чтобы номера не пересеклись. Строковые id сообщений MAX лежат в отдельной таблице. Нижняя клавиатура Telegram в MAX становится кнопками под сообщением, текст длиннее 4000 знаков режется. Склейка аккаунтов идёт по отпечатку номера, сам номер не хранится. Это проверено тестами с подменённым API, вживую связку я не гонял. Для нового проекта я бы сделал нейтральную модель сообщения, а не брал за основу один мессенджер: кейс ассистента показывает, где такой путь дорожает.

Что общее и что разное

Общее: сценарии, база клиентов, логика записи, расписание, уведомления, админ-панель. Разное показано в таблице, только подтверждённое документацией.

Подпись данных мини-приложения устроена похоже: ключ считается как HMAC-SHA256 от токена бота со строкой WebAppData, затем подписывается отсортированная строка параметров. Срок жизни auth_date проверяйте сами. Комментарии в каналах MAX через API появились в августе 2026, в тексте комментария ссылки и упоминания не поддерживаются, как они устроены в Telegram, не проверял. Про мини-приложения: интерфейс в чате вместо мини-приложения.

Чек-лист проверки и поддержка

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

Платформы меняются. По истории изменений dev.max.ru: с 19 июля 2026 боты должны ходить на домен platform-api2.max.ru, метод GET /chats с июня 2026 не поддерживается, в октябре 2026 добавлено событие bot_admin_permissions_changed. Раз в месяц открывайте историю API, фиксируйте версии библиотек и тестируйте обновления на копии. Если клиент остановил бота, уведомление не доставить: пишите в другой привязанный канал или звоните. Про рассылки см. лимиты Telegram и MAX. Лимиты Telegram взяты из FAQ ботов на core.telegram.org.

Где ошибаются чаще всего

Два бота с двумя базами: клиент записался в одном, спрашивает про запись в другом.

Сценарии скопированы вручную: через месяц тексты и правила переноса расходятся.

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

Нет единой отмены записи: слот в расписании остаётся занятым.

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

Где здесь поможет автоматизация

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

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

Можно начать с одного мессенджера?

Да. Ядро и таблицу клиентов с полем «канал» закладывают сразу, второй адаптер добавляют потом.

Как понять, что это один клиент?

По действию самого клиента: номер, которым он поделился в обоих ботах, или код привязки. Угадывать по имени нельзя.

Что делать, если клиент заблокировал бота?

Telegram присылает обновление my_chat_member, MAX событие bot_stopped. Пометьте канал недоступным и пишите в другой привязанный.

Коротко о главном

Один бот собирается из ядра сценария и двух адаптеров. Различия мессенджеров укладываются в таблицу, главные из них: длина текста, темп отправки, разметка, запуск мини-приложения. Платформы меняют API, поэтому нужен чек-лист и наблюдение за изменениями.

Хотите, чтобы я собрал для вас одного бота в Telegram и в MAX на общем ядре? Напишите мне в Telegram слово «ДВАБОТА».