Подписка¶
Подписка — это первый этап подключения канала к PulseCaster. Здесь создаётся связь с Twitch-каналом,
выбираются площадки для публикации анонсов и настраивается вид постов: текст, кнопка и картинка.
Страницу удобно делить на две большие части:
- Базовое подключение — создать подписку, выбрать Telegram/VK, подтвердить канал и проверить права.
- Настройки подписки — настроить тексты публикаций, кнопки, картинки и оформление.
Если посты в Telegram не нужны, снимите галочку Telegram при создании подписки или позже выключите Telegram
в Каналы публикации. Подписка останется полезной для канала, даже если все публикации временно отключены.
Нужна помощь разработчика?
Напишите mrgorkiy в Telegram. Укажите страницу, ожидаемый результат, что произошло и шаги для повторения. Можно приложить скриншот или короткое видео. Перед отправкой закройте токены, коды подтверждения и приватные ссылки OBS.
Как устроена подписка¶
| Блок | Для чего нужен |
|---|---|
| Создание подписки | добавить Twitch-канал и выбрать, куда отправлять анонсы |
| Подтверждение владения | доказать, что вы управляете каналом |
| Каналы публикации | включить или выключить Telegram и VK без пересоздания подписки |
| Доступ бота к чату | проверить, может ли бот публиковать и редактировать Telegram-посты |
| Настройки подписки | управлять текстами, кнопками и изображениями постов |
| Управление подпиской | удалить подписку, если канал больше не нужен |
Рекомендуемый порядок¶
Базовое подключение¶
Базовое подключение отвечает на простой вопрос: какой Twitch-канал подключаем и куда PulseCaster должен отправлять посты.
1. Создайте подписку¶
На экране создания укажите Twitch-канал без ссылки, например:
PulseCaster проверит, что такой канал существует. После этого выберите Каналы публикации.
| Вариант | Когда выбирать |
|---|---|
| Telegram | нужны посты в Telegram-канал, группу, топик или личные сообщения |
| VK | нужны посты на страницу или в сообщество ВК |
| Telegram + VK | один и тот же стрим нужно анонсировать в обе площадки |
| Все галочки сняты | посты не нужны, подписка создаётся без публикаций |
Если вы не хотите Telegram-посты, снимите галочку Telegram. Это нормально: подписку можно создать только для канала
и позже включить публикации, когда они понадобятся.
2. Настройте Telegram, если он нужен¶
Для Telegram выберите, куда отправлять уведомления:
| Поле | Что означает |
|---|---|
| Канал или группа | посты идут в Telegram-канал, группу или супергруппу |
| Личные сообщения | посты идут в личный чат с ботом |
| Chat ID | адрес чата, куда отправлять посты |
| Topic ID | номер темы в группе, если посты должны идти в конкретный топик |
| Бот | бот, который будет публиковать сообщение |
Как получить Chat ID:
- Добавьте PulseCaster Bot в нужный канал или группу.
- Дайте боту право отправлять сообщения.
- Перешлите сообщение из этого чата боту.
- Бот ответит
Chat ID, тип чата иTopic ID, если он есть. - Скопируйте значения в форму подписки.
Для канала или группы добавьте бота администратором. Для обычных публикаций нужны права на отправку сообщений, а для обновления поста после смены названия, категории или завершения стрима — ещё и право редактировать сообщения.
3. Настройте VK, если он нужен¶
Основной путь — кнопка Подключить VK: пройдите авторизацию VK ID, вернитесь в приложение и выберите
сообщество в Куда публиковать. В списке доступны сообщества, в которых аккаунт может публиковать.
Токен сохраняется на сервере; копировать его вручную для этого способа не нужно.
Ручной ввод остаётся резервным способом:
| Поле | Что означает |
|---|---|
| Owner ID | куда публиковать: личная страница или сообщество |
| Access token | разрешение на публикацию |
Для личной страницы Owner ID обычно положительный, например 12345.
Для сообщества используйте отрицательный ID, например -12345.
Если планируете публиковать посты с картинками, заранее проверьте, что VK-доступ подходит для публикации записей и загрузки изображений. Если сомневаетесь, начните с текстовых постов, а картинки включите позже.
4. Добавьте первую кнопку¶
При создании подписки можно сразу указать Текст кнопки под уведомлением.
Например:
Смотреть стримОткрыть TwitchЗалететь на эфирПерейти на канал
Кнопка ведёт зрителя на Twitch-канал. Если оставить поле пустым, будет использоваться кнопка по умолчанию. Позже можно добавить свои варианты в настройках.
5. Подтвердите владение каналом¶
После создания подписки откройте её карточку. Вверху есть блок Подтвердите владение.
Есть два способа.
| Способ | Когда использовать | Что даёт |
|---|---|---|
| Авторизация владельца Twitch | основной вариант | подтверждает канал и позволяет выбрать права для нужных функций |
Команда !code |
запасной вариант | быстро подтверждает владение, если авторизация сейчас недоступна |
Авторизация владельца Twitch¶
Нажмите Выбрать права, отметьте нужные функции, затем войдите в Twitch под владельцем канала и подтвердите доступ.
После успеха на странице появится статус вроде Подключено: login.
Если позже появится кнопка Обновить права, нажмите её: токен продолжает работать, но одной из включённых функций
нужно дополнительное разрешение. Набор можно как расширить, так и уменьшить.
Команда !code¶
- Нажмите
Сгенерировать код. - Скопируйте команду вида:
- Отправьте её в чат вашего Twitch-канала.
- Вернитесь на страницу подписки.
После успешной проверки появится статус Канал подтвержден.
Если канал уже подтверждён другим пользователем, подписчик видит статус Владение уже подтверждено,
но не получает кнопку изменения OAuth-прав владельца. Управлять Twitch-подключением может только тот пользователь,
за которым закреплено владение каналом; поэтому страница не выполняет заведомо запрещённую проверку и не показывает
техническую ошибку Forbidden.
Что выбрать
Если можете пройти авторизацию владельца Twitch, выбирайте её. !code удобен как запасной путь,
а OAuth нужен только тем возможностям владельца, которые вы сами разрешите.
6. Проверьте права Telegram-бота¶
Если Telegram включён, после создания подписки на странице появится блок Доступ бота к чату.
Проверьте два пункта:
| Проверка | Зачем нужна |
|---|---|
| Публикация новых постов | бот сможет создать анонс стрима |
| Редактирование постов | бот сможет обновить тот же пост при изменениях стрима |
Нормальное состояние — оба пункта показывают, что доступ есть.
Если доступа нет:
- Откройте ваш Telegram-канал или группу.
- Перейдите в настройки администраторов.
- Добавьте выбранного бота.
- Дайте права на отправку и редактирование сообщений.
- Вернитесь в PulseCaster и нажмите
Проверить доступ.
Если Telegram выключен, этот блок можно не настраивать.
7. Как редактировать базовое подключение позже¶
Откройте подписку и нажмите Управление каналами публикации.
Там можно:
- включить или выключить Telegram;
- заменить
Chat ID; - добавить или убрать
Topic ID; - выбрать другого бота;
- включить или выключить VK;
- заменить
Owner ID; - заменить VK token;
- отключить все площадки публикации.
Если все площадки выключены, PulseCaster не будет отправлять анонсы, но сама подписка останется. Это удобно для паузы, тестового канала или ситуации, когда посты временно не нужны.
Настройки подписки¶
Настройки подписки отвечают за то, как выглядят публикации: какие события публиковать, какой текст использовать, какая кнопка будет под постом и будет ли картинка.
В настройках подписки откройте редактор Посты о стриме. Он состоит из трёх областей:
Когда обновлять пост— выбор события стрима.- Редактор выбранного события — переключатель, текст и
Кнопка под постом. Как увидят зрители— предпросмотр для Telegram и VK.
Настройки получателя открываются через Настроить отправку, оформление изображения — через Настроить обложку.
После правок нажмите Сохранить изменения внизу страницы. Переключение между событиями сохраняет черновики
в редакторе, но применяются они только после сохранения. Отменить изменения возвращает последние сохранённые значения.
1. Как публикуются уведомления¶
PulseCaster работает по модели одного поста на стрим.
Обычно это выглядит так:
- Стрим начался — создаётся стартовый пост.
- Название или категория поменялись — этот же пост редактируется.
- Стрим закончился — этот же пост обновляется финальным текстом.
Так канал не перегружает подписчиков отдельными сообщениями, а один пост остаётся актуальным.
2. Типы сообщений¶
В настройках можно включать и выключать отдельные типы сообщений.
| Тип | Когда срабатывает | Когда включать |
|---|---|---|
| Начало стрима | стрим начался | почти всегда включён |
| Название и игра | одновременно изменились название и категория | если часто меняете формат по ходу стрима |
| Новое название | изменилось только название | если название важно для зрителей |
| Новая игра | изменилась только категория | если на канале часто меняются игры |
| Завершение стрима | стрим закончился | если хотите оставлять финальное состояние поста |
Если вы хотите максимально тихую подписку, оставьте Начало стрима и выключите часть обновлений.
Если канал часто меняет игру или рубрику, включите обновления, чтобы пост не устаревал.
Название и игра использует отдельный шаблон: тексты Новое название и Новая игра в этом случае не объединяются.
3. Шаблоны текста¶
У каждого типа сообщения есть свой шаблон. В шаблон можно писать обычный текст и специальные теги.
| Тег | Что вставит |
|---|---|
{channel} |
название Twitch-канала |
{stream_name} |
текущее название стрима |
{game_name} |
текущую категорию |
{old_stream_name} |
предыдущее название |
{old_game_name} |
предыдущую категорию |
{history_game} |
историю категорий стрима |
Пример стартового сообщения:
Пример обновления категории:
4. Форматирование текста¶
В шаблонах поддерживается простое оформление:
| Запись | Что делает |
|---|---|
<b>текст</b> |
делает текст жирным |
<i>текст</i> |
делает текст курсивом |
<code>текст</code> |
показывает текст моноширинным |
В визуальном редакторе используйте кнопки форматирования и вставку переменных. При работе с исходным шаблоном
пишите HTML-теги в самом шаблоне: теги внутри подстановок вроде {stream_name} не применяются.
Советы:
- не делайте весь пост жирным;
- оставляйте пустую строку между заголовком и деталями;
- ставьте самую важную информацию в первые две строки;
- не делайте шаблон слишком длинным, особенно для Telegram.
5. Превью сообщения¶
В блоке Как увидят зрители выберите Telegram или VK. Для VK отображаются обычный текст и ссылка на стрим вместо Telegram-кнопки.
Проверяйте его после изменений:
- читается ли заголовок;
- не выглядит ли пост слишком длинным;
- нормально ли подставляются теги;
- не забыли ли вы включить нужный тип сообщения;
- не остались ли в тексте случайные тестовые слова.
Текст предпросмотра использует тестовые данные стрима. Обложка, если включена, использует текущие настройки и данные канала.
Переключение Telegram/VK меняет только пример: отправку включают отдельно через Настроить отправку.
6. Кнопки под постом¶
Раскройте Кнопка под постом в редакторе Посты о стриме, чтобы управлять вариантами подписи.
Изменения кнопок сохраняются вместе с текстами через Сохранить изменения.
В каждом уведомлении показывается одна случайная кнопка из списка.
Если список пустой, используется кнопка по умолчанию. Пустые и повторяющиеся подписи сохранить нельзя.
В предпросмотре можно выбрать вариант кнопки — это меняет только пример. После завершения эфира кнопка становится СТРИМ ЗАВЕРШИЛСЯ.
Кнопки нужны, чтобы зритель быстрее перешёл на стрим.
Хорошие варианты:
Смотреть стримОткрыть TwitchНа эфирВлететь в чатПерейти на канал
Плохие варианты:
- слишком длинный текст;
- несколько призывов в одной кнопке;
- текст, который непонятен новым зрителям;
- капс ради капса.
В списке кнопок можно:
- добавить новую кнопку;
- удалить лишнюю кнопку.
7. Изображения для постов¶
В редакторе Посты о стриме нажмите Настроить обложку, если хотите, чтобы анонс выходил с картинкой.
Есть три режима:
| Режим | Что происходит | Когда выбирать |
|---|---|---|
| Только текст | пост выходит без изображения | быстрый строгий анонс, минимум риска |
| Обложка игры | генерируется обложка по текущей категории | хороший режим по умолчанию |
| Игра и ваш фон | используется библиотека ваших картинок | когда нужен фирменный стиль канала |
В режиме Только текст картинка не генерируется.
В режимах с картинкой появляется конструктор: цвета, градиенты, позиционирование, тени, рамки, логотип и другие элементы.
Для собственного дизайна откройте на этой странице карточку Редактор обложки — он описан ниже.
Если обложка уже сохранена в редакторе, Настроить обложку открывает его сразу.
Редактор обложки¶
Редактор собирает картинку к посту из слоёв — как в графическом редакторе, только проще. Одна и та же обложка уходит в Telegram и VK.
Что можно добавить на холст:
Категория Twitch— постер текущей игры. Если у категории нет картинки, можно показать стандартную картинку Twitch, свою запасную или скрыть слой;Аватар канала;Метка 18+— стандартная или своя, показывается только на стримах 18+ или всегда;Медиа— картинки из вашей библиотеки. РежимСлучайный файл для каждого поставыбирает одну из нескольких (до 12) для каждого стрима; внутри одного поста картинка не меняется;- текст, прямоугольник, круг и заливку: сплошной цвет или градиент.
В тексте работают переменные {stream_title}, {category} и {channel} — их можно вставить кнопками
Название, Категория, Канал. Длинный текст переносится и уменьшается, чтобы поместиться в рамку.
Слои перетаскиваются прямо на холсте, тянутся за угол и поворачиваются. Для каждого слоя есть видимость, закрепление, порядок, дублирование, отражение, прозрачность, кадрирование, скругление, обводка, тень и свечение. Центр и направление градиента тоже двигаются на холсте ручками.
Блок Проверить будущие посты показывает обложку на других данных: длинное название, другая категория, категория
без картинки или свой пример. Это меняет только предпросмотр.
Изменения остаются черновиком, пока вы не нажмёте Сохранить обложку. Выключатель Прикреплять картинку к посту
отключает картинку, но сохраняет композицию. Уже опубликованные посты сохранение не меняет: новая обложка появится
в следующем посте или при обновлении текущего.
8. Конструктор изображения¶
В конструкторе можно:
- выбрать пресет;
- сбросить настройки к дефолту;
- настроить фон, градиент, рамки и тени;
- включить или выключить элементы;
- обновить предпросмотр;
- сохранить параметры генерации;
- сохранить режим публикации.
Если вы переключили режим изображения, сначала нажмите Сохранить режим.
После этого настройте параметры генерации и сохраните их отдельно.
Не забывайте два сохранения
Для картинок есть два разных действия: сохранить режим публикации и сохранить параметры генерации. Если поменяли и режим, и внешний вид, проверьте, что нажали обе кнопки.
9. Библиотека изображений¶
Библиотека используется в режиме Игра и ваш фон.
Можно:
- загрузить один или несколько файлов;
- загрузить папку;
- перетащить файлы в зону загрузки;
- выбрать изображение для предпросмотра;
- удалить лишнее изображение.
Поддерживаются .jpg, .jpeg и .png.
В библиотеке есть лимит, поэтому храните там только то, что реально используется в оформлении постов.
10. Как выбрать хороший режим¶
| Ситуация | Рекомендуемый режим |
|---|---|
| Нужно просто сообщить о стриме | Только текст |
| Хочется аккуратный визуал без ручной подготовки | Обложка игры |
| У канала есть свои фоны и стиль | Игра и ваш фон |
| Нужен свой дизайн: текст, градиенты, случайные фоны | Редактор обложки |
| Часто меняются игры | Обложка игры |
| Важна максимальная скорость и минимум ошибок | Только текст |
Перед первым настоящим стримом сделайте предпросмотр на мобильном экране. Если текст плохо читается, упростите фон, уменьшите количество эффектов или вернитесь к текстовому режиму.
Удаление подписки¶
В блоке Управление подпиской есть кнопка Удалить подписку.
Используйте её только если вы точно хотите остановить подписку для канала. После удаления:
- публикации перестанут приходить;
- канал исчезнет из списка подписок;
- настройки придётся создавать заново, если вы захотите вернуть подписку.
Если нужно просто временно остановить посты, лучше выключить Telegram и VK в Каналы публикации.
Чеклист перед первым стримом¶
- Twitch-канал указан правильно;
- если посты не нужны, лишние площадки публикации выключены;
- если Telegram включён, бот добавлен в чат;
- права публикации и редактирования Telegram показывают доступ;
- канал подтверждён через Twitch или
!code; - стартовое сообщение включено;
- шаблон стартового сообщения читается в превью;
- кнопка короткая и понятная;
- если включены картинки, предпросмотр выглядит нормально;
- после изменений нажаты нужные кнопки сохранения.
Если что-то не работает¶
| Симптом | Где смотреть сначала |
|---|---|
| Не получается создать подписку | проверьте имя Twitch-канала и выбранные площадки публикации |
| Telegram не нужен, но форма просит данные | снимите галочку Telegram |
| Пост не пришёл в Telegram | Каналы публикации, Chat ID, выбранный бот и права публикации |
| Пост пришёл, но не обновляется | право бота на редактирование сообщений |
| Пост не пришёл в VK | включён ли VK, правильно ли указан Owner ID и сохранён ли token |
| Кнопка не та или её нет | Настройки подписки → Кнопки для поста |
| Текст выглядит странно | шаблон сообщения, теги и предпросмотр |
| Картинка не появилась | режим изображения и сохранение режима публикации |
| Картинка выглядит плохо | настройки генерации и предпросмотр |
Канал подтверждён через !code, но часть функций владельца недоступна |
подключите аккаунт владельца Twitch |
Канал подтверждён через !code, но бот не отвечает или не модерирует |
владелец должен выполнить /mod PulseCasterBot в Twitch-чате |
После базового подключения переходите ко второму этапу: Владелец.