1. Crear app de Spotify

Para que Jaleo pueda interactuar con Spotify, necesitas crear una aplicación en el Spotify Developer Dashboard. Esto te dará un Client ID y un Client Secret que la API necesita para autenticar a los usuarios.

Paso 1: Acceder al Spotify Developer Dashboard

Ve a developer.spotify.com/dashboard e inicia sesión con tu cuenta de Spotify (la que tiene Premium).

Paso 2: Crear la aplicación

1. Haz clic en “Create app”
2. Rellena el formulario:
   • App name: Jaleo (o el nombre que prefieras)
   • App description: Bot de WhatsApp para controlar Spotify en grupos
   • Redirect URI: https://tudominio.com/callback (reemplaza tudominio.com con tu dominio real, por ejemplo https://jaleo.miejemplo.com/callback)
   • Web API: marca la casilla para habilitar la Web API
3. Haz clic en “Save”

Caution

La redirect URI debe ser exactamente https://tudominio.com/callback con HTTPS. Si usas otro dominio o puerto, cambiará. Si la cambias después, también tendrás que actualizarla en el Dashboard de Spotify.

Paso 3: Obtener las credenciales

Una vez creada la app, verás en la página principal:

• Client ID: Una cadena como 60561c99861c432eb9ace1b6976f88ad
• Client Secret: Haz clic en “View client secret” para revelarlo. Será algo como f5c6420b433640ac9cf7b81bb3b81984

Guarda el Client ID y el Client Secret en un lugar seguro. Los necesitarás en el archivo .env de jaleo-api.

Paso 4: Configurar los scopes

Los scopes ya están definidos en el código de jaleo-api, pero es bueno saber cuáles se necesitan:

• user-modify-playback-state - Para reproducir, pausar, reanudar y saltar canciones
• user-read-playback-state - Para consultar la canción que está sonando
• user-read-currently-playing - Para obtener info de la canción actual

No necesitas configurar los scopes en el Dashboard. Se envían automáticamente cuando el usuario autoriza desde el enlace de vinculación.

Paso 5: Añadir usuarios de prueba (modo Development)

Por defecto, las apps de Spotify están en modo Development, que permite hasta 5 cuentas autorizadas. Mientras estés en modo Development:

1. En el Dashboard de tu app, ve a “Settings”
2. Busca la sección “User Management”
3. Añade las direcciones de correo de las cuentas de Spotify que quieres que puedan vincularse

Esto es relevante si quieres que otras personas con Spotify Premium puedan vincular sus cuentas en sus propios grupos. Si solo vas a usar tu cuenta, no necesitas añadir nada.

Note

En modo Development, la app solo funciona para las cuentas que añadas a la lista y la cuenta del creador. Si quieres que funcione para cualquier usuario de Spotify, necesitarás solicitar la aprobación de Spotify (Extended Quota Mode). Para un uso personal o de un grupo de amigos, 5 cuentas es suficiente.

Resumen de lo que tienes ahora

Deberías tener:

Dato	Valor de ejemplo
Client ID	60561c99861c432eb9ace1b6976f88ad
Client Secret	f5c6420b433640ac9cf7b81bb3b81984
Redirect URI	https://jaleo.miejemplo.com/callback

Guarda estos datos porque los usaremos en el siguiente paso.

Siguiente: Configurar VPS y dominio