Документация TgMaxGo

1. Что такое TgMaxGo

TgMaxGo — сервис для работы с Telegram и MAX в двух сценариях.

Кросспостинг: вы публикуете в одном канале — пост автоматически появляется в связанном канале на другой платформе (TG ↔ MAX). Направление настраивается: в обе стороны, только TG → MAX или только MAX → TG.

Автопостинг: создавайте посты в личном кабинете — выберите один или несколько каналов, оформите текст, прикрепите медиа и опубликуйте сразу или по расписанию. Календарь показывает запланированные публикации.

Для работы используются боты самого сервиса. Вам не нужно создавать своих ботов и вводить токены на сайте.

2. Регистрация

На главной странице нажмите «Начать бесплатно», укажите email и пароль.

На почту придёт письмо с кнопкой «Подтвердить email». Перейдите по ссылке — после этого аккаунт будет подтверждён.

Если письма нет, проверьте папку «Спам». Повторную отправку можно запросить через поддержку.

Пробный период 14 дней. Оплата тарифов — в разделе «Подписка» через ЮKassa.

3. Как устроено подключение

У TgMaxGo два центральных бота — для Telegram и для MAX. Их имена отображаются в личном кабинете в разделе «Платформы».

Вы добавляете этих ботов в свои каналы и группы и выдаёте им права администратора (с возможностью публиковать сообщения).

Затем на сайте подтверждаете каждый канал: сервис проверяет, что бот действительно является администратором.

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

1. Добавить бота TgMaxGo в канал/группу
2. Подтвердить канал на сайте
3. Связать TG и MAX в одну пару
4. Публиковать посты как обычно — синхронизация идёт сама

4. Подключение Telegram

Откройте личный кабинет → «Платформы». Вверху страницы указано имя Telegram-бота сервиса (например, @ваш_бот).

1. Добавьте этого бота в свой Telegram-канал или группу
2. Назначьте бота администратором с правом публикации сообщений
3. В блоке «Проверить Telegram» укажите @username канала или числовой chat id
4. Нажмите «Проверить Telegram» — при успехе канал появится в списке «Мои каналы»

Свой токен бота вводить не нужно. Если проверка не проходит — убедитесь, что бот добавлен именно в тот канал, который указали, и что у него есть права администратора.

5. Подключение MAX

В том же разделе «Платформы» указано имя бота TgMaxGo для MAX.

Публичный канал с коротким именем можно указать ссылкой max.ru/имя или самим именем — API MAX позволяет проверить канал по публичной ссылке.

Групповой чат и канал без публичного имени по ссылке не проверяются — нужен числовой chat_id. Откройте чат в web.max.ru: число в адресе после слеша (часто с «−» в начале) — это ID. Вставьте его в поле проверки целиком, со знаком минус.

1. Добавьте бота сервиса в нужную группу или канал в MAX
2. Выдайте боту права администратора
3. Для публичного канала — укажите max.ru/имя или короткое имя; для группы или закрытого канала — chat_id из адреса web.max.ru
4. В блоке «Проверить MAX» вставьте ссылку, имя или ID и нажмите «Проверить MAX»

Токен API и своего бота MAX указывать не нужно — работает только бот TgMaxGo. ID копируйте вместе со знаком «−», если он есть в адресе.

6. Связка каналов

Когда и Telegram, и MAX подтверждены, создайте связку в блоке «Связать каналы».

Подключение каналов и создание связок доступны только после подтверждения email в разделе «Аккаунт».

1. Укажите название связки (для себя, например «Основной блог»)
2. Выберите подтверждённый Telegram-канал и канал MAX
3. Выберите направление: в обе стороны, только TG → MAX или только MAX → TG
4. При необходимости задайте хэштеги для игнорирования (см. ниже)
5. Нажмите «Создать связку»

Количество каналов (связок TG ↔ MAX) ограничено тарифом: Стартовый — 2, Профессиональный — 5, Бизнес — 10. Лимит публикаций из кабинета и API в месяц: пробный — 10, Стартовый — 30, Профессиональный — 100, Бизнес — 500. Авторепост по связке в лимит публикаций не входит.

7. Первая синхронизация

После создания связки опубликуйте тестовый пост в исходном канале (в том направлении, которое вы выбрали).

Пост должен появиться в целевом канале в течение нескольких секунд.

Статус доставки можно посмотреть в разделе «История» личного кабинета.

Синхронизируются только новые посты после создания связки. Старые сообщения задним числом не переносятся. Для первого теста используйте текст + фото или текст + видео.

8. Фильтр по хэштегам

Для каждой связки можно указать до 5 хэштегов. Если пост содержит любой из них, он не будет переслан в другой канал.

Это удобно для рекламных публикаций, локальных анонсов или контента, который не нужно дублировать.

1. При создании связки заполните поле «Игнорировать хэштеги» или отредактируйте его у существующей связки
2. Укажите теги через запятую, с # или без — например: #реклама, nosync
3. Нажмите «Сохранить фильтр»

Фильтр проверяет хэштеги в тексте поста. Регистр не важен: #Реклама и #реклама считаются одинаково.

9. Пауза и удаление

У каждой связки есть кнопка «Приостановить» — синхронизация временно остановится, настройки сохранятся.

«Удалить» у связки полностью убирает пару каналов из синхронизации.

Канал из списка «Мои каналы» можно удалить отдельно, но только если он не используется ни в одной связке — сначала удалите связку.

10. История публикаций

В личном кабинете откройте раздел «История». Две вкладки: «Кросспостинг» — пересланные посты между связанными каналами; «Автопостинг» — публикации из редактора (черновики, запланированные и отправленные).

Для кросспостинга отображаются исходная и целевая платформа, текст и статус доставки (отправлен, в очереди, ошибка). При сбое система повторяет отправку автоматически.

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

11. Решение проблем

Ниже — частые причины, почему синхронизация не срабатывает.

1. Проверка канала не проходит — бот не админ или указан неверный @канал / chat id
2. MAX: по ссылке max.ru проверяется только публичный канал — для группы или канала без имени укажите числовой chat_id из адреса web.max.ru (со знаком «−»)
3. Пост не пересылается — связка приостановлена или направление не включает эту сторону (например, пост в MAX при настройке только TG → MAX)
4. Пост пропущен намеренно — в тексте есть хэштег из фильтра игнорирования
5. Не удаётся создать связку — достигнут лимит тарифа, удалите лишнюю связку
6. Не удаётся подключить канал или мессенджер — подтвердите email в разделе «Аккаунт»
7. Пост без текста только с медиа не дошёл — проверьте «Историю»: если вложение не удалось скачать/загрузить, доставка помечается ошибкой, пустой пост не отправляется
8. Файл больше 250 МБ — сожмите видео; фото в MAX ограничены 50 МБ

12. Поддерживаемые типы постов

Сервис стабильно синхронизирует: текст, текст с форматированием, фото, видео, аудио, голосовые, документы и альбомы.

Размер одного вложения — до 250 МБ (видео/файлы). Фото в MAX — до 50 МБ (лимит платформы).

Дополнительно поддерживаются: Telegram video_note (круглое видео), GIF/анимации и видео-документы (document с mime video/*).

Стикеры поддерживаются частично: видео-стикеры пересылаются как видео, остальные — как файл-вложение.

Не поддерживаются как отдельные типы: опросы, геопозиция, контакты, dice/game и другие сервисные форматы.

Если важен конкретный формат поста, сначала сделайте тест в связке на черновом канале.

16. Безопасность

TgMaxGo не просит и не хранит токены ваших ботов. Подключение идёт только через официальных ботов сервиса с правами администратора в ваших каналах.

Вы в любой момент можете удалить бота TgMaxGo из канала или удалить связку на сайте — синхронизация прекратится.

Используйте надёжный пароль для аккаунта на tgmaxgo.ru. Ссылка для сброса пароля действует 1 час.

13. Создание поста

В разделе «Создать пост» выберите один или несколько каналов (Telegram и/или MAX из разных связок) — пост уйдёт во все отмеченные.

Панель форматирования над полем текста: жирный, курсив, ссылки и другие элементы с подсказками о совместимости TG и MAX. Есть вставка эмодзи.

Напишите текст, при необходимости прикрепите медиа (до 250 МБ на файл) и проверьте предпросмотр справа.

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

Опубликованные и запланированные посты отображаются во вкладке «Автопостинг» в «Истории» и в календаре.

14. Календарь публикаций

Календарь показывает запланированные и уже опубликованные посты из редактора.

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

Клик по событию открывает пост в редакторе для просмотра или правки (если статус позволяет).

15. AI-ассистент

В редакторе поста кнопка «Сгенерировать» создаёт текст на основе черновика и ваших настроек. «Дополнить» улучшает существующий текст.

Кнопка «Настройки» открывает модалку: тон голоса бренда, промпт по умолчанию, язык, длина и стиль.

Расход учитывается в AI-токенах — месячный пул зависит от тарифа. Прогресс виден в разделах «Подписка», «Аккаунт» и в редакторе поста. Когда пул исчерпан, кнопки генерации блокируются до сброса в начале месяца или смены тарифа.

Ориентир по тарифам: пробный — 50K, Стартовый — 150K, Профессиональный — 500K, Бизнес — 1M токенов в месяц. Короткий пост расходует меньше, длинный черновик и «длинный» стиль — больше.

Лимит публикаций из кабинета и API в месяц: пробный — 10, Стартовый — 30, Профессиональный — 100, Бизнес — 500. Авторепост по связке не считается.

18. Publish API

Publish API позволяет публиковать посты в Telegram и MAX из своих скриптов, CRM или внутренних сервисов. Доступен на тарифах Профессиональный и Бизнес.

Токен не создаётся автоматически: откройте раздел «Поддержка» в кабинете и запросите API-токен. После выдачи откроется полная документация в разделе «Документация → API».

Запросы к /api/v1/* авторизуются заголовком Authorization: Bearer tgm_… Токен храните как секрет: не коммитьте в git и не вставляйте в клиентские приложения.

Публикации через API считаются в общий месячный лимит кабинета (на Профессиональном — 100, на Бизнесе — 500 в месяц). Посты видны во вкладке «API» в «Истории».

1. Оформите тариф Профессиональный или Бизнес
2. В «Поддержке» создайте тикет с темой «API-токен»
3. Получите токен и откройте «Документация → API» для примеров curl
4. Вызовите /v1/targets для списка pairId и platform, затем /v1/publish

При перевыпуске токена старый перестаёт работать сразу. Отозвать токен можно через поддержку.

17. Техподдержка

Напишите на support@tgmaxgo.ru или откройте раздел «Поддержка» в личном кабинете.

Укажите email аккаунта, названия связанных каналов, направление синхронизации и время, когда пост не переслался. Приложите скриншот поста, если возможно.