В декабре 2024 я запустил антиспам-бот для Макс — по той же схеме, что уже годами работает в Telegram. Через месяц платформа удалила бота без объяснений. Поддержка отвечала: «работаем над вашим вопросом, ждите». Досудебная претензия заказным письмом — разблокировка и ответ в духе «вы согласились с правилами при регистрации».

Если вы разработчик ботов и думаете зайти в Макс — расскажу историю моей разработки в МАКс. В декабре 2025 я перенес алгоритмы из своего антиспам бота в Телеграм в МАКС, много пришлось менять, т.к. API сильно отличается, и запустил его в работу.
31 января 2026 MAX удалил профиль антиспам-бота без письма и без причины. Просто бота удалили, при этом в Макс-бизнес он показывался как работающий. Десять дней писем в поддержку — один ответ "мы разбираемся, ожидайте". 17 февраля отправил досудебную претензию, через несколько дней после доставки моей претензии бот снова появился в списке, но ещё неделю на любую команду API отвечал ошибкой. Пишу это не как рекламу MAX и не как войну с MAX — просто зафиксировать, что перенос бота из Telegram сюда оказался не «ещё один webhook», а отдельная головоломка: техническая и юридическая. Поделюсь двумя своими разработками: антиспам (перенос TG-логики) и «Почтальон» (мост Макс ↔ Telegram), который родился уже после блокировки.

Кто я и зачем эта статья

Это моя первая публикация на Хабре — прошу не судить строго. Разработкой занимаюсь больше 40 лет; последний год в основном пишу ботов для Макс. Отправил в поддержку несколько сотен тикетов — большинство закрыли с сообщением «Ваш вопрос закрыт» и без видимых изменений в API, часть чинили оперативно.

В арсенале три бота в Макс: антиспам, «Почтальон» (мост Макс ↔ Telegram) и розыгрыши призов. Розыгрыши здесь не разбираю — другая предметная область. Фокус на том, что полезно коллегам-разработчикам.

Стоит ли вообще лезть в Макс в 2026 году

Лезть в MAX имеет смысл, если вам нужны живые пользователи, здесь "голубой океан" возможностей, мало конкурентов, но вы готовы к тому, что документация врёт, а бота могут выключить и "включить" его будет крайне сложно. Ну а поддержка, она как и в Телеграмм, почти отсутствует. Если нужен предсказуемый API — я бы пока не переносил сюда единственный источник дохода.

Вывод, с которым живу: Макс — поле для тех, кто готов к запасным каналам, подробным логам и тому, что платформа может откатить месяц работы одним щелчком. Если вам нужна предсказуемая экосистема уровня Telegram Bot API 9.x — пока рано ставить всё на Макс.

Базовая дисциплина: один webhook — один запрос

Прежде чем про ботов — про архитектуру. У меня все боты устроены одинаково:

HTTP-запрос → webhook.php → обработка → exit

Никаких «долгоживущих» PHP-процессов между событиями. Каждый webhook — чистый контекст. Флаги вроде «удалить сообщение при следующем update» живут только внутри текущего запроса.

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

Кейс 1: антиспам — когда переносишь проверенную TG-логику

Задача

В Telegram мой user_ban работает по принципу «установил и забыл»: эвристики по имени, ссылкам, языку, флуду, массовым рассылкам — без ручных списков стоп-слов. Порт в Макс выглядел прямолинейно: тот же webhook, бан/мут, уведомления админам в личку.

Где TG и Макс расходятся на практике

В Telegram я привык: deleteMessage либо сработал, либо вернул понятный код ошибки. В MAX на одном и том же chat_id удаление то проходило, то нет — при тех же правах бота в интерфейса админа. А ещё "феничка" MAKC меня радует 6й месяц: бот может добавить пользователя в любой чат без его согласия... или не добавить, причем однозначного ответа почему это происходит или не происходит поддержка не знает!

Конкретные примеры из продакшена:

  1. Права админа — бот добавлен, формально админ, но отдельные операции (удаление, бан) ведут себя иначе, чем в TG. Приходилось проверять не «что написано в документации», а «что вернул API на этом chat_id».
    А Вы могли предположить что право в канале "Редактировать чужие посты" на самом деле нужно чтобы бот мог править собственные посты?!

  2. Сырой webhook — писать в лог всё что приходит, максимально подробно. Да, лог огромный, лишние ресурсы, но иначе потом ни в поддержку не напишешь, ни сам не поймешь что там происходило.

  3. Уведомления нескольким админам — в больших бесплатных чатах (≥10 участников) рассылать всем админам каждый mayBe-спам — убить личку и выйти за лимиты API. Пришлось ввести одного модератора уведомлений (/setNotify): команды модерации доступны всем админам, а авто-уведомления — одному слоту (или в чат админов).

  4. Бан пользователя — В МАКС это не совсем БАН! Пользователь может снова вступить по ссылке приглашению (той самой публичной по которой все вступают) или его может добавить любой участник!.

  5. Разбан пользователя — В МАКС это самая большая непредсказуемость! У меня накопилось два десятка пользователей, которых невозможно разбанить (Тикет есть давно, ТП о них знает и ничего не может сделать)

  6. Нет частичных и временных ограничений пользователя - приходится всё эмулировать, чтобы пользователя не удалять из чата, а только запретить ему писать.

История с удалением — что запомнить разработчику

Не буду раздувать юридическую часть. Инженерные выводы:

  • не держите единственную точку контакта с пользователями внутри платформы;

  • логируйте всё, что может понадобиться при разборе;

  • имейте план Б на случай удаления бота — у меня он стал вторым продуктом (см. кейс 2).

Кейс 2: «Почтальон» — Второй бот я писал уже для себя

Откуда взялось

После блокировки Телеграм в России я оказался в ситуации, знакомой многим: Telegram недоступен или режется, Макс — работает. Все контакты в Телеграм. Нужно читать личку Telegram и отвечать так, чтобы собеседник видел ответ в том же диалоге TG.

Так появился «Почтальон»: пересылка Макс ↔ Telegram с ответами из Макс обратно в исходный диалог.

Модель данных (суть)

В БД — таблица пересылок. Каждая строка — направление потока, не «настройка бота» абстрактно:

Режим 0 (⇢): Макс → Telegram   — посты из канала Макс в группу TG
Режим 1 (⇠): Telegram → Макс   — входящие из TG-группы в личку Макс
Режим 2 (⇄): обе стороны      — чат Макс ⟷ чат TG

Отдельный сценарий — автоматизация профиля Telegram (Настройки → Аккаунт → Автоматизация чатов): вся входящая переписка профиля уходит в личку Макс; «Ответить» в Макс возвращает текст клиенту в TG.

Главный источник багов у новичков: путаница, кто такой tg в строке связки — это не id клиента, а id группы/канала или владельца профиля.

Проблема одного слота автоматизации в Telegram

В профиле TG можно подключить только одного бота автоматизации. У корпоративных пользователей уже стоял свой автоответчик. Заменить его на «Почтальона» — потерять ответы на типовые вопросы.

Решение: встроить автоответчик в «Почтальона». Один бот:

  1. пересылает входящее в Макс;

  2. сразу отвечает клиенту в TG по правилам (фразы, кнопки, медиа);

  3. опционально дописывает в пересылку: 🤖 Автоответил: … — коллеги в Макс видят, что клиенту уже ответили.

Корпоративные клиенты не могли выкинуть старый автоответчик из автоматизации TG — пришлось вшить автоответ в Почтальона .

Общий чат вместо лички

Следующий запрос пришёл от пользователей, не от ТЗ: пересылать не в личку Макс, а в групповой чат, чтобы несколько менеджеров смотрели потоки в одном месте. Ответ из Макс уходит автору в TG — несколько менеджеров смотрят один чат в MAX, отвечают — уходит в тот же диалог TG.

Проблема с большими файлами

У Tg для пересылки больших файлов существует локальный сервер Telegram Bot API, его нужно установить на своем сервере и все запросы переадресовывать на свой сервер. У Макс такого сервера нет, но есть проблема с частыми ошибками при загрузке файлов на сервер Макс, что создает неудобства, когда пост опубликован в канале TG, а в Макс бот почтальон "пропихивает" его за 10 минут с пятой попытки.

Белые списки

Отдельный практический сценарий: периоды, когда из мессенджеров нормально работает только Макс — запасной продолжает работать.

Чеклист: что заложить до первого коммита под Макс

  1. Лог сырого webhook — файл на диск при превышении порога или при error от API; в оперативный лог — ссылка, не полный JSON.

  2. Изоляция вторичных подсистем — у меня есть каталог "МАКС-Навигатор" в который публикую все чаты/каналы/ботов с которыми сталкиваются мои боты. Ошибка каталога не роняет webhook основного бота. Сначала бизнес-логика, потом всё остальное — в try/catch или на shutdown.

  3. Не дублировать webHookBegin() в боте с урезанным набором полей — потеряете кнопки, payload и отладку. Один вход через базовый класс.

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

  5. Связь с пользователями вне платформы — канал, сайт, email; платформа может отключить бота без объяснений.

  6. Сценарий «бот удалили» — что видит пользователь, как переустановить, как не потерять данные.

  7. Один webhook = один запрос — не проектировать сброс static-state между запросами; следующий webhook — новый процесс.

Где обсуждать разработку под Макс

Если после прочтения остались вопросы по API, webhook, модерации или странным ответам поддержки — завёл чат для разработчиков, которые уже ковыряют Макс или только собираются. Там нет официальной поддержки платформы — зато есть люди, которые уже получили по зубам и могут сказать «у нас тоже так было».

Заключение

Год назад я бы сказал: перенесу антиспам за неделю. Сейчас три бота в проде, несколько сотен тикетов в ТП и один раз бота удалили молча. Если пойдёте в MAX — закладывайте терпение, логи, запасной канал связи с пользователями и не верьте, что «раз написал — дальше платформа не тронет». Остальное — в комментариях, если будут вопросы по конкретным методам API.

P.S. Подробные инструкции к описанным кейсам (документация, не реклама):

Боты в Макс: @id616301431999_bot (антиспам), @id616301431999_2_bot (почтальон). В Telegram: @postman_max_bot.

Буду рад конструктивной критике в комментариях, особенно от тех, кто тоже пилит под Макс.

P.P.S: Спасибо за вашу оценку меня, как автора в вашем сообществе! Уверен, что Вы понимаете, что при таком рейтинге, я теперь не могу не только публиковать новые посты, которые могли бы быть кому-то полезными, но и отвечать на ваши вопросы и комментарии. Всем мира!