# Configuración VoiceMonkey para luces Alexa

> **OBSOLETO desde 03-oct-2026.** Sustituido por **Home Assistant + Alexa Media Player**
> (gratis e ilimitado). Ver `docs/home-assistant-setup-alexa.md` y `scripts/ha_alexa.py`.
> Este documento se conserva solo como referencia histórica.

## 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