Зеркала публикаций¶

Зеркало публикаций автоматически переносит новые посты из Telegram в выбранное сообщество ВКонтакте. Достаточно опубликовать новость один раз: PulseCaster подготовит текст, загрузит доступные вложения и создаст запись в ВК.

Зеркало пригодится, если вы:

ведёте Telegram-канал или группу вместе с сообществом ВК;
публикуете новости, расписание, анонсы, фотографии и видео;
хотите экономить время на повторной загрузке одного и того же поста;
хотите видеть результат каждой публикации и понятную причину, если часть вложений не перенеслась.

Зеркала работают отдельно от Twitch-подписок. Подписка сообщает о начале стрима, а зеркало переносит обычные публикации Telegram. Анонсы PulseCaster тоже можно включить, но по умолчанию они не дублируются.

Нужна помощь разработчика?

Напишите mrgorkiy в Telegram. Укажите страницу, ожидаемый результат, что произошло и шаги для повторения. Можно приложить скриншот или короткое видео. Перед отправкой закройте токены, коды подтверждения и приватные ссылки OBS.

Что происходит после подключения¶

Вы связываете один источник в Telegram с одним сообществом ВК. После включения зеркало получает только новые публикации и переносит их на выбранную стену.

Зеркало не загружает старую историю канала. Сообщения, опубликованные до создания зеркала или пока оно было на паузе, позже не догружаются.

Что переносится¶

Публикация в Telegram	Результат во ВКонтакте
Текст и подпись	текст поста; скрытые ссылки становятся видимыми
Заголовки, абзацы, списки и цитаты	читаемый текст с сохранённой структурой
Фотография или альбом	одна запись, до 10 фотографий и видео
Видео или кружок	видео в записи
GIF	анимация или видео
Документ, аудио или голосовое сообщение	файл с понятной подписью; если VK не разрешил загрузку — ссылка на исходное сообщение
Обычный стикер	изображение
Анимированный стикер	статичная обложка или emoji
Опрос	опрос ВК; если формат не подходит — вопрос и варианты текстом
Контакт, место или геопозиция	понятное описание; для геопозиции сохраняются координаты

Если ВК не принимает одно вложение, PulseCaster сохраняет всё остальное. Например, текст и восемь фотографий могут быть опубликованы, даже если девятую фотографию загрузить не удалось. Для файла, аудио или голосового сообщения PulseCaster добавит ссылку Открыть в Telegram, чтобы содержимое не потерялось полностью. Такая запись получит результат Частично, а причина появится в истории зеркала.

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

Возможности зависят от разрешений VK

После подключения PulseCaster показывает доступ к фотографиям, видео, документам, опросам и стене. Если рядом с типом содержимого показано ограничение, остальные части публикации всё равно могут переноситься.

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

В Telegram¶

канал, группа или отдельная тема группы;
Telegram-бот PulseCaster;
права администратора у вас и у выбранного бота;
Chat ID источника;
Topic ID, только если нужно переносить одну тему группы.

Бот получает публикации из источника, но не пишет в него от вашего имени.

Во ВКонтакте¶

сообщество, в котором вы можете публиковать записи;
аккаунт VK с правами администратора или редактора этого сообщества.

PulseCaster откроет официальное окно VK, попросит подтвердить доступ и покажет подходящие сообщества. Копировать ключ вручную и искать Owner ID при обычном подключении не нужно.

Как создать зеркало¶

На главной странице найдите раздел Зеркала публикаций, нажмите Создать и пройдите три шага.

Шаг 1. Укажите источник в Telegram¶

Добавьте выбранного бота PulseCaster в канал или группу.
Назначьте бота администратором.
Убедитесь, что ваш Telegram-аккаунт тоже является администратором.
Выберите бота в мастере и укажите Chat ID.
Для одной темы дополнительно укажите Topic ID.
Нажмите Проверить права.

Как узнать Chat ID¶

Есть два способа:

Переслать сообщениеКоманда в источнике

Откройте личный чат с ботом PulseCaster.
Перешлите ему любое сообщение из нужного канала или группы.
Бот пришлёт Chat ID, тип чата и Topic ID, если сообщение было опубликовано в теме.

Добавьте бота PulseCaster в нужный канал или группу.
Отправьте команду /get_chat_id прямо в этом источнике.
Скопируйте Chat ID из ответа бота.

Используйте команду, если Telegram скрывает источник пересланного сообщения. Копируйте число полностью, включая -100 в начале. Для всего канала или группы оставьте Topic ID пустым.

После успешной проверки PulseCaster покажет название источника и роли администратора:

Шаг 2. Подключите VK¶

Нажмите Подключить VK.
Подтвердите доступ в официальном окне VK.
Вернитесь в PulseCaster — мастер обновится автоматически.
Выберите сообщество в поле Куда публиковать.

В списке отображаются только сообщества, где подключённый аккаунт может публиковать записи. Под выбором назначения показаны доступные типы содержимого. Зелёная отметка означает, что возможность доступна; предупреждение означает, что такой тип вложений может переноситься не полностью.

Если нужного сообщества нет, проверьте свою роль администратора или редактора и нажмите Переподключить.

Ручное подключение оставлено как запасной способ. В этом случае адрес стены и ключ доступа вводятся самостоятельно, а список сообществ не заполняется автоматически.

Шаг 3. Выберите правила публикации¶

Настройка	Что она делает
Подпись автора	не добавляет имя автора либо ставит его в начале или конце публикации
Переносить анонсы стримов	отправляет в ВК также посты PulseCaster о начале стрима
Синхронизировать редактирования	обновляет уже созданную запись ВК после изменения поста в Telegram
Активировать сразу	начинает переносить новые публикации сразу после создания

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

Если Twitch-подписка уже отправляет анонсы напрямую во ВКонтакте, не включайте их перенос в зеркале: иначе один анонс может появиться дважды.

Удаление Telegram-поста сейчас не удаляет запись ВК. Telegram не сообщает боту об удалении обычных публикаций, поэтому этот переключатель недоступен.

Нажмите Создать зеркало, чтобы завершить подключение.

Тестовая публикация¶

На шаге VK можно включить проверку реальной публикацией. После создания такая же проверка доступна на странице зеркала по кнопке Тестовая публикация.

PulseCaster создаст короткую запись на выбранной стене и сразу попробует удалить её. Если VK разрешил публикацию, но не разрешил удаление, в истории появится ссылка на оставшийся тестовый пост.

История и статусы¶

На странице зеркала хранится история за последние 30 дней:

создание и изменение настроек;
тестовые проверки;
успешные и частичные публикации;
ошибки и их причины;
ручные повторы отправки.

Статус	Что означает
Активно	зеркало готово переносить новые публикации
Пауза	новые публикации временно не принимаются
Требует внимания	последняя публикация перенеслась частично или завершилась ошибкой
Опубликовано	вся поддерживаемая публикация перенесена
Частично	запись создана, но одно или несколько вложений пропущены
Ошибка	запись не создана; после проверки причины отправку можно повторить
Пропущено	публикация защищена от сохранения или не предназначена для переноса

Временные ошибки PulseCaster повторяет автоматически. Кнопка Повторить появляется, если автоматические попытки не помогли.

Редактирование публикаций¶

Если включена синхронизация редактирований, изменение исходного Telegram-поста обновит уже созданную запись ВК. PulseCaster сохраняет связь между публикациями, поэтому новая запись вместо старой не создаётся.

Удаление исходной публикации не удаляет пост ВК.

Ограничения¶

перенос начинается с момента создания и включения зеркала;
за один раз в публикацию ВК добавляется не более 10 фотографий и видео;
максимальный размер файла зависит от подключения Telegram: облачный API — до 20 МиБ, локальный — по настройке сервиса (до 200 МиБ);
защищённые от сохранения публикации не переносятся;
новый или редкий формат Telegram может быть перенесён частично;
документы, аудио и голосовые сообщения требуют соответствующего разрешения VK;
старые сообщения и публикации, пропущенные во время паузы, не догружаются;
удаление Telegram-поста не удаляет запись ВК.

Если публикация не появилась¶

Что произошло	Что сделать
Зеркало стоит на паузе	включите зеркало на его странице
Сообщение было создано раньше зеркала	отправьте новую тестовую публикацию в Telegram
Указана не та тема	проверьте `Topic ID`; для всего чата оставьте его пустым
Telegram не проходит проверку	верните права администратора себе и выбранному боту
Нужного сообщества нет в списке	проверьте свою роль в VK и переподключите аккаунт
Перенеслась только часть поста	откройте публикацию в истории и посмотрите, какое вложение не принято
Документ или голосовое сообщение не прикрепилось	используйте ссылку на Telegram в записи; затем переподключите VK и проверьте доступ к документам
VK временно недоступен	дождитесь автоматического повтора или используйте кнопку `Повторить`

Пауза и удаление зеркала¶

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

При удалении зеркала его настройки и история удаляются из PulseCaster. Уже опубликованные записи во ВКонтакте остаются на месте.