01O que você precisa
Você precisa do painel do ItsBagelBot, conectado com a sua conta da Twitch, e de uma conta Spotify. A conta Spotify que você conectar precisa ter Premium, para que o bot possa controlar a reprodução e adicionar os pedidos à sua fila. Os pedidos passam por um aplicativo Spotify que você cria no painel de desenvolvedor do Spotify. A conta proprietária desse aplicativo também precisa ter Premium, e o Spotify permite que cada aplicativo conecte no máximo 5 contas. A maioria dos streamers usa uma única conta para as duas funções. O Spotify também precisa estar tocando em um dispositivo (o aplicativo de desktop, seu celular ou um player web) enquanto os espectadores pedem músicas.
02Configurar o Spotify no painel
Abra dashboard.itsbagelbot.com/songqueue. Enquanto o Spotify não estiver conectado, a página mostra uma configuração em quatro etapas: Boas-vindas, Crie seu aplicativo, Adicione suas chaves e Conecte Spotify. Siga as etapas abaixo na ordem. Cada etapa da configuração tem um botão «Peça ajuda à sua IA», descrito no fim deste guia.
- Começar a configuração
Na etapa Boas-vindas, leia a nota «Spotify Premium é necessário» e selecione Vamos configurar o Spotify.
- Abrir o painel de desenvolvedor do Spotify
Na etapa Crie seu aplicativo, selecione Abrir painel do Spotify. Isso abre
developer.spotify.com/dashboardem uma nova aba. Entre com a conta do Spotify que será a proprietária do aplicativo. - Criar o aplicativo no Spotify
No painel de desenvolvedor do Spotify, selecione Create an App. Dê um nome e uma descrição ao aplicativo, aceite os Termos de Serviço para Desenvolvedores (Developer Terms of Service) e crie o aplicativo. O Spotify mostra o nome e a descrição a qualquer pessoa que conectar por meio dele, então escolha algo que você reconheça.
- Copiar a Redirect URI
Volte para a aba do ItsBagelBot. Em Redirect URI, selecione Copiar. O botão muda para «Redirect URI copiada.»
- Colar no seu aplicativo Spotify
No Spotify, abra as configurações do seu aplicativo. Cole o valor no campo Redirect URIs e salve as alterações. Ele precisa corresponder exatamente, sem barra nem espaço a mais. O Spotify compara caractere por caractere.
- Confirmar que o aplicativo foi criado
De volta ao ItsBagelBot, selecione Meu aplicativo está pronto. Se a Redirect URI estiver faltando, o botão continua desativado e a página explica que o valor não está disponível no momento.
- Copiar o seu Client ID e o seu Client Secret
Na etapa Adicione suas chaves, vá ao Spotify e abra as Settings do seu aplicativo. Copie o Client ID. Mostre o Client Secret na mesma página e copie-o também.
- Colar os dois no painel
Cole o primeiro valor em Client ID e o segundo em Client secret, depois selecione Salvar e continuar. Cole sem espaços. O ItsBagelBot armazena o segredo criptografado e nunca o exibe de novo, então cole-o novamente se um dia trocá-lo.
- Conectar a sua conta Spotify
Na etapa Conecte Spotify, a página mostra «Seu aplicativo está salvo e pronto.» Selecione Conectar Spotify. O Spotify abre uma tela de autorização. Aprove as permissões na tela do Spotify. Fechar a tela sem aprovar interrompe a conexão. Um aviso pode aparecer logo após a conexão. A conexão continua funcionando, e a tabela «Em caso de problema» explica o que fazer.
- Conferir o resultado
O Spotify leva você de volta à página Pedidos de músicas. A área de Conexão mostra o selo Conectado e aparece a mensagem «Spotify conectado.» Agora você já pode ativar os pedidos.
03Ativar pedidos de música
Depois de conectar o Spotify, a página Pedidos de músicas mostra o resto da configuração. Os dois caminhos compartilham a mesma fila, e um pode estar ativo sem o outro.
- Ativar o módulo
Ative Ativar pedidos de músicas no topo da página. Enquanto estiver desativado, a página indica que os pedidos estão pausados e que nenhum caminho alimenta a fila.
- Configurar o comando de chat
No cartão Comando de chat (!sr), ative Permitir !sr. Em Quem pode pedir, escolha entre Somente eu, Somente moderadores, Somente VIPs, Somente inscritos ou Todos. Somente ao vivo vem ativado por padrão, então os pedidos só funcionam enquanto a sua transmissão estiver no ar. Desative para permitir pedidos offline. Essas opções são salvas assim que você as altera.
- Limitar as músicas por espectador
Esta etapa é opcional. Em Limites por espectador, digite um número para cada nível (Todos, Inscritos, VIPs, Moderadores) e selecione Salvar limites. Um nível em branco significa sem limite. Você nunca é limitado.
- Criar a recompensa de pontos do canal
No cartão Pontos do canal, a linha Pedido de música mostra «Não configurada» até você criar a recompensa. Abra-a e selecione Criar recompensa. Preencha o Título da recompensa (padrão «Peça uma música»), o Custo em pontos, o Intervalo global (0 = desativado) e a Resposta no chat. A Cor é opcional. A recompensa aparece no menu de pontos da Twitch assim que for salva.
- Escolher o que acontece após um resgate
Em Após o resgate, escolha: «Concluir: a música entra na fila (padrão)», «Cancelar: devolver os pontos, sem entrar na fila» ou «Deixar pendente para moderadores resolverem manualmente».
- Aceitar os resgates
Ative Aceitar resgates de recompensa. Enquanto estiver desativado, os pontos gastos nos resgates são devolvidos e nada entra na fila. Somente ao vivo neste cartão também vem ativado por padrão. Desative para permitir resgates offline.
Os espectadores digitam !sr seguido de um título, de um par «artista - título»
ou de um link do Spotify. Os resgates de pontos do canal funcionam do mesmo jeito: o espectador digita a música ao resgatar
a recompensa. O cartão Fila da mesma página mostra o que está tocando e o que está esperando, com um botão Pular.
SnackPackPanda !sr artista - título
ItsBagelBot @SnackPackPanda “Título” de Artista adicionada, posição #2.
04Em caso de problema
A primeira tabela lista as mensagens que você vê no painel. A segunda lista o que os espectadores veem no chat. As mensagens são copiadas exatamente como o painel as mostra. A lista cobre as mensagens que você provavelmente vai ver.
| O que você vê | O que isso significa | O que fazer |
|---|---|---|
| Spotify Premium é necessário | A conta conectada precisa ter Premium. A conta proprietária do seu aplicativo Spotify também precisa ter Premium, e cada aplicativo pode conectar no máximo 5 contas. | Conecte uma conta com Premium, confirme que o proprietário do aplicativo tem Premium e fique dentro do limite de 5 contas. |
| Você fechou a tela de permissões do Spotify antes de aprovar. Escolha Conectar Spotify e aprove as permissões para concluir. | Você saiu da tela de autorização do Spotify sem aprovar, então nada foi conectado. | Selecione Conectar Spotify de novo e aprove as permissões na tela do Spotify. |
| O link de conexão expirou ou foi reutilizado. Inicie a conexão de novo. | O link de conexão usado não é mais válido. | Selecione Conectar Spotify novamente para iniciar uma nova conexão. |
| O Spotify recusou a conexão. Confira se o Client ID e o Client Secret correspondem ao seu aplicativo Spotify e se a Redirect URI exibida nesta página está salva nesse aplicativo. Depois conecte de novo. | O Spotify rejeitou as credenciais ou a Redirect URI. | Copie de novo o Client ID e o Client Secret nas Settings do seu aplicativo. Confirme que a Redirect URI exibida no painel está salva no seu aplicativo Spotify, caractere por caractere. Depois reconecte. |
| O Spotify não enviou um novo token de conexão. Abra spotify.com/account/apps, remova o acesso do seu aplicativo e depois escolha Conectar Spotify e aceite de novo. | O Spotify não emitiu um novo token para esta conexão. | Abra spotify.com/account/apps, remova o acesso do seu aplicativo e depois selecione Conectar Spotify de novo e aprove as permissões outra vez. |
| Adicione o seu aplicativo Spotify antes de conectar a sua conta. | Nenhum aplicativo Spotify foi salvo ainda. | Volte à etapa Adicione suas chaves, cole o Client ID e o Client secret e selecione Salvar e continuar. |
| A configuração do Spotify não está disponível do nosso lado no momento. Tente novamente mais tarde. Se durar mais de um dia, escreva para support@itsbagelbot.com. | O problema é do ItsBagelBot, não do seu aplicativo Spotify. | Tente novamente mais tarde. Se durar mais de um dia, escreva para support@itsbagelbot.com. |
| O token não pôde ser armazenado. Tente novamente em instantes. | O Spotify aceitou a conexão, mas o ItsBagelBot não conseguiu salvar a credencial de acesso. | Aguarde um instante e selecione Conectar Spotify de novo. |
| Estes valores não parecem um Client ID e um Client Secret. Copie-os de novo na página de Settings do seu aplicativo no painel de desenvolvedor do Spotify, sem espaços. | Os dois valores não pareciam um Client ID e um Client Secret válidos, então não foram salvos. | Copie-os de novo na página de configurações do seu aplicativo no Spotify, cole sem espaços e selecione Salvar e continuar. |
| Não foi possível salvar o aplicativo Spotify. | As credenciais não puderam ser salvas. | Selecione Salvar e continuar de novo. Se falhar outra vez, confira os valores e tente mais tarde. |
| A Redirect URI não está disponível do nosso lado no momento, então você ainda não pode continuar. Tente novamente mais tarde. | O painel não consegue mostrar a Redirect URI para copiar. | Tente novamente mais tarde. |
| Falta uma permissão na sua conexão Spotify para os pedidos de música. Reconecte para concedê-la. | A conexão com o Spotify foi feita sem uma permissão que os pedidos exigem. | Selecione Reconectar Spotify e aprove as permissões na tela do Spotify. |
| Falta na sua conexão com a Twitch a permissão de acesso aos pontos do canal necessária para esta recompensa. Reconecte com a Twitch para concedê-la. | Sua conexão com a Twitch não inclui a permissão de acesso aos pontos do canal. É uma permissão da Twitch, não do Spotify. | Selecione Entrar com Twitch novamente e aprove a permissão. |
| O Spotify não aceita mais esta conexão, então os pedidos de música estão pausados. Reconecte para retomá-los. | O Spotify deixou de aceitar a conexão salva. A página também mostra Reconexão necessária. | Reconecte o Spotify. Se não funcionar, siga a linha «O Spotify não enviou um novo token de conexão». |
| Pular uma faixa exige Spotify Premium. | O botão Pular exige Premium na conta conectada. | Use uma conta com Premium. |
| Nenhum dispositivo Spotify ativo. Comece a tocar algo primeiro. | O Spotify não está tocando em nenhum dispositivo. | Abra o Spotify em um dispositivo, toque uma música e tente de novo. |
| O Spotify não aceita mais esta conexão. Reconecte e tente de novo. | A conexão deixou de funcionar enquanto você pressionava Pular. | Reconecte o Spotify e pule a faixa novamente. |
| Não foi possível conectar ao servidor. Tente novamente em instantes. | A página não conseguiu carregar as configurações dos pedidos de música. | Aguarde um instante e recarregue a página. |
| Dê um título à recompensa. | O campo Título da recompensa está vazio. | Digite um título e salve a recompensa de novo. |
| Digite um número inteiro de pontos, no mínimo 1. | O Custo em pontos não é um número inteiro de pelo menos 1. | Digite um número inteiro, 1 ou mais. |
| Digite um intervalo entre 0 segundo e 7 dias. | O Intervalo global está fora da faixa permitida. | Digite um intervalo de 0 segundo (desativado) a 7 dias. |
| Não foi possível salvar a recompensa. | A recompensa não pôde ser salva. | Aguarde um instante e salve novamente. |
| Não foi possível excluir a recompensa. | A recompensa não pôde ser excluída. | Aguarde um instante e tente de novo. |
| Não foi possível salvar as configurações do comando. | As configurações do Comando de chat (!sr) não puderam ser salvas. | Altere a configuração de novo, ou recarregue a página e tente outra vez. |
| Não foi possível salvar a opção. | A opção Ativar pedidos de músicas não pôde ser salva. | Recarregue a página, confira a opção e tente novamente. |
| Não foi possível salvar os limites. | Os Limites por espectador não puderam ser salvos. | Selecione Salvar limites de novo. |
| Não foi possível pular a faixa. Tente novamente em instantes. | O botão Pular não teve sucesso. | Aguarde um instante e pule a faixa de novo. |
| Não foi possível desconectar o Spotify. | A desconexão não teve sucesso. | Aguarde um instante e tente de novo. |
| Não foi possível excluir o aplicativo Spotify. | A exclusão do aplicativo Spotify salvo não teve sucesso. | Aguarde um instante e tente de novo. |
| Não foi possível copiar. Selecione a URL e copie manualmente. | Seu navegador bloqueou o botão de copiar. | Selecione a Redirect URI com o mouse e copie-a manualmente. |
| O Spotify está conectado, mas recusou o acesso desta conta. No modo de desenvolvimento, a conta proprietária do seu aplicativo Spotify precisa ter Premium. Atualize essa conta para Premium no Spotify e conecte de novo. | A conexão funcionou, mas o Spotify recusou o acesso desta conta. No modo de desenvolvimento, a conta proprietária do seu aplicativo Spotify precisa ter Premium. | No Spotify, mude a conta proprietária do seu aplicativo para Premium. Depois reconecte pela página Pedidos de músicas. |
| O Spotify está conectado, mas esta conta não está na lista de usuários autorizados do seu aplicativo. No painel de desenvolvedor do Spotify, adicione esta conta aos usuários do seu aplicativo e conecte de novo. | A conexão funcionou, mas esta conta não consta na lista de usuários autorizados do seu aplicativo. | No painel de desenvolvedor do Spotify, abra as configurações do seu aplicativo e adicione esta conta Spotify aos usuários do aplicativo. O nome dessa seção pode variar, então procure as configurações de gerenciamento de usuários. Depois reconecte pela página Pedidos de músicas. |
| O que você vê | O que isso significa | O que fazer |
|---|---|---|
| @viewer os pedidos de música ainda não foram configurados. | A configuração não foi concluída no canal. | Conclua a configuração acima. |
| @viewer os pedidos de música estão pausados até o Spotify ser reconectado neste canal. | O Spotify deixou de aceitar a conexão salva. | Selecione Reconectar Spotify na página Pedidos de músicas. |
| @viewer os pedidos de música exigem Spotify Premium neste canal. | A conta conectada não tem Premium. | Conecte uma conta com Premium. |
| @viewer o Spotify não está tocando música em nenhum dispositivo no momento. | O Spotify não tem nenhum dispositivo ativo. | Abra o Spotify e toque uma música. |
| @viewer o Spotify está ocupado no momento, tente de novo em instantes. | O Spotify está temporariamente ocupado. | Aguarde um instante e peça de novo. |
| @viewer este link do Spotify não é compatível. Compartilhe um link de uma faixa ou de um álbum. | O espectador compartilhou um link que não é de faixa nem de álbum. | Compartilhe um link de faixa ou de álbum, ou o nome de uma música. |
| @viewer a busca de músicas está fora do ar no momento, tente de novo em instantes. | A busca de músicas está indisponível no momento. | Tente novamente mais tarde. |
| @viewer os pedidos de música pelo chat estão desativados no momento. | Permitir !sr está desativado. | Ative Permitir !sr. |
| @viewer os pedidos de música estão restritos a um grupo específico no momento. | O espectador não faz parte do grupo escolhido em Quem pode pedir. | Mude Quem pode pedir se quiser que ele possa pedir. |
| @viewer os pedidos de música só funcionam quando a transmissão está ao vivo. | Somente ao vivo está ativado e a transmissão está offline. | Inicie sua live, ou desative Somente ao vivo. |
| @viewer nenhuma música encontrada. Tente um link do Spotify ou «artista - título». | O Spotify não encontrou nenhum resultado. | Tente um link do Spotify ou um par «artista - título». |
| @viewer você atingiu seu limite de músicas (N na fila ao mesmo tempo). !sr remove libera uma vaga. | O espectador atingiu o limite em Limites por espectador. | Espere uma música tocar, ou aumente o limite. |
| @viewer a fila de músicas está cheia no momento. | A fila atingiu o tamanho máximo. | Espere algumas músicas tocarem. |
| os pedidos de música com pontos do canal estão desativados no momento, seus pontos foram devolvidos. | Aceitar resgates de recompensa está desativado. | Ative Aceitar resgates de recompensa. |
| os pedidos de música só funcionam durante uma transmissão ao vivo, seus pontos foram devolvidos. | Somente ao vivo está ativado no cartão Pontos do canal e a transmissão está offline. | Inicie sua live, ou desative Somente ao vivo. |
| digite o nome de uma música ou um link do Spotify, seus pontos foram devolvidos. | O espectador resgatou a recompensa sem digitar uma música. | Resgate de novo digitando o nome de uma música ou um link do Spotify. |
| você atingiu seu limite de músicas no momento, seus pontos foram devolvidos. | O espectador atingiu o limite. | Espere uma música tocar. |
| a fila de músicas está cheia, seus pontos foram devolvidos. | A fila atingiu o tamanho máximo. | Espere algumas músicas tocarem. |
| essa faixa não pôde ser adicionada à fila, seus pontos foram devolvidos. | O Spotify não conseguiu adicionar esta faixa. | Resgate de novo com outra música. |
| @viewer você não tem nenhuma música na fila para remover. | O espectador usou !sr remove sem nenhuma música na fila. | Nada a corrigir. O espectador pode pedir uma música primeiro. |
| Nenhuma música na posição #N. | Um moderador removeu uma posição que não está na fila. | Confira a posição correta no cartão Fila e tente de novo. |
05Pedir ajuda a uma IA
Cada etapa da configuração tem um botão Peça ajuda à sua IA. Ele copia uma mensagem para a sua área de transferência. A mensagem diz em qual etapa você está, inclui a mensagem exibida pelo painel e a Redirect URI, e tem um link para este guia. Cole no ChatGPT, Claude ou Gemini. Nunca cole o seu Client Secret na conversa. A IA não precisa dele.