Files
INFRAESTRUCTURA/docs/configuracion-voicemonkey-luces.md

63 lines
1.8 KiB
Markdown

# 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