6 min de lectura

01Lo que necesitas

de un vistazoUna cuenta de Govee Home, luces de color configuradas en la aplicación Govee Home y un canal de Twitch que pueda tener recompensas de puntos del canal.

¿Usas un asistente de IA? Dale ai.itsbagelbot.com/govee/setup.md. Esta página está escrita para asistentes y usa los nombres exactos de los botones.

Necesitas una cuenta de Govee Home y luces Govee ya configuradas en la aplicación Govee Home. Las luces que solo usan Bluetooth pueden no aparecer. También necesitas un canal de Twitch que pueda crear recompensas de puntos de canal. La página Puntos de canal del panel indica que Twitch solo deja crear recompensas a los canales afiliados y socios. Los espectadores gastan puntos del canal para cambiar el color de tus luces.

El panel tiene un botón «Pide ayuda a tu IA» en cada paso de la configuración. Copia un mensaje breve con el paso en el que estás, para que un asistente de IA pueda leer esta guía y ayudarte. Nunca pegues tu clave de API de Govee en una IA.

02Obtener tu clave de API de Govee

de un vistazoLa clave sale de la aplicación Govee Home y normalmente llega por correo electrónico.

Abrir la aplicación Govee Home

Abre la aplicación Govee Home en tu teléfono e inicia sesión con la cuenta que es dueña de tus luces.
Ir al formulario de clave

Ve a Perfil → Ajustes → «Apply for API Key». En algunas versiones de la aplicación, aparece en Acerca de.
Rellenar el formulario corto

Rellena el formulario corto y envíalo.
Esperar el correo

Govee suele enviar la clave por correo electrónico a la dirección de tu cuenta de Govee. Si no llega, revisa tu carpeta de spam y vuelve a hacer la solicitud.

Una clave nueva desactiva tus claves anteriores Generar una clave nueva en tu cuenta de Govee desactiva todas las demás claves activas de esa cuenta. Si otra herramienta usa una clave anterior, dejará de funcionar. Pide una clave nueva solo cuando la necesites.

03Conectar la clave en el panel

de un vistazoAbre la página Luces Govee. La primera vez, un asistente de cuatro pasos te guía.

Abre la página Luces Govee en el panel. El asistente tiene cuatro pasos: «Qué necesitas», «Obtén tu clave», «Pega tu clave» y «Tus luces».

Iniciar el asistente

En «Qué necesitas», elige «Configurar Govee».
Revisar la ruta

En «Obtén tu clave», el panel muestra la misma ruta de arriba en «En la aplicación Govee Home». También dice: «Una clave nueva desactiva cualquier clave anterior de tu cuenta de Govee.» Elige «Tengo mi clave» cuando llegue el correo.
Pegar tu clave

En «Pega tu clave», pega la clave del correo de Govee en el campo «Clave de API de Govee». La clave se guarda cifrada y nunca se vuelve a mostrar.
Guardarla

Elige «Guardar y continuar». El panel comprueba primero la clave con Govee.
Ver tus luces

En «Tus luces», el panel muestra «Luces compatibles con colores encontradas» y la cantidad. Elige «Configurar recompensas» para continuar.

Al guardar pueden aparecer dos mensajes. No significan lo mismo:

«Govee no aceptó esta clave. Revísala e inténtalo de nuevo.» La clave no se guardó. Pégala de nuevo.
«Clave guardada, pero Govee no respondió, así que todavía no se ha comprobado. Tus luces funcionarán en cuanto Govee vuelva a estar disponible. Si no funcionan, pega la clave de nuevo.» La clave está guardada y puedes continuar.

04Crear la recompensa de puntos de canal

de un vistazoUna recompensa por luz. Los espectadores escriben un color al canjearla.

Abrir la página Luces Govee

Activa «Activar luces Govee» si está desactivado. En «Tus luces», cada luz muestra «Sin configurar» hasta que tenga una recompensa.
Elegir una luz

Elige la luz que quieres que controlen los espectadores. Se abre el editor de recompensas.
Rellenar la recompensa

Configura el «Título de la recompensa», el «Coste (puntos)», el «Color de la tarjeta» y el «Tiempo de espera» (0 = desactivado). El campo «Respuesta en el chat» es opcional.
Elegir qué pasa después de ejecutarse

En «Después de ejecutarse», elige «Marcar como completada», «Devolver los puntos» o «Dejar para un moderador».
Crearla

Selecciona «Crear recompensa». El bot crea la recompensa en Twitch. Para editarla después, cambia los campos y elige «Guardar cambios».

Lo que escriben los espectadores

Cuando un espectador canjea la recompensa, escribe un color. Un nombre de color en inglés funciona, como blue. Un código hexadecimal también funciona, como #00ccff. Si activas «Permitir a los espectadores apagar la luz», un espectador puede escribir off para apagar la luz.

«Solo en directo» está activado por defecto «Solo en directo» significa que los canjes solo funcionan mientras tu stream está en directo. Es lo recomendado. Si lo desactivas, los espectadores pueden cambiar la luz aunque no estés en directo.

05Si hay un problema

de un vistazoLos mensajes que muestran el panel y el chat para las luces Govee, y qué hacer con cada uno.

En las líneas de chat de abajo, @viewer representa el nombre del espectador que canjeó la recompensa. Cada línea de devolución significa que el bot devolvió los puntos.

Lo que ves	Lo que significa	Qué hacer
«Govee no aceptó esta clave. Revísala e inténtalo de nuevo.»	Govee rechazó la clave. La clave no se guardó.	Copia de nuevo la clave desde el correo de Govee, sin espacios de más. Si pediste una clave más reciente después, usa la más reciente. Las claves anteriores dejan de funcionar cuando generas una nueva.
«Clave guardada, pero Govee no respondió, así que todavía no se ha comprobado. Tus luces funcionarán en cuanto Govee vuelva a estar disponible. Si no funcionan, pega la clave de nuevo.»	La clave se guardó, pero Govee no respondió cuando el panel la comprobó.	Sigue adelante. Prueba la recompensa un poco más tarde. Si las luces no cambian, pega la clave de nuevo.
«No se pudo guardar la clave.»	El panel no pudo almacenar la clave.	Inténtalo de nuevo en un momento.
«Govee ya no acepta esta clave de API. Elige Eliminar clave y luego pega una clave nueva de la aplicación Govee Home.»	La clave se había guardado, pero Govee ahora la rechaza. Una posible causa es una clave más reciente de la misma cuenta, que desactiva las anteriores.	Elige «Eliminar clave», pide una clave nueva en la aplicación Govee Home y pégala.
«No se pudieron cargar tus luces Govee. Revisa tu clave de API e inténtalo de nuevo.»	El panel no pudo obtener tu lista de luces de Govee. Puede que la clave sea incorrecta o que Govee no haya respondido.	Elige «Intentar de nuevo». Si vuelve a fallar, elige «Eliminar clave» y pega la clave otra vez.
«No se encontraron dispositivos Govee en esta cuenta.»	Govee no devolvió ningún dispositivo para esta clave. Es posible que las luces no estén añadidas a esta cuenta de Govee, o que solo usen Bluetooth.	Añade tus luces en la aplicación Govee Home y conéctalas al Wi-Fi, luego elige «Actualizar luces».
«No se encontraron luces Govee compatibles con colores en esta cuenta.»	Govee devolvió dispositivos, pero ninguno puede cambiar de color. Solo aparecen los modelos compatibles con colores.	Añade una luz de color a tu cuenta de Govee en la aplicación Govee, luego elige «Actualizar luces».
«No se puede contactar con el servidor. Inténtalo de nuevo en un momento.»	El panel no pudo contactar con ItsBagelBot.	Recarga la página en un momento.
«Vuelve a iniciar sesión para autorizar el acceso a los puntos de canal.»	El bot necesita acceso a los puntos del canal para crear recompensas en tu canal de Twitch.	Elige «Reconectar» y aprueba el acceso en Twitch.
Escribe tu clave de API de Govee.	El campo de la clave estaba vacío al guardar.	Pega la clave del correo de Govee y luego elige «Guardar y continuar» de nuevo.
Escribe un título para la recompensa.	El campo Título de la recompensa está vacío.	Escribe un título y luego guarda la recompensa de nuevo.
Escribe un número entero de puntos, de al menos 1.	El Coste (puntos) no es un número entero de al menos 1.	Escribe un número entero, 1 o más.
Escribe un tiempo de espera entre 0 segundos y 7 días.	El Tiempo de espera está fuera del rango permitido.	Escribe un tiempo de espera de 0 segundos (desactivado) a 7 días.
No se pudieron cambiar las luces Govee.	El interruptor Activar luces Govee no se guardó.	Recarga la página, comprueba el interruptor e inténtalo de nuevo.
No se pudo eliminar la clave.	La clave guardada no se pudo eliminar.	Espera un momento y elige «Eliminar clave» de nuevo.
«No se pudo guardar la recompensa.»	La recompensa no se creó ni se actualizó. Una posible causa es un canal que no es afiliado ni socio de Twitch, porque el panel indica que Twitch solo deja crear recompensas a esos canales.	Revisa el título y el coste, y vuelve a intentarlo. Si vuelve a fallar, comprueba que tu canal sea afiliado o socio de Twitch.
No se pudo eliminar la recompensa.	La recompensa no se pudo eliminar.	Espera un momento y vuelve a intentarlo.
«@viewer las luces solo cambian durante una transmisión en directo, tus puntos se han devuelto.»	Un espectador canjeó la recompensa mientras no estabas en directo y «Solo en directo» está activado.	Nada. Inicia tu directo, o desactiva «Solo en directo» si quieres cambios sin conexión.
«@viewer no se reconoció ese color, tus puntos se han devuelto. Prueba con un nombre como blue o un código hexadecimal como #00ccff.»	El espectador escribió algo que no es un nombre de color conocido ni un código hexadecimal.	Dile al espectador que escriba un nombre de color en inglés, como blue, o un código hexadecimal, como #00ccff.
«@viewer las luces todavía no están configuradas, tus puntos se han devuelto.»	El bot no encontró una configuración de Govee válida para esta luz en el momento del canje.	Abre la página Luces Govee. Comprueba que aparezca «Clave guardada» y que la luz tenga una recompensa.
«@viewer las luces cambian con demasiada frecuencia, tus puntos se han devuelto. Inténtalo de nuevo en un momento.»	Llegaron demasiados cambios de color al mismo tiempo, así que el bot retuvo este.	Pide al espectador que lo intente de nuevo en un momento. Añade un «Tiempo de espera» a la recompensa para espaciar los cambios.
«@viewer no se pudo conectar con las luces, tus puntos se han devuelto.»	Govee o la luz no respondieron.	Comprueba que la luz esté encendida y en línea en la aplicación Govee Home. Luego inténtalo de nuevo.

Verificado el 12 de octubre de 2026.