01Что вам нужно
Нужны панель управления ItsBagelBot, вход через аккаунт Twitch и аккаунт Spotify. Аккаунт Spotify, который вы подключаете, должен иметь Premium, чтобы бот мог управлять воспроизведением и добавлять заказы в очередь. Заказы идут через приложение Spotify, которое вы создаёте сами в панели разработчика Spotify. Аккаунт-владелец этого приложения тоже должен иметь Premium, а Spotify позволяет каждому приложению подключить не более 5 аккаунтов. Большинство стримеров используют один аккаунт для обеих ролей. Spotify также должен воспроизводить музыку на каком-либо устройстве (настольное приложение, телефон или веб-плеер), пока зрители заказывают песни.
02Настройте Spotify в панели управления
Откройте dashboard.itsbagelbot.com/songqueue. Пока Spotify не подключён, страница показывает настройку из четырёх шагов: Добро пожаловать, Создайте приложение, Добавьте ключи и Подключите Spotify. Выполняйте шаги ниже по порядку. У каждого шага настройки есть кнопка «Попросить помощи у своего ИИ», которая описана в конце этого руководства.
- Начать настройку
На шаге Добро пожаловать прочитайте примечание «Требуется Spotify Premium», затем выберите Настроить Spotify.
- Открыть панель разработчика Spotify
На шаге Создайте приложение выберите Открыть панель Spotify. Откроется
developer.spotify.com/dashboardв новой вкладке. Войдите под аккаунтом Spotify, который будет владельцем приложения. - Создать приложение в Spotify
В панели разработчика Spotify выберите Create an App. Задайте приложению название и описание, примите Developer Terms of Service и создайте приложение. Spotify показывает название и описание любому, кто через него входит, поэтому выберите что-то узнаваемое.
- Скопировать Redirect URI
Вернитесь на вкладку ItsBagelBot. В разделе Redirect URI выберите Копировать. Кнопка сменится на «Redirect URI скопирован.»
- Вставить его в приложение Spotify
В Spotify откройте настройки вашего приложения. Вставьте значение в поле Redirect URIs и сохраните изменения. Оно должно совпадать точно, без лишнего слэша или пробела. Spotify сравнивает его посимвольно.
- Подтвердить, что приложение создано
Вернитесь в ItsBagelBot и выберите Моё приложение готово. Если Redirect URI не отображается, кнопка остаётся неактивной, а страница сообщает, что значение пока недоступно.
- Скопировать Client ID и Client Secret
На шаге Добавьте ключи перейдите в Spotify и откройте Settings вашего приложения. Скопируйте Client ID. На этой же странице откройте Client Secret и тоже скопируйте его.
- Вставить оба значения в панель управления
Вставьте первое значение в Client ID, второе в Client secret, затем выберите Сохранить и продолжить. Вставляйте без пробелов. ItsBagelBot хранит секрет в зашифрованном виде и никогда его не показывает, поэтому если вы его поменяете, вставьте новый.
- Подключить аккаунт Spotify
На шаге Подключите Spotify страница показывает «Ваше приложение сохранено и готово.» Выберите Подключить Spotify. Spotify откроет экран разрешений. Подтвердите разрешения на экране Spotify. Если закрыть экран без подтверждения, подключение прервётся. Предупреждение может появиться сразу после подключения. Подключение всё равно работает, а таблица «Если что-то пошло не так» подскажет, что делать.
- Проверить результат
Spotify вернёт вас на страницу «Заказы песен». В блоке «Подключение» появятся значок Подключено и сообщение «Spotify подключён.» Теперь можно включить заказы.
03Включите заказы песен
Когда Spotify подключён, страница «Заказы песен» показывает оставшиеся шаги настройки. Оба способа используют одну очередь, и один из них может быть включён без другого.
- Включить модуль
Включите Включить заказы песен вверху страницы. Пока это выключено, страница сообщает, что заказы приостановлены и ни один способ не добавляет треки в очередь.
- Настроить команду чата
В карточке Команда чата (!sr) включите Разрешить !sr. В разделе Кто может добавлять песни выберите: Только я, Только модераторы, Только VIP, Только подписчики или Все. Только во время трансляции включено по умолчанию, поэтому заказы работают только во время стрима. Выключите его, чтобы разрешить заказы вне эфира. Переключатели сохраняются сразу после изменения.
- Ограничить число песен на зрителя
Этот шаг необязателен. В разделе Лимиты для зрителя введите число для каждого уровня (Все, Подписчики, VIP, Модераторы) и выберите Сохранить лимиты. Пустой уровень означает отсутствие лимита. Вас самих лимит никогда не ограничивает.
- Создать награду за баллы канала
В карточке Баллы канала строка Заказ песни показывает «Не настроено», пока вы не создали награду. Откройте её и выберите Создать награду. Заполните Название награды (по умолчанию «Включить заказанную песню»), Стоимость в баллах, Общий перерыв (0 = отключено) и Ответ в чате. Цвет необязателен. Награда появится в меню баллов Twitch сразу после сохранения.
- Выбрать, что происходит после активации
В разделе После активации выберите: «Выполнить: добавить песню в очередь (по умолчанию)», «Отменить: вернуть баллы, не добавлять в очередь» или «Оставить в ожидании ручного решения модераторов».
- Принимать активации
Включите Принимать получение наград. Пока это выключено, баллы за активацию наград возвращаются и ничего не добавляется в очередь. Только во время трансляции в этой карточке тоже включено по умолчанию. Выключите его, чтобы разрешить активации вне эфира.
Зрители пишут !sr и затем название, пару «исполнитель - название» или ссылку Spotify. Активации наград работают так же: зритель вводит песню при активации награды. В карточке Очередь той же страницы показано, что играет и что ждёт, с кнопкой Пропустить.
SnackPackPanda !sr исполнитель - название
ItsBagelBot @SnackPackPanda: трек «Название» добавлен в очередь, место #2.
04Если что-то пошло не так
В первой таблице перечислены сообщения, которые вы видите в панели управления. Во второй : то, что видят зрители в чате. Сообщения приведены так, как их показывает панель управления. Список охватывает сообщения, которые вы, скорее всего, увидите.
| Что вы видите | Что это значит | Что делать |
|---|---|---|
| Требуется Spotify Premium | Подключённому аккаунту нужен Premium. Аккаунту-владельцу вашего приложения Spotify тоже нужен Premium, и каждое приложение может подключить не более 5 аккаунтов. | Подключите аккаунт с Premium, убедитесь, что у владельца приложения есть Premium, и не превышайте 5 аккаунтов. |
| Вы закрыли экран разрешений Spotify, не подтвердив их. Подключитесь снова и подтвердите разрешения, чтобы завершить подключение. | Вы вышли с экрана разрешений Spotify, не подтвердив их, поэтому ничего не подключилось. | Снова выберите Подключить Spotify, затем подтвердите разрешения на экране Spotify. |
| Ссылка входа истекла или использована повторно. Начните подключение заново. | Использованная ссылка входа больше не действительна. | Снова выберите Подключить Spotify, чтобы начать новое подключение. |
| Spotify отклонил вход. Проверьте, что идентификатор клиента и секрет клиента соответствуют вашему приложению Spotify, а URI перенаправления, показанный на этой странице, сохранён в этом приложении. Затем подключитесь снова. | Spotify отклонил идентификатор клиента, секрет или Redirect URI. | Скопируйте Client ID и Client Secret из настроек вашего приложения заново. Убедитесь, что Redirect URI из панели управления сохранён в вашем приложении Spotify посимвольно. Затем подключитесь снова. |
| Spotify не отправил новый токен входа. Откройте spotify.com/account/apps, удалите доступ вашего приложения, затем выберите Подключить Spotify и подтвердите согласие снова. | Spotify не выдал новый токен для этого подключения. | Откройте spotify.com/account/apps, удалите доступ вашего приложения, затем снова выберите Подключить Spotify и подтвердите разрешения. |
| Добавьте приложение Spotify перед подключением аккаунта. | Ещё не сохранено ни одного приложения Spotify. | Вернитесь к шагу Добавьте ключи, вставьте Client ID и Client secret, затем выберите Сохранить и продолжить. |
| Настройка Spotify сейчас недоступна с нашей стороны. Попробуйте позже. Если это длится больше суток, напишите на support@itsbagelbot.com. | Проблема на стороне ItsBagelBot, а не в вашем приложении Spotify. | Попробуйте позже. Если это продолжается больше суток, напишите на support@itsbagelbot.com. |
| Не удалось сохранить токен. Попробуйте чуть позже. | Spotify принял подключение, но ItsBagelBot не смог сохранить токен. | Подождите немного и снова выберите Подключить Spotify. |
| Эти значения не похожи на Client ID и Client Secret. Скопируйте их заново со страницы настроек вашего приложения в панели разработчика Spotify, без пробелов. | Оба значения не похожи на действительные Client ID и Client Secret, поэтому их не сохранили. | Скопируйте их заново со страницы настроек вашего приложения в Spotify, вставьте без пробелов и выберите Сохранить и продолжить. |
| Не удалось сохранить приложение Spotify. | Учётные данные не удалось сохранить. | Снова выберите Сохранить и продолжить. Если ошибка повторится, проверьте значения и попробуйте позже. |
| Redirect URI сейчас недоступен с нашей стороны, поэтому вы пока не можете продолжить. Попробуйте позже. | Панель управления не может показать Redirect URI для копирования. | Попробуйте позже. |
| В подключении Spotify не хватает разрешения, нужного для заказов песен. Подключитесь заново, чтобы выдать его. | В подключении Spotify отсутствует разрешение, необходимое для заказов песен. | Выберите Подключить Spotify заново, затем подтвердите разрешения на экране Spotify. |
| При входе через Twitch не выдано разрешение на баллы канала, необходимое для этой награды. Войдите через Twitch снова, чтобы выдать его. | В вашем входе через Twitch нет разрешения на доступ к баллам канала. Это разрешение Twitch, а не Spotify. | Выберите Войти через Twitch снова и подтвердите разрешение. |
| Spotify больше не принимает это подключение, поэтому заказы песен приостановлены. Подключитесь заново, чтобы возобновить их. | Spotify перестал принимать сохранённое подключение. На странице также показан статус Нужно подключить заново. | Подключите Spotify заново. Если не получится, см. строку про «Spotify не отправил новый токен входа». |
| Для пропуска нужен Spotify Premium. | Кнопка Пропустить требует Premium на подключённом аккаунте. | Используйте аккаунт с Premium. |
| Нет активного устройства Spotify. Сначала запустите воспроизведение. | Spotify не воспроизводит музыку ни на одном устройстве. | Откройте Spotify на устройстве, запустите трек и попробуйте снова. |
| Spotify больше не принимает это подключение. Подключитесь заново и повторите. | Подключение перестало работать, пока вы нажимали Пропустить. | Подключите Spotify заново, затем снова пропустите трек. |
| Не удалось связаться с сервером. Повторите попытку чуть позже. | Страница не смогла загрузить настройки заказов песен. | Подождите и обновите страницу. |
| Задайте название награды. | Поле Название награды пустое. | Введите название и снова сохраните награду. |
| Введите целое число баллов, не меньше 1. | В поле Стоимость в баллах указано дробное число или число меньше 1. | Введите целое число, 1 или больше. |
| Введите перерыв от 0 секунд до 7 дней. | Значение Общий перерыв вне допустимого диапазона. | Введите перерыв от 0 секунд (выключено) до 7 дней. |
| Не удалось сохранить награду. | Награду не удалось сохранить. | Подождите немного и сохраните снова. |
| Не удалось удалить награду. | Награду не удалось удалить. | Подождите немного и попробуйте снова. |
| Не удалось сохранить настройки команды. | Настройки Команда чата (!sr) не сохранились. | Измените настройку ещё раз или обновите страницу и попробуйте снова. |
| Не удалось сохранить переключение. | Переключатель Включить заказы песен не сохранился. | Обновите страницу, проверьте переключатель и попробуйте снова. |
| Не удалось сохранить лимиты. | Лимиты для зрителя не сохранились. | Снова выберите Сохранить лимиты. |
| Не удалось пропустить трек. Попробуйте чуть позже. | Кнопка Пропустить не сработала. | Подождите немного и пропустите трек снова. |
| Не удалось отключить Spotify. | Отключение не удалось. | Подождите немного и попробуйте снова. |
| Не удалось удалить приложение Spotify. | Не удалось удалить сохранённое приложение Spotify. | Подождите немного и попробуйте снова. |
| Не удалось скопировать. Выделите URL и скопируйте вручную. | Ваш браузер заблокировал кнопку копирования. | Выделите Redirect URI мышью и скопируйте вручную. |
| Spotify подключён, но отказал в доступе к этому аккаунту. В режиме разработки аккаунту владельца вашего приложения Spotify нужен Premium. Подключите Premium для этого аккаунта в Spotify, затем подключитесь снова. | Подключение прошло, но Spotify отказал в доступе к этому аккаунту. В режиме разработки аккаунту-владельцу приложения нужен Premium. | В Spotify переведите аккаунт-владелец вашего приложения на Premium. Затем подключитесь снова на странице «Заказы песен». |
| Spotify подключён, но этого аккаунта нет среди разрешённых пользователей вашего приложения. В панели разработчика Spotify добавьте этот аккаунт к пользователям вашего приложения, затем подключитесь снова. | Подключение прошло, но этого аккаунта нет среди разрешённых пользователей вашего приложения. | В панели разработчика Spotify откройте настройки вашего приложения и добавьте этот аккаунт Spotify в пользователи приложения. Название раздела может отличаться, ищите настройки управления пользователями. Затем подключитесь снова на странице «Заказы песен». |
| Что вы видите | Что это значит | Что делать |
|---|---|---|
| @viewer заказы песен ещё не настроены. | Настройка на канале не завершена. | Завершите настройку выше. |
| @viewer заказы песен приостановлены, пока Spotify не будет подключён заново на этом канале. | Spotify перестал принимать сохранённое подключение. | Выберите Подключить Spotify заново на странице «Заказы песен». |
| @viewer заказы песен требуют Spotify Premium на этом канале. | Подключённый аккаунт не имеет Premium. | Подключите аккаунт с Premium. |
| @viewer Spotify сейчас не воспроизводит музыку ни на одном устройстве. | У Spotify нет активного устройства. | Откройте Spotify и запустите трек. |
| @viewer Spotify сейчас занят, попробуйте ещё раз через минуту. | Spotify временно занят. | Подождите немного и запросите снова. |
| @viewer эта ссылка Spotify не поддерживается. Поделитесь ссылкой на трек или альбом. | Зритель отправил ссылку, которая не относится ни к треку, ни к альбому. | Поделитесь ссылкой на трек или альбом либо названием песни. |
| @viewer поиск музыки сейчас не работает, попробуйте ещё раз через минуту. | Поиск песен сейчас недоступен. | Попробуйте позже. |
| @viewer заказы песен в чате сейчас отключены. | Разрешить !sr выключено. | Включите Разрешить !sr. |
| @viewer заказы песен сейчас доступны только ограниченному кругу. | Зритель не входит в выбранную группу в настройке Кто может добавлять песни. | Измените Кто может добавлять песни, если хотите, чтобы он мог заказывать. |
| @viewer заказы песен работают только во время прямого эфира. | Включено Только во время трансляции, а стрим выключен. | Начните трансляцию или выключите Только во время трансляции. |
| @viewer трек не найден. Попробуйте ссылку Spotify или «исполнитель - название». | Spotify не нашёл совпадений. | Попробуйте ссылку Spotify или пару «исполнитель - название». |
| @viewer вы достигли лимита песен (N одновременно в очереди). !sr remove освобождает место. | Зритель достиг лимита в разделе Лимиты для зрителя. | Подождите, пока одна песня сыграет, или увеличьте лимит. |
| @viewer очередь песен сейчас заполнена. | Очередь достигла максимального размера. | Подождите, пока песни сыграют. |
| заказы песен за баллы канала сейчас отключены, баллы возвращены. | Принимать получение наград выключено. | Включите Принимать получение наград. |
| заказы песен работают только во время прямого эфира, баллы возвращены. | Включено Только во время трансляции в карточке «Баллы канала», а стрим выключен. | Начните трансляцию или выключите Только во время трансляции. |
| введите название песни или ссылку Spotify, баллы возвращены. | Зритель активировал награду, не указав песню. | Активируйте награду ещё раз и введите название песни или ссылку Spotify. |
| вы достигли лимита песен на данный момент, баллы возвращены. | Зритель достиг своего лимита. | Подождите, пока одна песня сыграет. |
| очередь песен заполнена, баллы возвращены. | Очередь достигла максимального размера. | Подождите, пока песни сыграют. |
| этот трек не удалось добавить в очередь, баллы возвращены. | Spotify не смог добавить этот трек. | Активируйте награду ещё раз с другой песней. |
| @viewer у вас нет песен в очереди для удаления. | Зритель использовал !sr remove, когда в очереди ничего не было. | Исправлять нечего. Зритель сначала может заказать песню. |
| Нет песни на позиции #N. | Модератор удалил позицию, которой нет в очереди. | Проверьте нужную позицию в карточке Очередь и попробуйте снова. |
05Попросите помощи у ИИ
У каждого шага настройки есть кнопка Попросить помощи у своего ИИ. Она копирует сообщение в буфер обмена. В сообщении указаны текущий шаг, текст из панели управления и Redirect URI, а также ссылка на это руководство. Вставьте его в ChatGPT, Claude или Gemini. Никогда не вставляйте ваш Client Secret в чат. ИИ он не нужен.