← Volver a Jaleo

📖 Documentación de Jaleo

Tu DJ de Spotify en WhatsApp. Solo una persona necesita Spotify Premium: el resto del grupo pide canciones en el chat y el bot las reproduce.

⏸ Estado actual: la instancia pública del bot está en pausa (migración del VPS a Vercel). Esta página y el código en GitHub están abiertos como portfolio. La guía de instalación completa se está reconstruyendo aquí; mientras tanto, el README del repo es la referencia.

Cómo funciona

Grupo de WhatsApp → IA (OpenClaw) → jaleo-api (Express) → Spotify API

Alguien escribe "pon Rosalía" en el grupo.
La IA interpreta el mensaje en lenguaje natural.
Llama al webhook de jaleo-api con la acción.
La API ejecuta la acción en Spotify (play, pause, queue, volumen…).

A diferencia de Spotify Jam, nadie necesita tener la app instalada: basta con escribir en el grupo.

Funcionalidades

Acción	Ejemplos
Reproducir	`"pon Bad Bunny"`, `"pon Rosalía saoko"`
Cola	`"añade esta a la cola"`
Pausar / Reanudar	`"pausa"`, `"sigue"`
Saltar	`"siguiente"`, `"salta esta"`
Volumen	`"volumen 50"`, `"sube el volumen"`
Qué suena	`"qué está sonando?"`

API del webhook

Endpoints

Método	Ruta	Descripción
GET	`/login?groupId=X`	Inicia OAuth con Spotify
GET	`/callback?code=X&state=X`	Callback OAuth
GET / POST	`/webhook`	Webhook principal

Parámetros del webhook

Parámetro	Requerido	Descripción
`action`	Sí	`play`, `queue`, `pause`, `resume`, `skip`, `now_playing`, `volume`
`groupId`	Sí	ID del grupo de WhatsApp
`query`	Para play / queue / volume	Término de búsqueda o nivel de volumen

Respuestas

Grupo no vinculado:

{
  "status": "ERROR",
  "error": "USUARIO_NO_VINCULADO",
  "link": "https://tudominio.com/login?groupId=XXXXX"
}

Éxito:

{
  "status": "OK",
  "track": "SAOKO"
}

Auto-hospedaje (resumen)

La guía paso a paso completa está en reconstrucción. Resumen de requisitos:

Servidor con Node.js 20+ (VPS, Raspberry, etc.)
Dominio con HTTPS (p. ej. Caddy con Let's Encrypt)
Número de WhatsApp dedicado + cuenta de Spotify Premium
App en Spotify Developer (Client ID + Secret)
API key de un proveedor de IA

Variables de entorno (ver .env.example en el repo): PORT, BASE_URL, SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET, REDIRECT_URI.

Referencia completa en el README de GitHub.

Stack técnico

jaleo-api: Node.js, Express, SQLite, Axios
Bot: WhatsApp + agente de IA (OpenClaw)
Proxy: Caddy con Let's Encrypt · Procesos: PM2
Auth: Spotify OAuth 2.0 con auto-refresh