Conectar Spotify

PlayBingo usa Spotify para reproducir canciones durante el juego. Esta guía te muestra cómo conectar tu cuenta y configurar todo correctamente.

Paso 1: Crear una app en Spotify Developer

💻 Recomendación: haz esta configuración desde un computador (es una sola vez).

1. Ve a developer.spotify.com/dashboard
2. Inicia sesión con tu cuenta de Spotify Premium (la primera vez, Spotify te pedirá aceptar los términos de desarrollador)
3. Haz clic en el botón Create app
4. Completa el formulario:
   • App name: Mi Bingo (o el nombre que quieras)
   • App description: Bingo musical (texto libre)
   • Redirect URIs: pega exactamente https://playbingo.cl/auth/callback y presiona el botón Add (debe quedar agregada en la lista)
   • Which API/SDKs are you planning to use?: marca la casilla Web API
5. Acepta los términos y haz clic en Save

Paso 2: Obtener credenciales

Ya dentro de tu app:

1. Presiona el botón Settings (arriba a la derecha de la pantalla de tu app)
2. Ahí verás el Client ID: cópialo
3. Haz clic en View client secret para mostrar y copiar el Client Secret
4. Pega ambos en PlayBingo: Dashboard → sección 🎵 Spotify → Configurar

Importante: Guarda el Client Secret en un lugar seguro. No lo compartas públicamente.

¿No agregaste el Redirect URI al crear la app? En Settings → Edit, sección Redirect URIs, agrégalo y guarda.

Paso 3: Conectar en PlayBingo

1. En tu dashboard de PlayBingo, ve a la sección Spotify
2. Haz clic en Conectar con Spotify
3. Serás redirigido a Spotify para autorizar la conexión
4. Acepta los permisos solicitados
5. Serás redirigido de vuelta a PlayBingo

Permisos requeridos

PlayBingo necesita los siguientes permisos de Spotify:

• playlist-read-private: Leer tus playlists privadas
• playlist-read-collaborative: Leer playlists colaborativas

Estos permisos permiten importar canciones de tus playlists para el juego.

Tipos de cuenta Spotify

Clave: Para importar playlists (públicas o personales) sí o sí necesitas cuenta Premium. Con cuenta gratuita solo puedes buscar/consultar canciones.

Reproducción en vivo: Durante el juego se usa el Web Playback SDK. Con cuenta gratuita solo suenan 30 segundos de cada canción; con Premium suenan completas.

Recomendación: Usa Premium para eventos en vivo donde los jugadores necesiten escuchar las canciones completas.

Importar canciones

Una vez conectado, puedes importar canciones de tres formas:

1. Por URL de Spotify

Playlists:

1. Abre Spotify y ve a la playlist que quieres importar
2. Haz clic en los tres puntos ... → Compartir → Copiar enlace
3. En PlayBingo, pega el enlace en el campo de importación
4. Haz clic en Importar

Álbumes:

1. Abre Spotify y ve al álbum
2. Haz clic en los tres puntos ... → Compartir → Copiar enlace
3. Pega el enlace en PlayBingo
4. Haz clic en Importar

Artistas:

1. Abre Spotify y ve al perfil del artista
2. Haz clic en los tres puntos ... → Compartir → Copiar enlace
3. Pega el enlace en PlayBingo
4. Haz clic en Importar

2. Por búsqueda

1. En la consola de la sala, usa el campo de búsqueda
2. Escribe el nombre de la canción, artista o álbum
3. Selecciona los resultados que quieres importar
4. Haz clic en Importar seleccionados

3. Ver mis playlists

Importante: Para ver e importar tus playlists personales necesitas una cuenta de Spotify Premium. Con cuenta gratuita solo puedes importar playlists públicas.

1. Haz clic en Ver Mis Playlists
2. Se mostrará una lista de tus playlists de Spotify
3. Haz clic en una playlist para importarla automáticamente
4. Todas las canciones de la playlist se agregarán a la sala

Desconectar Spotify

1. En la sección de Spotify, haz clic en Desvincular
2. Tu accessToken se eliminará
3. Tu refreshToken se mantiene para que los moderadores puedan usarlo

Nota: Los moderadores pueden seguir importando canciones usando tu token incluso después de que desconectes, siempre que no hayas eliminado el refresh token.

Solución de problemas

"No se pudo conectar con Spotify"

Causas posibles:

• Tu cuenta de Spotify no está activa
• La app en Spotify Developer no está configurada correctamente
• El Redirect URI no coincide

Solución:

1. Verifica que tu cuenta de Spotify esté activa
2. Ve al Spotify Developer Dashboard y verifica la configuración de tu app
3. Asegúrate de que el Redirect URI sea exactamente: http://127.0.0.1:3000/auth/callback (desarrollo) o https://playbingo.cl/auth/callback (producción)
4. Intenta desconectar y reconectar

"No se pueden importar canciones"

Causas posibles:

• La playlist/álbum/artista es privado
• No tienes permisos para acceder al contenido
• La conexión con Spotify expiró

Solución:

1. Verifica que el contenido sea público o que tengas acceso a él
2. Reconecta tu cuenta de Spotify
3. Intenta con un enlace diferente

"Solo se reproducen 30 segundos"

Causa: Estás usando una cuenta gratuita de Spotify.

Solución: Actualiza a Spotify Premium para reproducir canciones completas.

"Error 401: Token expirado"

Causa: El token de acceso de Spotify expiró.

Solución:

1. Desconecta y reconecta tu cuenta de Spotify
2. El sistema renovará automáticamente el token