INFRAESTRUCTURA/docs/configuracion-voicemonkey-luces.md

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

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