1. Crear app de Spotify

Para que Jaleo pueda interactuar con Spotify, necesitas crear una aplicacion en el Spotify Developer Dashboard. Esto te dara 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 sesion con tu cuenta de Spotify (la que tiene Premium).

Paso 2: Crear la aplicacion

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, cambiara. Si la cambias despues, tambien tendras que actualizarla en el Dashboard de Spotify.

Paso 3: Obtener las credenciales

Una vez creada la app, veras en la pagina principal:

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

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

Paso 4: Configurar los scopes

Los scopes ya estan definidos en el codigo de jaleo-api, pero es bueno saber cuales se necesitan:

• user-modify-playback-state — Para reproducir, pausar, reanudar y saltar canciones
• user-read-playback-state — Para consultar la cancion que esta sonando
• user-read-currently-playing — Para obtener info de la cancion actual

No necesitas configurar los scopes en el Dashboard. Se envian automaticamente cuando el usuario autoriza desde el enlace de vinculacion.

Paso 5: Anadir usuarios de prueba (modo Development)

Por defecto, las apps de Spotify estan en modo Development, que permite hasta 25 cuentas autorizadas. Mientras estes en modo Development:

1. En el Dashboard de tu app, ve a “Settings”
2. Busca la seccion “User Management”
3. Anade 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 anadir nada.

Note

En modo Development, la app solo funciona para las cuentas que anadas a la lista y la cuenta del creador. Si quieres que funcione para cualquier usuario de Spotify, necesitaras solicitar la aprobacion de Spotify (Extended Quota Mode). Para un uso personal o de un grupo de amigos, 25 cuentas es suficiente.

Resumen de lo que tienes ahora

Deberias 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