20-sep: Home Assistant en VPS para control luces Alexa (gratis)

docs/configuracion-voicemonkey-luces.md

@@ -0,0 +1,62 @@
+# Configuración VoiceMonkey para luces Alexa
+
+## Resumen
+VoiceMonkey permite disparar rutinas de Alexa desde scripts Python mediante HTTP triggers.
+
+## Configuración necesaria en VoiceMonkey
+
+### 1. Crear "Monkeys" (triggers virtuales)
+Ir a https://voicemonkey.io/ → Dashboard → Add New Monkey
+
+#### Monkey 1: `apagar-barras`
+- **Name**: apagar-barras
+- **Routine**: "Alexa, apaga barras"
+- **Device**: (el Echo que ejecutará el comando, ej: echo-dot-de-nahid-ody8g)
+
+#### Monkey 2: `apagar-cuartillo`
+- **Name**: apagar-cuartillo
+- **Routine**: "Alexa, apaga cuartillo"
+- **Device**: (el mismo Echo)
+
+### 2. Variables de entorno (.env)
+```
+VOICEMONKEY_TOKEN=<tu-token-de-voicemonkey>
+VOICEMONKEY_DEVICE=<nombre-del-echo>
+```
+
+El token se obtiene en VoiceMonkey Dashboard → Settings → API Token.
+
+## Uso desde Python
+
+```python
+import urllib.request
+import os
+
+token = os.getenv("VOICEMONKEY_TOKEN")
+url = f"https://api-v2.voicemonkey.io/trigger?token={token}&device=apagar-barras"
+
+req = urllib.request.Request(url)
+with urllib.request.urlopen(req, timeout=10) as response:
+    if response.status == 200:
+        print("Luz apagada")
+```
+
+## Scripts que usan VoiceMonkey
+
+- `INFRAESTRUCTURA/scripts/protocolo_apagado.py` — apaga barras + cuartillo al apagar el PC
+- `INFRAESTRUCTURA/scripts/protocolo_apagado_test.py` — versión de prueba sin shutdown
+
+## Notas
+
+- Las luces "barras" y "cuartillo" deben estar configuradas en la app Alexa como dispositivos smart home
+- VoiceMonkey actúa como puente: recibe HTTP request → dispara rutina de Alexa → Alexa ejecuta comando de voz
+- Si las luces no se apagan, verificar:
+  1. Que los monkeys existen en VoiceMonkey
+  2. Que las rutinas de Alexa están activas
+  3. Que el token es correcto
+  4. Que el Echo está online
+
+## Referencias
+
+- VoiceMonkey: https://voicemonkey.io/
+- API docs: https://voicemonkey.io/docs