Контент / Telegram

Как настроить контент из Telegram

Пошаговая инструкция: подключаем Telegram-канал или группу к чату в MAX, выбираем направление синхронизации и переносим старые посты пересылом в платформенного бота.

Обновлено 28 апреля 2026 г.

Обзор

MHUB транслирует контент из ваших Telegram-каналов и групп в чаты и каналы MAX. С одной настройкой вы получите:

автоматическую публикацию новых постов из Telegram в MAX;
выбор направления — только TG → MAX или двунаправленную синхронизацию (для групп);
перенос старых постов — простым пересылом сообщений платформенному боту;
поддержку альбомов — несколько фото/видео из одного поста группируются автоматически;
защиту от дублей — один и тот же пост не опубликуется в MAX дважды.

К одному проекту можно подключить несколько интеграций: разные Telegram-источники в разные (или один и тот же) чат MAX.

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

Проект в MHUB с настроенными чатами/каналами доступа в MAX (раздел Каналы и чаты).
Платформенный Telegram-бот — общий для всей платформы. Его username виден в меню «📲 Контент из Telegram» админ-бота сразу после открытия раздела.
Telegram-канал или группа, из которых вы хотите транслировать контент.
Чат или канал в MAX, куда контент будет публиковаться.
Бот-публикатор проекта (клиентский бот MHUB), добавленный администратором в этот чат MAX с правом «Писать посты».

Если вы ещё не подключили клиентского бота к проекту, сначала пройдите статью «Подключение клиентского бота».

Шаг 1. Добавьте платформенного бота в Telegram-источник

Откройте раздел 📲 Контент из Telegram в админ-боте MHUB — в верхней строке вы увидите username платформенного бота, например:

Платформенный бот: @mhub_content_bot

Для канала

Откройте Telegram-канал → Управление каналом → Администраторы → Добавить администратора.
Найдите платформенного бота по username.
Дайте ему права администратора (минимально достаточно дефолтных прав на чтение; писать в источник бот не будет).

Для группы / супергруппы

Достаточно просто пригласить бота участником — права администратора не обязательны. Но если хотите получать в MAX системные сообщения (закреп и т. п.), сделайте админом.

⚠️ Если бот не админ канала или не участник группы — на следующем шаге проверка источника завершится ошибкой.

Шаг 2. Откройте «Контент из Telegram» в админ-боте

Откройте диалог с админ-ботом MHUB в MAX.
Перейдите: Проекты → выберите проект → Настройки → 📲 Контент из Telegram.
На экране вы увидите:
- username платформенного бота;
- количество и список текущих интеграций со статусами;
- кнопку «➕ Добавить интеграцию».

Каждая строка интеграции имеет вид:
🟢 <Telegram-источник> → <чат MAX> (активен)
где 🟢 — включена, ⚪ — выключена, → — однонаправленная, ↔ — двунаправленная.

Шаг 3. Создайте интеграцию

3.1. Укажите Telegram-источник

Нажмите «➕ Добавить интеграцию». Бот попросит отправить username или chat_id источника:

Username канала — в формате @mychannel.
chat_id — числовой ID, например -1001234567890.

💡 Узнать chat_id можно через @userinfobot: перешлите ему любое сообщение из вашего канала или группы — он вернёт ID.

После отправки бот выполнит проверку:

источник существует и доступен;
его тип — канал, группа или супергруппа;
платформенный бот добавлен в источник (админом для каналов, участником для групп).

При ошибке вы увидите подсказку:

Не удалось проверить Telegram-источник.

Проверьте:
• бот добавлен в канал/группу как админ
• username или chat_id указан верно

Попробуйте ещё раз.

3.2. Выберите чат назначения в MAX

После успешной проверки источника бот покажет список чатов и каналов проекта в MAX — выберите тот, куда нужно транслировать контент.

⚠️ Бот-публикатор проекта должен быть админом с правом «Писать посты» в выбранном чате MAX. Если прав нет — публикация падает с ошибкой telegram_destination_max_bot_not_admin.

3.3. Выберите направление синхронизации

Бот предложит варианты:

Вариант	Описание	Когда использовать
→ Только TG → MAX	Посты из Telegram копируются в MAX	Основной режим. Подходит и для каналов, и для групп.
↔ Двунаправленный	Сообщения синхронизируются в обе стороны	Только для групп / супергрупп (для каналов кнопка не отображается). Используйте, если общение идёт на обеих платформах.

Нажмите нужную кнопку — интеграция будет создана, бот вернёт сообщение:

✅ Интеграция создана: <источник> → <чат MAX>
Новые сообщения будут пересылаться автоматически.

Шаг 4. Проверьте работу

Опубликуйте тестовый пост в Telegram-источнике.
Через несколько секунд он должен появиться в чате MAX.
Если поста нет — откройте интеграцию (нажмите её строку в списке) и проверьте поле Статус и блок Ошибка.

Самые частые причины:

платформенный бот не админ канала / не участник группы;
бот-публикатор не админ чата MAX или у него нет права «Писать посты»;
интеграция выключена (значок ⚪).

Управление интеграциями

Карточка интеграции

В меню «Контент из Telegram» нажмите на нужную строку. Откроется карточка с полями:

Направление: «из TG в MAX (→)» или «двунаправленный (↔)»;
Telegram: название и тип (channel / group / supergroup);
MAX: чат назначения;
Статус: активен, ожидает подключения, ошибка, выключен;
Активна: да / нет;
Последний синк: дата и время по МСК (или «ещё не было»);
⚠️ Ошибка: текст последней ошибки доставки, если она была.

Включение / выключение / удаление

В карточке интеграции:

⏸ Выключить — пауза. Новые посты в MAX не публикуются, но интеграция и история дедупликации сохраняются.
▶️ Включить — возобновление трансляции с новых постов.
🗑 Удалить — удаляет связку. Восстановить нельзя — нужно создавать заново.

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

Перенос старых постов из Telegram

Если у канала уже есть архив постов, который нужно опубликовать в MAX, перенесите его пересылом платформенному боту.

Как это работает

Убедитесь, что интеграция для канала создана и включена (🟢).
Откройте личный чат с платформенным ботом в Telegram (t.me/<username> из меню админ-бота).
Откройте Telegram-канал → Перешлите нужные посты в этот личный чат с ботом.

Бот:

определит исходный канал из метаданных пересланного сообщения (forward_origin / forward_from_chat);
найдёт активную интеграцию для этого канала;
опубликует пост в соответствующий чат MAX.

Сообщения, отправленные ботом в личке (не пересланные из канала с активной интеграцией), игнорируются.

Поддерживаемые типы контента

Тип	Поддержка
Текст с форматированием (Markdown)	✅
Фото	✅
Видео	✅
Видеосообщения / кружки	✅ (отправляются как обычное видео)
GIF / анимации	✅ (отправляются как видео)
Голосовые сообщения	✅
Аудио	✅
Документы и файлы	✅
Альбомы (несколько фото/видео)	✅ — группируются автоматически
Стикеры	❌
Опросы и реакции	❌

OGG/Opus-аудио (голосовые) на лету конвертируются в MP3 — на стороне MAX вы получите проигрываемое аудио.

Альбомы

Альбомы (несколько фото/видео в одном посте) собираются буфером ~2.5 секунды по media_group_id и публикуются единым сообщением. Перешлите все элементы альбома подряд, одним пакетом — Telegram сам сгруппирует их и отправит боту с общим media_group_id.

Защита от дублей

Каждый перенесённый пост запоминается по ключу telegram:<chat_id>:forward:<message_id>. Если вы случайно перешлёте тот же пост повторно — он будет помечен как duplicate и в MAX не попадёт.

Редактирование постов

При редактировании поста в Telegram-канале изменение транслируется в MAX (текст и медиа обновятся в исходном сообщении).

⚠️ Исключение — редактирование альбомов. Для альбомов изменения в MAX не подтягиваются (telegram_edited_albums_not_supported). Если нужно поправить альбом — удалите старый пост в MAX вручную и опубликуйте альбом заново.

Часто задаваемые вопросы

Можно ли подключить несколько Telegram-каналов к одному проекту?

Да. Создайте отдельную интеграцию на каждый источник.

Можно ли направить несколько каналов в один чат MAX?

Да. Укажите один и тот же чат MAX как назначение в нескольких интеграциях.

Можно ли направить один Telegram-канал в несколько чатов MAX?

Да. Создайте несколько интеграций с одним источником и разными назначениями — бот опубликует пост во все.

Можно ли использовать платформенного бота как обычного публикатора в MAX?

Нет. В MAX публикует бот-публикатор проекта (ваш клиентский бот MHUB). Платформенный Telegram-бот только читает Telegram.

Что произойдёт, если я удалю интеграцию и создам её заново?

Дедупликация старых пересланных постов сбрасывается: если перешлёте те же посты ещё раз — они опубликуются повторно. Используйте «⏸ Выключить», если нужна пауза без потери истории.

Бот не реагирует на пересланное сообщение в личке

Проверьте по очереди:

интеграция для исходного канала создана и включена (🟢);
сообщение действительно переслано из канала (а не скопировано или написано вручную);
у автора канала не отключена пересылка (тогда forward_origin приходит без chat_id и определить источник нельзя).

Я обновил пост — почему он не обновился в MAX?

Если это альбом — это ограничение, см. раздел «Редактирование постов». В остальных случаях откройте карточку интеграции в админ-боте и проверьте поле Ошибка.

Нужно ли что-то настраивать на стороне MAX?

Только один раз — добавить бот-публикатора проекта (вашего клиентского бота MHUB) администратором в чат назначения с правом «Писать посты».

← К документации Открыть бота в MAX