6 min de lecture

01Ce qu’il vous faut

en brefUn compte Govee Home, des lumières couleur configurées dans l’application Govee Home et une chaîne Twitch qui peut avoir des récompenses de points de chaîne.

Vous utilisez un assistant IA? Donnez-lui ai.itsbagelbot.com/govee/setup.md. Cette page est écrite pour les assistants et utilise les noms exacts des boutons.

Il vous faut un compte Govee Home et des lumières Govee déjà configurées dans l’application Govee Home. Les lumières qui utilisent uniquement le Bluetooth peuvent ne pas apparaître. Il vous faut aussi une chaîne Twitch qui peut créer des récompenses de points de chaîne. La page Points de chaîne du tableau de bord indique que Twitch ne laisse que les chaînes affiliées et partenaires en créer. Les spectateurs dépensent des points de chaîne pour changer la couleur de vos lumières.

Le tableau de bord a un bouton «Demande de l’aide à ton IA» à chaque étape de la configuration. Il copie un court message avec l’étape en cours, pour qu’un assistant IA puisse lire ce guide et vous aider. Ne collez jamais votre clé API Govee dans une IA.

02Obtenir votre clé API Govee

en brefLa clé vient de l’application Govee Home et arrive généralement par e-mail.

Ouvrir l’application Govee Home

Ouvrez l’application Govee Home sur votre téléphone et connectez-vous au compte qui possède vos lumières.
Aller au formulaire de clé

Allez dans Profil → Paramètres → «Apply for API Key». Sur certaines versions de l’application, il se trouve sous À propos.
Remplir le court formulaire

Remplissez le court formulaire et envoyez-le.
Attendre l’e-mail

Govee envoie généralement la clé par e-mail à l’adresse de votre compte Govee. Si elle n’arrive pas, vérifiez votre dossier de courrier indésirable, puis refaites la demande.

Une nouvelle clé désactive vos anciennes clés Générer une nouvelle clé sur votre compte Govee désactive toutes les autres clés actives de ce compte. Si un autre outil utilise une ancienne clé, il cesse de fonctionner. Demandez une nouvelle clé seulement quand vous en avez besoin.

03Connecter la clé dans le tableau de bord

en brefOuvrez la page Lumières Govee. La première fois, un assistant en quatre étapes vous guide.

Ouvrez la page Lumières Govee dans le tableau de bord. L’assistant a quatre étapes: «Ce qu’il te faut», «Obtenir ta clé», «Coller ta clé» et «Tes lumières».

Lancer l’assistant

Sur «Ce qu’il te faut», choisissez «Configurer Govee».
Vérifier le chemin

Sur «Obtenir ta clé», le tableau de bord affiche le même chemin que ci-dessus sous «Dans l’application Govee Home». Il dit aussi : «Une nouvelle clé désactive toutes les anciennes clés de ton compte Govee.» Choisissez «J’ai ma clé» quand l’e-mail est arrivé.
Coller votre clé

Sur «Coller ta clé», collez la clé de l’e-mail de Govee dans le champ «Clé API Govee». La clé est stockée chiffrée et jamais réaffichée.
L’enregistrer

Choisissez «Enregistrer et continuer». Le tableau de bord vérifie d’abord la clé auprès de Govee.
Voir vos lumières

Sur «Tes lumières», le tableau de bord affiche «Lumières compatibles couleur trouvées» et le nombre de lumières. Choisissez «Configurer les récompenses» pour continuer.

Deux messages peuvent apparaître à l’enregistrement. Ils ne veulent pas dire la même chose:

«Govee n’a pas accepté cette clé. Vérifiez-la et réessayez.» La clé n’a pas été enregistrée. Collez-la de nouveau.
«Clé enregistrée, mais Govee n’a pas répondu, elle n’a donc pas encore été vérifiée. Vos lumières fonctionneront dès que Govee sera de nouveau disponible. Si elles ne fonctionnent pas, collez à nouveau la clé.» La clé est enregistrée et vous pouvez continuer.

04Créer la récompense de points de chaîne

en brefUne récompense par lumière. Les spectateurs tapent une couleur quand ils l’échangent.

Ouvrir la page Lumières Govee

Activez «Activer les lumières Govee» si c’est désactivé. Sous «Vos lumières», chaque lumière affiche «Non configurée» tant qu’elle n’a pas de récompense.
Choisir une lumière

Choisissez la lumière que vous voulez laisser contrôler par les spectateurs. L’éditeur de récompense s’ouvre.
Remplir la récompense

Réglez le «Titre de la récompense», le «Coût (points)», la «Couleur de la tuile» et le «Délai de recharge» (0 = désactivé). Le champ «Réponse dans le chat» est facultatif.
Choisir ce qui se passe après l’exécution

Sous «Après l’exécution», choisissez «Marquer comme honorée», «Rembourser les points» ou «Laisser à un modérateur».
La créer

Choisissez «Créer la récompense». Le bot crée la récompense sur Twitch. Pour la modifier plus tard, changez les champs et choisissez «Enregistrer les modifications».

Ce que les spectateurs tapent

Quand un spectateur échange la récompense, il tape une couleur. Un nom de couleur en anglais fonctionne, comme blue. Un code hexadécimal fonctionne aussi, comme #00ccff. Si vous activez «Autoriser les spectateurs à éteindre la lumière», un spectateur peut taper off pour éteindre la lumière.

«En direct uniquement» est activé par défaut «En direct uniquement» signifie que les échanges ne fonctionnent que lorsque votre stream est en direct. C’est recommandé. Si vous le désactivez, les spectateurs peuvent changer la lumière même hors ligne.

05En cas de problème

en brefLes messages que le tableau de bord et le chat affichent pour les lumières Govee, avec quoi faire.

Dans les lignes de chat ci-dessous, @viewer représente le nom du spectateur qui a échangé la récompense. Chaque ligne de remboursement veut dire que le bot a rendu les points.

Ce que vous voyez	Ce que ça veut dire	Quoi faire
«Govee n’a pas accepté cette clé. Vérifiez-la et réessayez.»	Govee a refusé la clé. La clé n’a pas été enregistrée.	Copiez de nouveau la clé depuis l’e-mail de Govee, sans espace en trop. Si vous avez demandé une clé plus récente depuis, utilisez la plus récente. Les anciennes clés cessent de fonctionner quand vous en générez une nouvelle.
«Clé enregistrée, mais Govee n’a pas répondu, elle n’a donc pas encore été vérifiée. Vos lumières fonctionneront dès que Govee sera de nouveau disponible. Si elles ne fonctionnent pas, collez à nouveau la clé.»	La clé est enregistrée, mais Govee n’a pas répondu quand le tableau de bord l’a vérifiée.	Continuez. Essayez la récompense un peu plus tard. Si les lumières ne changent pas, collez à nouveau la clé.
«Impossible d’enregistrer la clé.»	Le tableau de bord n’a pas pu stocker la clé.	Réessayez dans un instant.
«Govee n’accepte plus cette clé API. Choisissez Supprimer la clé, puis collez une nouvelle clé depuis l’application Govee Home.»	La clé avait été enregistrée, mais Govee la refuse maintenant. Une cause possible est une clé plus récente sur le même compte, qui désactive les anciennes.	Choisissez «Supprimer la clé», demandez une nouvelle clé dans l’application Govee Home et collez-la.
«Impossible de charger vos lumières Govee. Vérifiez votre clé API et réessayez.»	Le tableau de bord n’a pas pu obtenir votre liste de lumières auprès de Govee. La clé est peut-être incorrecte, ou Govee n’a pas répondu.	Choisissez «Réessayer». Si cela échoue encore, choisissez «Supprimer la clé» et collez de nouveau la clé.
«Aucun appareil Govee trouvé sur ce compte.»	Govee n’a renvoyé aucun appareil pour cette clé. Les lumières ne sont peut-être pas ajoutées à ce compte Govee, ou elles n’utilisent peut-être que le Bluetooth.	Ajoutez vos lumières dans l’application Govee Home et connectez-les au Wi-Fi, puis choisissez «Actualiser les lumières».
«Aucune lumière Govee compatible couleur trouvée sur ce compte.»	Govee a renvoyé des appareils, mais aucun ne peut changer de couleur. Seuls les modèles compatibles couleur apparaissent.	Ajoutez une lumière couleur à votre compte Govee dans l’application Govee, puis choisissez «Actualiser les lumières».
«Impossible de joindre le serveur. Réessayez dans un instant.»	Le tableau de bord n’a pas pu joindre ItsBagelBot.	Rechargez la page dans un instant.
«Reconnectez-vous pour autoriser l’accès aux points de chaîne.»	Le bot a besoin de l’accès aux points de chaîne pour créer des récompenses sur votre chaîne Twitch.	Choisissez «Se reconnecter» et approuvez l’accès sur Twitch.
Saisissez votre clé API Govee.	Le champ de la clé était vide à l’enregistrement.	Collez la clé de l’e-mail de Govee, puis choisissez de nouveau «Enregistrer et continuer».
Saisissez un titre de récompense.	Le champ Titre de la récompense est vide.	Saisissez un titre, puis enregistrez de nouveau la récompense.
Saisissez un nombre entier de points, au moins 1.	Le Coût (points) n’est pas un nombre entier d’au moins 1.	Saisissez un nombre entier, 1 ou plus.
Saisissez un délai entre 0 seconde et 7 jours.	Le Délai de recharge est hors de la plage autorisée.	Saisissez un délai de 0 seconde (désactivé) à 7 jours.
Impossible de basculer les lumières Govee.	L’interrupteur Activer les lumières Govee n’a pas été enregistré.	Rechargez la page, vérifiez l’interrupteur et réessayez.
Impossible de supprimer la clé.	La clé enregistrée n’a pas pu être supprimée.	Patientez un instant et choisissez de nouveau «Supprimer la clé».
«Impossible d’enregistrer la récompense.»	La récompense n’a pas été créée ou mise à jour. Une cause possible est une chaîne qui n’est ni affiliée ni partenaire Twitch, car le tableau de bord indique que Twitch ne laisse que ces chaînes créer des récompenses.	Vérifiez le titre et le coût, puis réessayez. Si cela échoue encore, vérifiez que votre chaîne est affiliée ou partenaire Twitch.
Impossible de supprimer la récompense.	La récompense n’a pas pu être supprimée.	Patientez un instant et réessayez.
«@viewer les lumières ne changent que pendant une diffusion en direct, tes points ont été remboursés.»	Un spectateur a échangé la récompense pendant que vous étiez hors ligne et «En direct uniquement» est activé.	Rien. Lancez votre live, ou désactivez «En direct uniquement» si vous voulez des changements hors ligne.
«@viewer cette couleur n'a pas été reconnue, tes points ont été remboursés. Essaie un nom comme blue ou un code hexadécimal comme #00ccff.»	Le spectateur a tapé quelque chose qui n’est ni un nom de couleur connu ni un code hexadécimal.	Dites au spectateur de taper un nom de couleur en anglais comme blue, ou un code hexadécimal comme #00ccff.
«@viewer les lumières ne sont pas encore configurées, tes points ont été remboursés.»	Le bot n’a trouvé aucune configuration Govee fonctionnelle pour cette lumière au moment de l’échange.	Ouvrez la page Lumières Govee. Vérifiez que «Clé enregistrée» s’affiche et que la lumière a une récompense.
«@viewer les lumières changent trop souvent, tes points ont été remboursés. Réessaie dans un instant.»	Trop de changements de couleur sont arrivés en même temps, donc le bot a retenu celui-ci.	Demandez au spectateur de réessayer dans un instant. Ajoutez un «Délai de recharge» à la récompense pour espacer les changements.
«@viewer impossible de joindre les lumières, tes points ont été remboursés.»	Govee ou la lumière n’a pas répondu.	Vérifiez que la lumière est allumée et en ligne dans l’application Govee Home. Puis réessayez.

Vérifié le 12 octobre 2026.