01Lo que necesitas
Necesitas el panel de ItsBagelBot, conectado con tu cuenta de Twitch, y una cuenta de Spotify. La cuenta de Spotify que conectes debe tener Premium, para que el bot pueda controlar la reproducción y añadir peticiones a tu cola. Las peticiones pasan por una aplicación de Spotify que creas tú mismo en el panel para desarrolladores de Spotify. La cuenta propietaria de esa aplicación también debe tener Premium, y Spotify permite que cada aplicación conecte como máximo 5 cuentas. La mayoría de streamers usan una sola cuenta para ambos roles. Spotify también debe estar reproduciendo en un dispositivo (la aplicación de escritorio, tu teléfono o un reproductor web) mientras los espectadores piden canciones.
02Configurar Spotify en el panel
Abre dashboard.itsbagelbot.com/songqueue. Mientras Spotify no esté conectado, la página muestra una configuración en cuatro pasos: Bienvenida, Crea tu aplicación, Añade tus claves y Conecta Spotify. Sigue los pasos de abajo en orden. Cada paso de la configuración tiene un botón «Pide ayuda a tu IA», descrito al final de esta guía.
- Empezar la configuración
En el paso Bienvenida, lee la nota «Se requiere Spotify Premium» y luego selecciona Configurar Spotify.
- Abrir el panel para desarrolladores de Spotify
En el paso Crea tu aplicación, selecciona Abrir panel de Spotify. Esto abre
developer.spotify.com/dashboarden una pestaña nueva. Inicia sesión con la cuenta de Spotify que será propietaria de la aplicación. - Crear la aplicación en Spotify
En el panel para desarrolladores de Spotify, selecciona Create an App. Pon un nombre y una descripción a la aplicación, acepta las Condiciones del servicio para desarrolladores (Developer Terms of Service) y crea la aplicación. Spotify muestra el nombre y la descripción a cualquiera que inicie sesión con ella, así que elige algo que reconozcas.
- Copiar la Redirect URI
Vuelve a la pestaña de ItsBagelBot. En URI de redirección, selecciona Copiar. El botón cambia a «URI de redirección copiada.»
- Pegarla en tu aplicación de Spotify
En Spotify, abre los ajustes de tu aplicación. Pega el valor en el campo Redirect URIs y guarda los cambios. Debe coincidir exactamente, sin barras ni espacios de más. Spotify la compara carácter por carácter.
- Confirmar que la aplicación está creada
De vuelta en ItsBagelBot, selecciona Mi aplicación está lista. Si falta la Redirect URI, el botón sigue desactivado y la página explica que el valor no está disponible por ahora.
- Copiar tu Client ID y tu Client Secret
En el paso Añade tus claves, vuelve a Spotify y abre los Settings de tu aplicación. Copia el Client ID. Muestra el Client Secret en la misma página y cópialo también.
- Pegar los dos valores en el panel
Pega el primer valor en ID de cliente y el segundo en Secreto de cliente, y luego selecciona Guardar y continuar. Pégalos sin espacios. ItsBagelBot guarda el secreto cifrado y nunca lo vuelve a mostrar, así que vuelve a pegarlo si algún día lo cambias.
- Conectar tu cuenta de Spotify
En el paso Conecta Spotify, la página indica «Tu aplicación está registrada y lista.» Selecciona Conecta Spotify. Spotify abre una pantalla de autorización. Aprueba los permisos en la pantalla de Spotify. Si cierras la pantalla sin aprobar, la conexión se interrumpe. Puede aparecer una advertencia justo después de conectar. La conexión funciona igualmente, y la tabla «Si hay un problema» indica qué hacer.
- Comprobar el resultado
Spotify te devuelve a la página de Peticiones de canciones. La zona de Conexión muestra la insignia Conectado y aparece un mensaje «Spotify conectado.» Ya puedes activar las peticiones.
03Activar las peticiones de canciones
Una vez conectado Spotify, la página de Peticiones de canciones muestra el resto de la configuración. Ambas vías comparten la misma cola, y una puede estar activa sin la otra.
- Activar el módulo
Activa Activar peticiones de canciones en la parte superior de la página. Mientras esté desactivado, la página indica que las peticiones están en pausa y que ninguna vía alimenta la cola.
- Configurar el comando de chat
En la tarjeta Comando de chat (!sr), activa Permitir !sr. En Quién puede añadir a la cola, elige entre Solo yo, Solo moderadores, Solo VIP, Solo suscriptores o Todos. Solo en directo viene activado por defecto, así que las peticiones solo funcionan mientras estás en directo. Desactívalo para permitir peticiones sin conexión. Estos interruptores se guardan en cuanto los cambias.
- Limitar el número de canciones por espectador
Este paso es opcional. En Límites por espectador, escribe un número para cada nivel (Todos, Suscriptores, VIP, Moderadores) y selecciona Guardar límites. Un nivel vacío significa sin límite. Tú nunca tienes límite.
- Crear la recompensa de puntos del canal
En la tarjeta Puntos del canal, la fila Petición de canción muestra «Sin configurar» hasta que crees la recompensa. Ábrela y selecciona Crear recompensa. Rellena Título de recompensa (por defecto «Reproducir una canción solicitada»), Coste en puntos, Espera global (0 = desactivado) y Respuesta en el chat. Color es opcional. La recompensa aparece en el menú de puntos de Twitch en cuanto la guardas.
- Elegir qué pasa tras un canje
En Después del canje, elige: «Completar: la canción entra en la cola (predeterminado)», «Cancelar: devolver los puntos y no añadir a la cola», o «Dejar pendiente para que decidan los moderadores».
- Aceptar canjes
Activa Aceptar canjes de recompensas. Mientras esté desactivado, los canjes se devuelven y no se añade nada a la cola. Solo en directo en esta tarjeta también viene activado por defecto. Desactívalo para permitir canjes sin conexión.
Los espectadores escriben !sr seguido de un título, un par «artista - título»
o un enlace de Spotify. Los canjes de puntos del canal funcionan igual: el
espectador escribe la canción al canjear la recompensa. La tarjeta Cola
de la misma página muestra qué suena y qué espera, con un botón Saltar.
SnackPackPanda !sr artista - título
ItsBagelBot @SnackPackPanda, se ha añadido «Título» de Artista, posición #2.
04Si hay un problema
La primera tabla recoge los mensajes que ves en el panel. La segunda recoge lo que ven los espectadores en el chat. Los mensajes se copian tal como los muestra el panel. La lista cubre los mensajes que es probable que veas.
| Lo que ves | Lo que significa | Qué hacer |
|---|---|---|
| Se requiere Spotify Premium | La cuenta conectada debe tener Premium. La cuenta propietaria de tu aplicación de Spotify también debe tener Premium, y cada aplicación puede conectar como máximo 5 cuentas. | Conecta una cuenta con Premium, comprueba que el propietario de la aplicación tenga Premium y no superes las 5 cuentas. |
| Cerraste la pantalla de permisos de Spotify antes de aprobarlos. Selecciona Conecta Spotify y aprueba los permisos para terminar. | Saliste de la pantalla de autorización de Spotify sin aprobar, así que no se conectó nada. | Selecciona de nuevo Conecta Spotify y luego aprueba los permisos en la pantalla de Spotify. |
| El enlace de inicio de sesión caducó o se reutilizó. Vuelve a iniciar la conexión. | El enlace de inicio de sesión usado ya no es válido. | Selecciona de nuevo Conecta Spotify para empezar una conexión nueva. |
| Spotify rechazó la conexión. Comprueba que el ID de cliente y el secreto de cliente coincidan con tu aplicación de Spotify y que la URI de redirección que muestra esta página esté registrada en esa aplicación. Luego vuelve a conectarte. | Spotify rechazó las credenciales o la Redirect URI. | Copia de nuevo el Client ID y el Client Secret desde los Settings de tu aplicación. Comprueba que la Redirect URI que muestra el panel esté registrada en tu aplicación de Spotify, carácter por carácter. Luego vuelve a conectarte. |
| Spotify no envió un nuevo token de inicio de sesión. Abre spotify.com/account/apps, elimina el acceso de tu aplicación y luego elige Conecta Spotify y acepta de nuevo. | Spotify no emitió un token nuevo para esta conexión. | Abre spotify.com/account/apps, elimina el acceso de tu aplicación y luego selecciona de nuevo Conecta Spotify y aprueba los permisos otra vez. |
| Añade tu aplicación de Spotify antes de conectar tu cuenta. | Todavía no hay ninguna aplicación de Spotify registrada. | Vuelve al paso Añade tus claves, pega el Client ID y el Secreto de cliente, y selecciona Guardar y continuar. |
| La configuración de Spotify no está disponible de nuestro lado por ahora. Inténtalo más tarde. Si dura más de un día, escribe a support@itsbagelbot.com. | El problema viene de ItsBagelBot, no de tu aplicación de Spotify. | Inténtalo más tarde. Si dura más de un día, escribe a support@itsbagelbot.com. |
| No se pudo guardar el token. Inténtalo de nuevo en un momento. | Spotify aceptó la conexión, pero ItsBagelBot no pudo guardar la credencial de acceso. | Espera un momento y selecciona de nuevo Conecta Spotify. |
| Estos valores no parecen un ID de cliente y un secreto de cliente. Vuelve a copiarlos desde la página Settings de tu aplicación en el panel para desarrolladores de Spotify, sin espacios. | Los dos valores no parecían un Client ID y un Client Secret válidos, así que no se guardaron. | Vuelve a copiarlos desde la página de Settings de tu aplicación en Spotify, pégalos sin espacios y luego selecciona Guardar y continuar. |
| No se pudo guardar la aplicación de Spotify. | Las credenciales no se pudieron guardar. | Selecciona de nuevo Guardar y continuar. Si vuelve a fallar, comprueba los valores e inténtalo más tarde. |
| La Redirect URI no está disponible de nuestro lado por ahora, así que todavía no puedes continuar. Inténtalo más tarde. | El panel no puede mostrarte la Redirect URI para copiarla. | Inténtalo más tarde. |
| A tu conexión de Spotify le falta un permiso necesario para las peticiones de canciones. Vuelve a conectarte para concederlo. | La conexión de Spotify se hizo sin un permiso que necesitan las peticiones. | Selecciona Reconectar Spotify y luego aprueba los permisos en la pantalla de Spotify. |
| A tu inicio de sesión de Twitch le falta el permiso de acceso a los puntos del canal que necesita esta recompensa. Vuelve a conectarte con Twitch para concederlo. | Tu inicio de sesión de Twitch no incluye el permiso de acceso a los puntos del canal. Es un permiso de Twitch, no de Spotify. | Selecciona Volver a iniciar sesión con Twitch y aprueba el permiso. |
| Spotify ya no acepta esta conexión, así que las peticiones de canciones están en pausa. Vuelve a conectarte para reanudarlas. | Spotify dejó de aceptar la conexión guardada. La página también muestra Hay que reconectar. | Reconecta Spotify. Si falla, sigue la fila sobre «Spotify no envió un nuevo token de inicio de sesión». |
| Saltar una pista requiere Spotify Premium. | El botón Saltar requiere Premium en la cuenta conectada. | Usa una cuenta con Premium. |
| No hay ningún dispositivo de Spotify activo. Empieza primero una reproducción. | Spotify no está reproduciendo en ningún dispositivo. | Abre Spotify en un dispositivo, pon una canción y vuelve a intentarlo. |
| Spotify ya no acepta esta conexión. Reconéctala y vuelve a intentarlo. | La conexión dejó de funcionar mientras pulsabas Saltar. | Reconecta Spotify y luego vuelve a saltar la pista. |
| No se puede contactar con el servidor. Inténtalo de nuevo en un momento. | La página no pudo cargar los ajustes de las peticiones de canciones. | Espera un momento y recarga la página. |
| Ponle un título a la recompensa. | El campo Título de recompensa está vacío. | Escribe un título y luego guarda la recompensa de nuevo. |
| Escribe un número entero de puntos, de al menos 1. | El Coste en puntos no es un número entero de al menos 1. | Escribe un número entero, 1 o más. |
| Escribe una espera entre 0 segundos y 7 días. | La Espera global está fuera del rango permitido. | Escribe una espera de 0 segundos (desactivado) a 7 días. |
| No se pudo guardar la recompensa. | La recompensa no se pudo guardar. | Espera un momento y guarda de nuevo. |
| No se pudo eliminar la recompensa. | La recompensa no se pudo eliminar. | Espera un momento y vuelve a intentarlo. |
| No se pudieron guardar los ajustes del comando. | Los ajustes de Comando de chat (!sr) no se pudieron guardar. | Cambia de nuevo el ajuste, o recarga la página y vuelve a intentarlo. |
| No se pudo guardar el interruptor. | El interruptor Activar peticiones de canciones no se pudo guardar. | Recarga la página, comprueba el interruptor y vuelve a intentarlo. |
| No se pudieron guardar los límites. | Los Límites por espectador no se pudieron guardar. | Selecciona de nuevo Guardar límites. |
| No se pudo saltar la pista. Inténtalo de nuevo en un momento. | El botón Saltar no tuvo éxito. | Espera un momento y vuelve a saltar la pista. |
| No se pudo desconectar Spotify. | La desconexión no tuvo éxito. | Espera un momento y vuelve a intentarlo. |
| No se pudo eliminar la aplicación de Spotify. | No se pudo eliminar la aplicación de Spotify guardada. | Espera un momento y vuelve a intentarlo. |
| No se pudo copiar. Selecciona la URL y cópiala manualmente. | Tu navegador bloqueó el botón de copiar. | Selecciona la Redirect URI con el ratón y cópiala a mano. |
| Spotify está conectado, pero rechazó el acceso a esta cuenta. En modo de desarrollo, la cuenta propietaria de tu aplicación de Spotify necesita Premium. Pasa esa cuenta a Premium en Spotify y luego vuelve a conectarte. | La conexión funcionó, pero Spotify rechazó el acceso a esta cuenta. En modo de desarrollo, la cuenta propietaria de tu aplicación de Spotify necesita Premium. | En Spotify, pasa la cuenta propietaria de tu aplicación a Premium. Luego vuelve a conectarte desde la página de Peticiones de canciones. |
| Spotify está conectado, pero esta cuenta no está entre los usuarios permitidos de tu aplicación. En el panel para desarrolladores de Spotify, añade esta cuenta a los usuarios de tu aplicación y luego vuelve a conectarte. | La conexión funcionó, pero esta cuenta no aparece en la lista de usuarios permitidos de tu aplicación. | En el panel para desarrolladores de Spotify, abre los ajustes de tu aplicación y añade esta cuenta de Spotify a los usuarios de la aplicación. El nombre de esta pestaña puede variar, así que busca los ajustes de gestión de usuarios. Luego vuelve a conectarte desde la página de Peticiones de canciones. |
| Lo que ves | Lo que significa | Qué hacer |
|---|---|---|
| @viewer las peticiones de canciones todavía no están configuradas. | La configuración no está terminada en el canal. | Termina la configuración de arriba. |
| @viewer las peticiones de canciones están en pausa hasta que se vuelva a conectar Spotify en este canal. | Spotify dejó de aceptar la conexión guardada. | Selecciona Reconectar Spotify en la página de Peticiones de canciones. |
| @viewer las peticiones de canciones requieren Spotify Premium en este canal. | La cuenta conectada no tiene Premium. | Conecta una cuenta con Premium. |
| @viewer Spotify no está reproduciendo música en ningún dispositivo por ahora. | Spotify no tiene ningún dispositivo activo. | Abre Spotify y pon una canción. |
| @viewer Spotify está ocupado por ahora, inténtalo de nuevo en un momento. | Spotify está temporalmente ocupado. | Espera un momento y vuelve a pedirla. |
| @viewer ese enlace de Spotify no es compatible. Comparte un enlace a una canción o un álbum. | El espectador compartió un enlace que no es una canción ni un álbum. | Comparte un enlace a una canción o un álbum, o un nombre de canción. |
| @viewer la búsqueda de música no funciona por ahora, inténtalo de nuevo en un momento. | La búsqueda de canciones no está disponible por ahora. | Inténtalo más tarde. |
| @viewer las peticiones de música en el chat están desactivadas por ahora. | Permitir !sr está desactivado. | Activa Permitir !sr. |
| @viewer las peticiones de música están reservadas a un grupo más reducido por ahora. | El espectador no forma parte del grupo elegido en Quién puede añadir a la cola. | Cambia Quién puede añadir a la cola si quieres que pueda pedir canciones. |
| @viewer las peticiones de música solo funcionan cuando el stream está en directo. | Solo en directo está activado y el stream está sin conexión. | Inicia tu directo, o desactiva Solo en directo. |
| @viewer no se encontró ninguna pista. Prueba con un enlace de Spotify o «artista - título». | Spotify no encontró ninguna coincidencia. | Prueba con un enlace de Spotify o un par «artista - título». |
| @viewer llegaste a tu límite de canciones (N en cola a la vez). !sr remove libera un lugar. | El espectador llegó a su límite en Límites por espectador. | Espera a que pase una canción, o sube el límite. |
| @viewer la cola de canciones está llena por ahora. | La cola llegó a su tamaño máximo. | Espera a que pasen canciones. |
| las peticiones de canciones con puntos del canal están desactivadas por ahora, tus puntos se han devuelto. | Aceptar canjes de recompensas está desactivado. | Activa Aceptar canjes de recompensas. |
| las peticiones de canciones solo funcionan durante una transmisión en directo, tus puntos se han devuelto. | Solo en directo está activado en la tarjeta de Puntos del canal y el stream está sin conexión. | Inicia tu directo, o desactiva Solo en directo. |
| escribe el nombre de una canción o un enlace de Spotify, tus puntos se han devuelto. | El espectador canjeó la recompensa sin escribir una canción. | Canjea de nuevo escribiendo el nombre de una canción o un enlace de Spotify. |
| llegaste a tu límite de canciones por ahora, tus puntos se han devuelto. | El espectador llegó a su límite. | Espera a que pase una canción. |
| la cola de canciones está llena, tus puntos se han devuelto. | La cola llegó a su tamaño máximo. | Espera a que pasen canciones. |
| esta pista no se pudo añadir a la cola, tus puntos se han devuelto. | Spotify no pudo añadir esta pista. | Canjea de nuevo con otra canción. |
| @viewer no tienes ninguna canción en cola que quitar. | El espectador usó !sr remove sin tener ninguna canción en cola. | Nada que corregir. El espectador primero puede pedir una canción. |
| No hay ninguna canción en la posición #N. | Un moderador quitó una posición que no está en la cola. | Comprueba la posición correcta en la tarjeta Cola y vuelve a intentarlo. |
05Pedir ayuda a una IA
Cada paso de la configuración tiene un botón Pide ayuda a tu IA. Copia un mensaje en tu portapapeles. El mensaje indica en qué paso estás, incluye el mensaje que muestra el panel y la Redirect URI, y contiene un enlace a esta guía. Pégalo en ChatGPT, Claude o Gemini. Nunca pegues tu Client Secret en la conversación. La IA no lo necesita.