Files
INFRAESTRUCTURA/docs/configuracion-voicemonkey-luces.md
2026-10-03 19:24:21 +02:00

2.1 KiB

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

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