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

Обзор

MHUB позволяет автоматически транслировать контент из ваших Telegram-каналов и групп в чаты MAX. Вы можете:

• Настроить автоматическую трансляцию новых постов из Telegram в MAX
• Выбрать направление синхронизации: только из TG в MAX или двунаправленную
• Перенести старые посты из Telegram, переслав их боту

---

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

1. Проект в MHUB с настроенными тарифами и чатами доступа в MAX
2. Платформенный Telegram-бот — настраивается автоматически при создании проекта
3. Telegram-канал или группа, из которых вы хотите транслировать контент
4. Чат или канал в MAX, куда контент будет публиковаться

---

Шаг 1. Добавьте бота в Telegram-источник

Прежде чем настраивать интеграцию, добавьте платформенного бота администратором в ваш Telegram-канал или группу:

1. Откройте ваш Telegram-канал или группу
2. Перейдите в Настройки → Администраторы → Добавить администратора
3. Найдите платформенного бота (его username показан в меню «Контент из Telegram» в админ-боте)
4. Добавьте его с правами на чтение сообщений

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

---

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

1. Откройте диалог с админ-ботом в Telegram
2. Перейдите: Проекты → выберите нужный проект → Настройки → 📲 Контент из Telegram
3. Вы увидите экран управления интеграциями:
   • Список текущих интеграций (если есть)
   • Кнопку «➕ Добавить интеграцию»

---

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

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

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

• Username канала — в формате @mychannel
• Chat ID — числовой идентификатор (например, -1001234567890)

Отправьте одно из значений боту.

Бот проверит, что он добавлен в указанный канал или группу. Если проверка не пройдёт, вы увидите сообщение: «Не удалось проверить Telegram-источник. Убедитесь, что бот добавлен в канал, и попробуйте ещё раз.»

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

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

Убедитесь, что бот-публикатор добавлен администратором в выбранный чат MAX.

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

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

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

Нажмите нужную кнопку — интеграция будет создана.

---

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

После создания интеграции:

1. Опубликуйте тестовый пост в вашем Telegram-канале или группе
2. Через несколько секунд он должен появиться в выбранном чате MAX
3. Если пост не появился, проверьте:
   • Бот добавлен администратором в Telegram-источник
   • Бот-публикатор добавлен администратором в чат MAX
   • Интеграция включена (статус: «активен», зелёный кружок 🟢)

---

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

Просмотр статусов

На главном экране «Контент из Telegram» вы видите все интеграции:

• 🟢 — интеграция включена
• ⚪ — интеграция выключена
• Отображается направление: → (TG → MAX) или ↔ (двунаправленный)
• Статус синхронизации: активен, ожидает подключения, ошибка, выключен

Детали интеграции

Нажмите на интеграцию, чтобы увидеть подробности:

• Направление синхронизации
• Telegram-источник (имя, тип: канал или группа)
• Чат назначения в MAX
• Текущий статус и дата последней синхронизации
• Текст ошибки (если есть)

Включение и выключение

В деталях интеграции:

• ⏸ Выключить — приостановить трансляцию (посты перестанут публиковаться)
• ▶️ Включить — возобновить трансляцию

Удаление интеграции

Нажмите 🗑 Удалить в деталях интеграции. Удаление необратимо — для повторного подключения нужно будет создать интеграцию заново.

---

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

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

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

1. Убедитесь, что интеграция для нужного канала создана и включена
2. Откройте личный чат с платформенным ботом в Telegram
3. Перейдите в ваш Telegram-канал и перешлите нужные посты боту

Бот автоматически определит, из какого канала переслано сообщение, найдёт активную интеграцию и опубликует пост в соответствующий чат MAX.

Пересылка текстовых постов

1. Откройте пост в Telegram-канале
2. Нажмите «Переслать» (или используйте контекстное меню)
3. Выберите чат с платформенным ботом
4. Отправьте — пост будет опубликован в MAX

Пересылка медиа и альбомов

Система поддерживает все типы контента:

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

Альбомы (посты с несколькими фото или видео) обрабатываются автоматически — все медиа из одного альбома будут опубликованы как единый пост в MAX.

Порядок пересылки

• Пересылайте посты по одному или альбомами
• Рекомендуем пересылать посты в хронологическом порядке (от старых к новым), чтобы порядок контента в MAX соответствовал оригиналу
• Между пересылками нет ограничений по скорости, но рекомендуем делать небольшие паузы при массовой пересылке

Защита от дубликатов

Система автоматически отслеживает все перенесённые сообщения. Если вы случайно перешлёте один и тот же пост повторно — дубликат не будет опубликован в MAX.

Возможные проблемы

Проблема	Решение
Бот не реагирует на пересланное сообщение	Убедитесь, что интеграция для этого канала создана и включена
Пост не появляется в MAX	Проверьте, что бот-публикатор — администратор в чате MAX
Пересланное сообщение не из канала	Бот обрабатывает только пересылки из каналов и групп с активной интеграцией. Личные сообщения и пересылки из других источников игнорируются

---

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

При автоматической трансляции и пересылке поддерживаются:

• Текстовые посты — с сохранением форматирования
• Фотографии — загружаются в MAX в оригинальном качестве
• Видео — полностью перезагружаются в MAX
• Аудио и голосовые сообщения — передаются в MAX
• Документы и файлы — передаются без изменений
• Альбомы — несколько медиафайлов в одном посте группируются автоматически
• Редактирование постов — при изменении поста в Telegram обновление транслируется в MAX

---

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

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

Да. Вы можете создать несколько интеграций — каждая связывает один Telegram-источник с одним чатом MAX.

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

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

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

Новые посты из Telegram перестанут транслироваться в MAX. Уже опубликованные посты останутся на месте. При повторном включении трансляция возобновится с новых постов.

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

Бот-публикатор должен быть добавлен администратором в чат MAX, куда будет транслироваться контент. Это делается один раз при настройке.