Мост между MAX и Telegram: как сделать — наш мост, готовые боты и официальный путь

Аудитория многих компаний теперь живёт в двух мессенджерах. Часть клиентов осталась в Telegram, часть перешла в MAX, а команда не хочет держать открытыми два приложения.

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

Весной я решал эту задачу для себя и собрал MAX2TG-Bridge — мост, который превращает каждый чат MAX в отдельную тему внутри Telegram. Код открыт, его уже форкнули четыре раза, а подробный разбор вышел кейсом в апреле. С тех пор «как сделать мост между MAX и Telegram» — тема, по которой блог показывается в поиске чаще всего.

Поэтому здесь — все способы в одном месте: наш мост, готовые боты для групп и каналов и официальный путь через бота MAX. Всё проверено на сентябрь 2026 года.

Что такое мост и какие задачи он решает

Мост — программа-посредник, которая следит за чатом в одном мессенджере и повторяет сообщения в другом. Если в группе MAX вы видели сообщения от бота с подписью «Иван (TG)», это мост: человек написал в Telegram, а бот продублировал реплику в MAX.

Бизнесу мост нужен для трёх разных задач, и от задачи зависит инструмент:

1. Все чаты MAX у себя в Telegram. Вы не открываете MAX: переписка с клиентами и группы приходят в рабочий Telegram, отвечаете оттуда же. Это наш мост.
2. Одно сообщество в двух мессенджерах. Участники пишут кто где хочет, но видят друг друга. Это мост групп.
3. Один канал на два мессенджера. Пост выходит в Telegram и сам появляется в MAX. Это кросспостинг.

flowchart TD
  A{"Что нужно?"} -->|"читать и вести MAX<br/>из Telegram"| B{"Есть ИП, самозанятость<br/>или компания?"}
  B -->|"нет или нужны<br/>личные чаты"| C["MAX2TG-Bridge:<br/>каждый чат — тема"]
  B -->|"да, клиенты пишут<br/>компании"| D["Бот компании в MAX,<br/>диалоги — в Telegram"]
  A -->|"общая группа<br/>для участников"| E["Мост групп:<br/>/bridge"]
  A -->|"канал в двух<br/>мессенджерах"| F["Кросспостинг:<br/>/crosspost"]

Два способа подключиться к MAX

Любой мост должен как-то читать MAX. Способов два, и разница между ними важнее выбора конкретной программы.

	Через личный аккаунт	Через бота MAX
Кто может	любой	ор­га­ни­за­ция, ИП или са­мо­за­ня­тый — резидент РФ
Что видит мост	все ваши чаты: личные, группы, каналы	только чаты, куда добавлен бот, и со­об­ще­ния боту
От чьего имени ответ	от вас	от бота
Правила MAX	не раз­ре­ше­но, риск бло­ки­ров­ки	офи­ци­аль­ный путь
Что может сло­мать­ся	об­нов­ле­ние про­то­ко­ла MAX	меняется API — выходит новая версия биб­лио­те­ки

Наш мост работает через личный аккаунт — поэтому он и удобнее всего: клиент пишет вам как обычно, а вы отвечаете из Telegram. Цена этого удобства — в разделе о безопасности.

Наш мост: каждый чат MAX — тема в Telegram

Как это выглядит в работе:

• написал новый собеседник — в рабочей группе Telegram появляется тема под него, а сверху закрепляется карточка с именем и аватаром;
• пишет старый — сообщение падает в его же тему, вся история рядом;
• вы отвечаете в теме — ответ уходит собеседнику в MAX от вашего имени, а на ваше сообщение бот ставит 👀, когда оно доставлено.

Переносятся текст с форматированием, фото, видео, документы, голосовые, стикеры, контакты, геолокации, цитаты и пересланные сообщения. Группы и каналы MAX тоже можно завести в Telegram: команда /add со ссылкой-приглашением создаёт под них тему.

flowchart LR
  K["Клиент пишет<br/>в MAX"] --> M["MAX2TG-Bridge<br/>на вашем сервере"]
  M --> T["Его тема в рабочей<br/>группе Telegram"]
  T --> R["Вы отвечаете<br/>в теме"]
  R --> M
  M --> K2["Ответ приходит клиенту<br/>в MAX от вас"]

Что понадобится

• Сервер с Docker — мост должен работать постоянно. Подойдёт недорогой VPS.
• Супергруппа Telegram с включёнными темами. Это настраивается в параметрах группы.
• Бот Telegram от @BotFather — администратор группы с правом «Управление темами», иначе он не сможет создавать темы.
• ID группы. Перешлите любое сообщение из неё боту @userinfobot — он покажет число вида -100….
• Данные входа в ваш аккаунт MAX из веб-версии. Как их получить, описано в README проекта. В блоге шаги не повторяю: эти данные дают полный доступ к аккаунту, и обращаться с ними нужно как с паролем.

Запуск

git clone https://github.com/ircitdev/MAX2TG-Bridge.git max2tg
cd max2tg
cp .env.example .env
# впишите в .env токены и ID группы, затем:
docker compose up -d --build

Когда мост подключится, в общей теме группы появится сообщение ✅ Max: подключён. Первая тема создастся с первым входящим сообщением.

Три настройки, которые я советую включить сразу:

• TG_ALLOWED_USER_ID — отвечать в MAX сможете только вы, даже если в группе есть другие люди;
• MAX_CHAT_IDS — мост будет работать только с перечисленными чатами, а не со всей перепиской;
• в настройках реакций группы разрешите «Все эмодзи» — иначе бот не сможет отмечать доставку.

Команды

Команда	Что делает
/bind <ID или ссылка>	создать тему под кон­крет­ный чат MAX
/add <ссылка-при­гла­ше­ние>	под­клю­чить группу или канал MAX
/profile	показать карточку со­бе­сед­ни­ка
/intro	заново за­кре­пить карточку
/del	удалить тему и связь с чатом

Ограничения

• голосовые из Telegram приходят в MAX файлом .ogg, а не «пузырём»;
• часть новых голосовых из MAX пока не скачивается — мост сообщает об этом в теме;
• файлы больше 20 МБ из Telegram не дойдут: это лимит Bot API;
• если войти в веб-версию MAX с другого устройства, данные входа могут смениться — тогда их нужно обновить в настройках моста.

Проект распространяется под лицензией MIT: его можно ставить себе, менять и использовать в работе. В репозитории 191 автоматический тест.

Что нужно для официального бота MAX

Официальный путь — бот компании. Он нужен, если вы разворачиваете мост групп на своём сервере или хотите, чтобы клиенты писали компании, а не вам лично.

Условия MAX на сентябрь 2026:

• Физическое лицо бота создать не может. Только самозанятый, ИП или организация — резиденты РФ.
• Регистрация — на платформе MAX для партнёров или в мини-приложении «MAX для бизнеса». Нужно создать профиль и пройти верификацию.
• Каждый бот проходит модерацию. Токен появляется после неё: «Чат-боты» → ⋮ → «Настройки».
• Имя бота задаётся автоматически — id<ИНН>_bot для ИП и организаций, поменять его нельзя.
• Лимит: 5 ботов на организацию или ИП, 2 на самозанятого.
• Добавление в группы по умолчанию запрещено. Для моста разрешите его в настройках приватности бота.
• Для постоянной работы MAX требует получать события через webhook по HTTPS с сертификатом доверенного центра. Long Polling — только для тестов.

Общая группа в MAX и Telegram

Наш мост приносит чаты MAX вам. Если же нужно, чтобы участники обоих мессенджеров видели друг друга, нужен мост групп. Проще всего — готовый сервис Bridge Bot: свой бот MAX для него не нужен, бесплатно можно связать одну группу и один канал.

1. Добавьте @MaxTelegramBridgeBot в группу Telegram и сделайте администратором. Для группы с темами это обязательно.
2. Добавьте бота сервиса в группу MAX и тоже назначьте администратором.
3. В одном из чатов отправьте /bridge — бот пришлёт ключ.
4. В другом чате отправьте /bridge <ключ>. Именно в группе, а не в личке бота.

Сообщения пошли в обе стороны. /bridge prefix on включает пометки [TG] и [MAX], /unbridge разрывает связь.

Что учесть:

• удаление работает только из MAX в Telegram — Telegram не сообщает ботам об удалённых сообщениях;
• цитаты и спойлеры пропадают — их не поддерживает API MAX;
• сторонний сервис пропускает сообщения через свою инфраструктуру. Для рабочих чатов надёжнее свой сервер. Код Bridge Bot открыт (max-telegram-bridge-bot), но лицензия CC BY-NC 4.0 требует письменного разрешения автора на коммерческое использование. Более простой вариант под MIT — tg-max-bridge: текст с именем автора, фото и документы до 20 МБ, без форматирования и голосовых. Для обоих нужен свой бот MAX.

Ветки: в MAX их нет — что делать

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

То, что в MAX называют папками, — другое. Папка («Настройки» → «Папки») сортирует список чатов: собирает в одну вкладку, например, все рабочие группы. Сообщения внутри группы она не разделяет.

Если нужны ветки, есть три пути:

• Отдельная группа MAX под каждую тему плюс папка, которая собирает их вместе.
• Форум в Telegram как главный чат для участников. Bridge Bot связывает каждую тему форума с отдельной группой MAX: /thread_bridge внутри темы в Telegram выдаёт ключ, /thread_bridge <ключ> в нужной группе MAX завершает связку.
• Ветки только для себя. Наш мост и так раскладывает каждый чат MAX в свою тему — если ветки нужны вам, а не участникам, ничего настраивать не надо.

flowchart LR
  subgraph TG["Telegram: группа с темами"]
    T1["Тема «Заказы»"]
    T2["Тема «Доставка»"]
    T3["Тема «Общее»"]
  end
  subgraph MX["MAX: папка «Магазин»"]
    M1["Группа «Заказы»"]
    M2["Группа «Доставка»"]
    M3["Группа «Общее»"]
  end
  T1 <--> M1
  T2 <--> M2
  T3 <--> M3

Один канал на два мессенджера

Кросспостинг в Bridge Bot настраивается в личке с ботами, в самих каналах ничего не публикуется:

1. Добавьте бота администратором в канал Telegram и в канал MAX.
2. Перешлите любой пост из канала Telegram в личку Telegram-бота — он покажет ID канала.
3. В личке MAX-бота отправьте /crosspost <ID>.
4. Перешлите любой пост из канала MAX в личку MAX-бота — связка готова.

По умолчанию посты идут в обе стороны, направление меняется кнопками.

Полезная для маркетолога деталь — автозамены. Правило utm_source=tg | utm_source=max поменяет метку в ссылках постов, ушедших в MAX, и в аналитике будет видно, какой мессенджер привёл клиента.

Переписка с клиентами: официальные варианты

Если у вас есть ИП, самозанятость или организация, переписку с клиентами можно построить без личного аккаунта.

Клиенты пишут боту компании. Ссылку на бота MAX размещаете на сайте и в карточках, а мост раскладывает диалоги по темам рабочей группы Telegram — по одной на клиента. Ответ уходит клиенту от имени бота. По устройству это тот же приём, что в нашем мосте, только вместо личного аккаунта — официальный бот. У Bridge Bot такие «личные мосты» заявлены в платном тарифе.

Обратное направление: личка Telegram у оператора в MAX. Проект TG.MaxDirectBot (MIT) подключается к аккаунту через Telegram Business и пересылает новые личные сообщения оператору в MAX. Оператор отвечает кнопкой «Ответить», клиент получает ответ от вашего Telegram-аккаунта. Работает только на официальных API. Для подключения бота к аккаунту нужен Telegram Premium, а автор советует завести для обращений отдельный аккаунт.

Насколько это безопасно

Мост через личный аккаунт — неофициальный. Пользовательское соглашение MAX в пункте 4.3.7 запрещает без разрешения компании использовать автоматизированные программы и боты для взаимодействия с сервисом и заниматься обратной разработкой. Пункт 4.4 запрещает интегрировать сервис с другими программами без отдельного соглашения. Это относится к любому такому мосту, включая наш: риск ограничения или блокировки аккаунта реален, и об этом прямо сказано в README проекта.

Как снизить этот риск:

• ограничьте мост нужными чатами (MAX_CHAT_IDS), а не отдавайте ему всю переписку;
• отвечать через мост может только один человек (TG_ALLOWED_USER_ID);
• никаких рассылок и массовых действий — мост только пересылает живую переписку;
• MAX остаётся запасным каналом: если мост остановится, переписка никуда не пропадёт.

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

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

1. Чей это сервер? У стороннего сервиса сообщения проходят через чужую инфраструктуру. Свой сервер — ваш контроль.
2. Какие чаты видит мост? Только те, которые действительно нужно связать.
3. Где лежат токены? Только в настройках сервера, не в коде и не в переписке.
4. Что хранится в базе? Мосты запоминают, какой чат какой теме соответствует. Узнайте, где это лежит и кто имеет доступ.
5. Есть ли персональные данные клиентов? Имена, телефоны и адреса в переписке подпадают под закон о персональных данных — место хранения и доступ к ним стоит продумать заранее.
6. Отдельный аккаунт для работы. Не подключайте мост к аккаунту, где лежит личная переписка.

Что выбрать

Задача	Способ	Что по­на­до­бит­ся
Вести все чаты MAX из Telegram	MAX2TG-Bridge	сервер с Docker, бот Telegram, аккаунт MAX
Общая группа для участ­ни­ков	Bridge Bot	два бота-ад­ми­ни­стра­то­ра, 10 минут
Ветки для участ­ни­ков MAX	группы MAX и форум Telegram	не­сколь­ко групп и папка
Канал в двух мес­сен­дже­рах	Bridge Bot, крос­с­по­стинг	бот-ад­ми­ни­стра­тор в обоих каналах
Об­ра­ще­ния клиентов к компании	бот компании в MAX	ИП, са­мо­за­ня­тость или ор­га­ни­за­ция
Личка Telegram у опе­ра­то­ра в MAX	TG.Max­Direct­Bot	Telegram Premium, свой бот MAX

Вывод

Мост между MAX и Telegram позволяет не выбирать между мессенджерами. Если нужно вести всю переписку MAX из рабочего Telegram — берите наш мост и помните о правилах MAX. Если нужно связать группу или канал для участников — хватит готового бота и десяти минут. А для переписки компании с клиентами стоит один раз завести официального бота: этот путь не сломается из-за очередного обновления.

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

📝 Проверить, где сайт теряет заявкиБесплатно, в Telegram-боте @uspeshnyybot

Читайте также