PLGamesBot /Гайды/Награды за баллы
Войти
ИнструкцияВ эфире

Награды за баллы канала: как настроить

Зритель тратит баллы канала — бот делает то, что вы назначили награде: зачитывает текст, ставит трек в очередь, показывает картинку, принимает ставку или выдаёт VIP и снимает его по сроку. Награду можно создать в кабинете или взять ту, что уже есть на Twitch.

13 минут Обновлено Все тарифы
Содержание

Коротко

  • Награды за баллы Twitch даёт только компаньонам и партнёрам.
  • Создайте награду на странице Награды Twitch кнопкой Награда — или выберите действие у награды, которая уже есть на канале. Привязан Kick — там же список «Награды Kick».
  • Не сработало — бот отменяет активацию, и Twitch возвращает зрителю баллы. Это умеет только награда, созданная в кабинете.

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

  • Статус компаньона или партнёра Twitch: баллы канала есть только у них. Без него кабинет так и пишет на странице Награды Twitch.
  • Вход в кабинет через Twitch: через этот доступ бот создаёт награды и закрывает активации.
  • То, чем работает действие: плеер озвучки в OBS, плеер музыки, виджет алертов в OBS или открытая рулетка — смотрите таблицу ниже.
  • Чтобы бот объяснял зрителю отказ в чате, — включённый бот с правами модератора (/mod plgames_bot в своём чате).
  • Для действия «VIP» — ваше разрешение Twitch выдавать VIP: кнопка Дать разрешение в блоке VIP за баллы на вкладке Награды. Его даёт только тот, кто включает VIP за баллы, — основной вход в кабинет его не просит.

Настройка за 5 шагов

  1. Откройте страницу наград

    В кабинете — Награды Twitch, вкладка Награды. Здесь все награды канала: и созданные в кабинете, и заведённые на самом Twitch — у таких стоит пометка «создана вами на Twitch». Награда без действия помечена «Действие не назначено».

  2. Создайте награду

    Нажмите Награда вверху страницы и заполните форму:

    1. Название и Стоимость — так награду увидят зрители;
    2. Действие бота — что сделать при активации, варианты в таблице ниже;
    3. Подсказка зрителю — что написать в поле награды, например «ссылка на YouTube»;
    4. Требовать ввод текста — для озвучки, заказа песни и ставки включается сам: без текста боту нечего делать;
    5. Создать на Twitch — награда сразу появится на канале.
  3. Или назначьте действие готовой награде

    У награды, заведённой на Twitch, выберите действие в её строке, в списке «Выберите действие…». Если зрители уже писали в неё ссылки или фразы, рядом появится подсказка вида «Похоже на «Заказ песни» — привязать». Помните: при отказе баллы за такую награду бот не вернёт.

  4. Подготовьте то, чем работает действие

    Для «Медиа-алерт» загрузите файл во вкладке Медиа и добавьте в OBS виджет алертов — ссылка в блоке OBS: Виджет алертов внизу вкладки Награды. Для «TTS-сообщение» нужен плеер озвучки, для «Заказ песни» — плеер музыки, для «Ставка на рулетку» — открытые ставки на странице Игры и розыгрыши, вкладка Рулетка. Для «VIP» выберите срок рядом с действием и один раз нажмите Дать разрешение в блоке VIP за баллы — Twitch покажет экран, нажмите на нём «Разрешить».

  5. Проверьте

    Попросите зрителя или модератора взять награду. Во вкладке Активации появится строка. «Отменено» с подтверждением площадки означает возврат баллов; «Ожидает» — активация ещё не закрыта. Если площадка отказала, видны причина и Повторить отмену или Повторить подтверждение, в том числе после обновления страницы. Нет доступа — войдите заново. Награда другого приложения или уже обработанная активация — проверьте её в панели Twitch/Kick. У старых записей есть отдельная пометка, если подтверждение площадки не сохранено.

Форма «Новая награда» на странице «Награды Twitch»: поля «Название», «Стоимость (Channel Points)», «Действие бота», «Подсказка зрителю», тумблер «Требовать ввод текста», кнопка «Создать на Twitch» и сообщение, что награды даёт только компаньонам и партнёрам
Форма «Новая награда». Ниже — то, что кабинет пишет каналу без статуса компаньона: баллов канала у него нет, а заказ музыки работает командой !заказ.
Без действия бота — локальная историяБлок «Без действия бота» показывает наши записи наград без назначения. Их могли уже обработать вручную или другим ботом на Twitch/Kick: текущий статус площадки здесь не проверяется. Раскройте «Показать награды» и нажмите «Настроить», чтобы выбрать действие в строке награды. Если обрабатываете сами, выберите «Ручная обработка». Настройка относится к следующим активациям. «Запросить возврат» доступно у наград, которыми приложение может управлять; баллы возвращаются только после подтверждения площадки.
Создавайте награду в кабинете, а не на TwitchЗакрыть или отменить активацию Twitch позволяет только приложению, которое создало награду. Поэтому вернуть баллы, когда действие не сработало, бот может только у награды из кабинета. Награду, заведённую на Twitch, при отказе придётся закрывать вручную в очереди запросов наград на Twitch.

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

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 сначала настройте озвучку и её плеер. Для музыки используйте настройку заказов.

Корзина удаляет по-разномуУ награды из кабинета корзина удаляет её и на Twitch или Kick. У награды, заведённой на самом Twitch или Kick, корзина снимает только действие бота — сама награда остаётся на канале. Про награду Kick кабинет узнаёт это по ответу Kick и скажет, если награда осталась.

Что умеет награда

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

ДействиеЧто делает ботЧто для этого нужно
Ручная обработканичего: активация ждёт вас во вкладке Активацииничего
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» →