Награды за баллы канала: как настроить
Зритель тратит баллы канала — бот делает то, что вы назначили награде: зачитывает текст, ставит трек в очередь, показывает картинку, принимает ставку или выдаёт VIP и снимает его по сроку. Награду можно создать в кабинете или взять ту, что уже есть на Twitch.
Содержание
Коротко
- Награды за баллы Twitch даёт только компаньонам и партнёрам.
- Создайте награду на странице Награды Twitch кнопкой Награда — или выберите действие у награды, которая уже есть на канале. Привязан Kick — там же список «Награды Kick».
- Не сработало — бот отменяет активацию, и Twitch возвращает зрителю баллы. Это умеет только награда, созданная в кабинете.
Что понадобится
- Статус компаньона или партнёра Twitch: баллы канала есть только у них. Без него кабинет так и пишет на странице Награды Twitch.
- Вход в кабинет через Twitch: через этот доступ бот создаёт награды и закрывает активации.
- То, чем работает действие: плеер озвучки в OBS, плеер музыки, виджет алертов в OBS или открытая рулетка — смотрите таблицу ниже.
- Чтобы бот объяснял зрителю отказ в чате, — включённый бот с правами модератора (/mod plgames_bot в своём чате).
- Для действия «VIP» — ваше разрешение Twitch выдавать VIP: кнопка Дать разрешение в блоке VIP за баллы на вкладке Награды. Его даёт только тот, кто включает VIP за баллы, — основной вход в кабинет его не просит.
Настройка за 5 шагов
Откройте страницу наград
В кабинете — Награды Twitch, вкладка Награды. Здесь все награды канала: и созданные в кабинете, и заведённые на самом Twitch — у таких стоит пометка «создана вами на Twitch». Награда без действия помечена «Действие не назначено».
Создайте награду
Нажмите Награда вверху страницы и заполните форму:
- Название и Стоимость — так награду увидят зрители;
- Действие бота — что сделать при активации, варианты в таблице ниже;
- Подсказка зрителю — что написать в поле награды, например «ссылка на YouTube»;
- Требовать ввод текста — для озвучки, заказа песни и ставки включается сам: без текста боту нечего делать;
- Создать на Twitch — награда сразу появится на канале.
Или назначьте действие готовой награде
У награды, заведённой на Twitch, выберите действие в её строке, в списке «Выберите действие…». Если зрители уже писали в неё ссылки или фразы, рядом появится подсказка вида «Похоже на «Заказ песни» — привязать». Помните: при отказе баллы за такую награду бот не вернёт.
Подготовьте то, чем работает действие
Для «Медиа-алерт» загрузите файл во вкладке Медиа и добавьте в OBS виджет алертов — ссылка в блоке OBS: Виджет алертов внизу вкладки Награды. Для «TTS-сообщение» нужен плеер озвучки, для «Заказ песни» — плеер музыки, для «Ставка на рулетку» — открытые ставки на странице Игры и розыгрыши, вкладка Рулетка. Для «VIP» выберите срок рядом с действием и один раз нажмите Дать разрешение в блоке VIP за баллы — Twitch покажет экран, нажмите на нём «Разрешить».
Проверьте
Попросите зрителя или модератора взять награду. Во вкладке Активации появится строка. «Отменено» с подтверждением площадки означает возврат баллов; «Ожидает» — активация ещё не закрыта. Если площадка отказала, видны причина и Повторить отмену или Повторить подтверждение, в том числе после обновления страницы. Нет доступа — войдите заново. Награда другого приложения или уже обработанная активация — проверьте её в панели Twitch/Kick. У старых записей есть отдельная пометка, если подтверждение площадки не сохранено.

Как это работает
Twitch присылает активацию на сервер PLGamesBot сразу, как зритель нажал награду. Сервер смотрит, какое действие назначено, и выполняет его. Получилось — активация закрывается на Twitch как выполненная. Не получилось — отменяется, Twitch возвращает зрителю баллы, а бот пишет в чат почему: «озвучка сейчас выключена — баллы вернутся».
У награды, заведённой на самом Twitch, действие выполняется так же, но отменить активацию бот не может. При отказе он только назовёт зрителю причину, без «баллы вернутся», а активация останется «Ожидает» — вернуть баллы можно в очереди запросов наград на Twitch.
«Ручная обработка» — для наград, которые выполняете вы сами: спеть, сыграть со зрителем. Активации видны во вкладке Активации: можно запросить выполнение или отмену. Успех подтверждает площадка; при отказе видны причина и кнопка повтора. У награды, заведённой на Twitch, приложение не может менять активации — закройте такую активацию в панели Twitch.
Права не проверены. Twitch вернул список, но не подтвердил, какими наградами может управлять приложение. Нажмите Обновить список; до проверки удаление недоступно. Это не означает, что награду создало другое приложение. У подтверждённой чужой награды название и цену меняют в Twitch; действие бота назначается здесь. Если Twitch подтвердил чужого создателя активации, закройте её в очереди Twitch: повтор в кабинете прав не добавит. Недостаток разрешений требует заново выдать доступ; общий 403 не доказывает чужого создателя.
Если зрители нажимали награду без действия, вверху страницы появится блок «Без действия бота» — локальная история, не проверка статуса на площадке. «Показать награды» → Настроить ведёт к действию для следующих активаций. Запросить возврат доступно только у наград, которыми может управлять приложение.
«VIP»: зритель купил — бот делает его VIP и пишет в чат «теперь ты VIP — до 21.11». Раз в час бот снимает VIP, у которых вышел срок, — только те, что выдал сам: VIP, выданный вами руками, он не трогает. Купил ещё раз — срок продлевается от конца прежнего. Уже VIP по вашей воле, модератор, нет свободных мест VIP — отказ с причиной. Награду «VIP 3 мес» или «Випка» кабинет узнаёт по названию и предлагает «Похоже на «VIP на 3 месяца» — привязать». Бот выключен, канал его забанил или зритель у бота «на заметке» — VIP он не выдаёт, активация ждёт вас, как раньше.
VIP на срок можно выдать и из чата: !вип @ник 30д (7д, 3м, 1г; без срока — навсегда), !вип снять @ник, !вип список — кто VIP от бота и до какого числа. Это можете вы всегда, модераторы — если включить Модераторы выдают VIP командой !вип в блоке VIP за баллы: на самом Twitch модератор VIP не выдаёт.
Для действия TTS сначала настройте озвучку и её плеер. Для музыки используйте настройку заказов.
Что умеет награда
Действие выбирается в поле Действие бота при создании или в строке награды.
| Действие | Что делает бот | Что для этого нужно |
|---|---|---|
| Ручная обработка | ничего: активация ждёт вас во вкладке Активации | ничего |
| TTS-сообщение | зачитывает текст зрителя голосом | плеер озвучки в OBS, текст в награде; число озвучек не ограничено |
| Заказ песни | ставит трек в очередь — по ссылке или по названию | ссылка YouTube, SoundCloud или VK Видео или название песни в награде; играет плеер музыки — без него заказ ждёт в очереди |
| Медиа-алерт | показывает на экране выбранный файл | файл во вкладке Медиа, виджет алертов в OBS |
| Ставка на рулетку | ставит на вариант рулетки; вес ставки — цена награды | открытые ставки за баллы канала, номер варианта в тексте награды |
| VIP | делает купившего VIP на выбранный срок (неделя, месяц, 3 месяца, полгода, год или без срока) и снимает по сроку | разрешение Twitch на VIP (Дать разрешение), свободное место VIP; только Twitch |
Если не работает
Twitch отказал в изменении активации, точная причина неизвестна
Возврат не подтверждён. Проверьте активацию в очереди наград Twitch и при необходимости отмените её там. Кабинет проверяет, принадлежит ли награда нашему приложению; если проверить нельзя, не утверждает ни чужое владение, ни отсутствие статуса компаньона. При отзыве доступа повторно войдите через Twitch как владелец. Для автоматического возврата нужна управляемая PLGamesBot награда и доступные каналу баллы Twitch.
Кабинет пишет «Награды за баллы Twitch даёт только компаньонам и партнёрам»
У канала пока нет статуса компаньона, а значит, и баллов канала. Озвучка всего чата и команда !заказ работают и без наград.
Зритель взял награду, а бот ничего не сделал
У награды «Действие не назначено» или выбрана «Ручная обработка». Для автоматизации выберите действие в строке. Если награду обрабатываете сами, оставьте ручную обработку. История не подтверждает, что награда осталась необработанной на площадке. Возврат запрашивается кнопкой Запросить возврат у управляемых приложением наград; для остальных — в панели площадки.
Баллы не возвращаются: «Награду создало другое приложение»
Награда заведена на самом Twitch, и её активации Twitch даёт менять только себе. Отмените их в очереди запросов наград на Twitch. Чтобы дальше баллы возвращались сами, заведите такую же награду в кабинете.
Озвучка или заказ отменяются: «в награде нет текста» или «пришлите ссылку»
Награда не просит у зрителя текст. Создайте её в кабинете с включённым Требовать ввод текста — или включите ввод текста в настройках награды на Twitch, если она заведена там.
Медиа-алерт ничего не показывает
Виджет алертов не добавлен в OBS или стоит не в той сцене: ссылка — в блоке OBS: Виджет алертов на вкладке Награды. Проверьте и то, что у награды выбран файл: при «Медиа-алерт» рядом с действием появляется второй список — с файлами.
VIP не выдан: «у бота нет разрешения выдавать VIP»
Нажмите Дать разрешение в блоке VIP за баллы на вкладке Награды и «Разрешить» на экране Twitch. Войти на Twitch нужно как владелец канала, а не другим аккаунтом. Пока разрешения нет, бот пришлёт вам письмо — не чаще раза в сутки.
VIP не выдан: «у канала кончились места VIP»
Мест VIP у канала столько, сколько даёт Twitch. Снимите VIP с кого-то — /unvip ник или !вип снять @ник — или выключите награду.
VIP не выдан: «Twitch пока не даёт этому каналу выдавать VIP»
Twitch разрешает VIP после достижения «Build a Community» (Панель управления автора → Достижения). До этого покупки VIP отменяются.
Активации вообще не появляются в кабинете
Twitch присылает их по подписке, которая создаётся при входе в кабинет и проверяется каждые шесть часов. Если вы отзывали доступ PLGamesBot в настройках Twitch, выйдите из кабинета и войдите снова через Twitch.
Частые вопросы
Можно ли использовать награды, которые уже есть на канале?
Да. Кабинет показывает все награды канала, и любой можно назначить действие прямо в её строке. Разница одна: при отказе баллы за такую награду бот не вернёт — Twitch даёт менять активации только приложению, которое создало награду.
Что видит зритель, если действие не сработало?
Бот пишет ему в чат причину — например, «заказ не принят: напишите название песни или пришлите ссылку YouTube, SoundCloud или VK Видео» или «ставка не принята: ставки закрыты». Если Twitch принял отмену, в конце добавляется «баллы вернутся». Без прав модератора бот молчит, и сообщения не будет.
Снимет ли бот VIP, который я выдал сам?
Нет. По сроку бот снимает только VIP, выданный наградой или командой !вип. Ваш VIP он не трогает, а купившему его за баллы скажет «ты уже VIP» и отменит покупку — баллы вернутся, если награда создана в кабинете. Поставить свой VIP на срок можете вы сами: !вип @ник 3м.
Сколько файлов можно загрузить для медиа-алертов?
Один файл — до 10 МБ: видео MP4 и WebM, звук MP3, WAV и OGG, картинки PNG, JPG, GIF и WebP. Всего на бесплатном тарифе — 10 файлов и 50 МБ, на Старте — 100 файлов и 500 МБ, на Про — 5 ГБ без ограничения по числу файлов.
Работают ли награды на Kick?
Да. В кабинете, созданном входом через Kick, страница наград показывает награды Kick. У кабинета Twitch с привязанным Kick под наградами Twitch есть список «Награды Kick»; новую награду там заводит кнопка Награда → «На Kick» — кнопка Создать на Kick. Действие назначается так же, и бот выполняет его при активации. Отказ бот закрывает на самом Kick — баллы вернутся, если награда создана в кабинете, — а причину пишет в чат Kick, если бот включён. VIP за баллы бывает только на Twitch. Kick перестал принимать доступ — вместо списка кабинет попросит подключить Kick заново на Платформах.
Что изменилось
- При одновременной загрузке медиа квота проверяется для всех загрузок вместе. При отказе в сохранении новый файл убирается; публичный показ меняется только по явному выбору в настройках файла.
- Неоднозначный403 Twitch проверяется по владению наградой; неизвестную причину кабинет не выдаёт за отсутствие affiliate. Массовый отказ не создаёт сотни повторных запросов.
- Права на награду могут быть не проверены. Добавлена кнопка обновления; отказ в синхронизации объясняется по причине.
- Уточнены описание и ссылки на связанные инструкции.
- Без действия бота — локальная история. Блок «Без действия бота» показывает наши записи наград без назначения. Их могли уже обработать вручную или другим ботом на Twitch/Kick: текущий статус площадки здесь не проверяется. Раскройте «Показать награды» и нажмите «Настроить», чтобы выбрать действие в строке награды. Если обрабатываете сами, выберите «Ручная обработка». Настройка относится к следующим активациям. «Запросить возврат» доступно у наград, которыми приложение может управлять; баллы возвращаются только после подтверждения площадки.
- В активациях сохраняется подтверждение площадки и причина отказа. После ошибки доступны «Повторить отмену» или «Повторить подтверждение»; обновление страницы не скрывает отказ. Старые локальные отметки не подтверждают возврат баллов.
- Награды Kick — и у кабинета Twitch с привязанным Kick: список «Награды Kick» под наградами Twitch, новая награда — кнопкой Награда → «На Kick». Активации Kick бот выполняет, а подтверждает, отменяет и возвращает за них баллы на самом Kick. Раньше награды Kick работали только у кабинета, созданного входом через Kick. Корзина у награды, заведённой на самом Kick, говорит, что награда осталась на Kick, — раньше кабинет отвечал «удалено».
- «Заказ песни» принимает и ссылку VK Видео.
- Новое действие «VIP»: бот выдаёт VIP купившему на выбранный срок и сам снимает его по сроку; VIP, выданный вами руками, не трогает. Нужно один раз дать разрешение Twitch — кнопка Дать разрешение в блоке VIP за баллы. В чате — !вип @ник 30д, !вип снять @ник, !вип список.
- Озвучка за баллы больше не упирается в дневной лимит: число озвучек не ограничено на всех тарифах, и отказа «лимит озвучки на сегодня исчерпан» больше нет.
- Файл во вкладке Медиа, который уже показывали алертом (хотя бы тестом), удаляется — раньше кабинет отвечал «Ошибка удаления файла». Награда с этим файлом остаётся, файл для неё нужно выбрать заново.
- «Заказ песни» принимает название: бот ищет его на YouTube, ставит первый ролик в очередь и пишет зрителю в чат, что нашёл. Раньше название отменялось с просьбой прислать ссылку.
- Заказ песни за баллы при незапущенном плеере больше не отменяется: трек ждёт в очереди и заиграет, когда плеер откроют.
- Награды Kick в кабинете, созданном входом через Kick, работают: активации приходят с Kick, бот выполняет действие и закрывает активацию там же. Раньше действие назначалось, но не срабатывало.
- Отказ награды объясняется зрителю в чате, а баллы возвращаются — при заказе без ссылки, при сбое озвучки и при исчерпанном лимите. Ссылку в заказе песни можно вставить без https.
- Каналу без статуса компаньона кабинет прямо пишет, почему наград нет. Заказ песни за баллы при незапущенном плеере отменяется с возвратом баллов.
Всё готово к настройке?Страница откроется в кабинете после входа через Twitch.
Открыть «Награды Twitch» →