10 min de lecture

01Ce qu'il vous faut

en brefSpotify Premium, votre propre application Spotify et Spotify en lecture sur un appareil.

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

Il vous faut le tableau de bord ItsBagelBot, connecté avec votre compte Twitch, et un compte Spotify. Le compte Spotify que vous connectez doit avoir Premium, pour que le bot puisse contrôler la lecture et ajouter les demandes de chansons à votre file. Les demandes passent par une application Spotify que vous créez vous-même dans le tableau de bord développeur de Spotify. Le compte propriétaire de cette application doit aussi avoir Premium, et Spotify permet à chaque application de connecter au maximum 5 comptes. La plupart des streamers utilisent un seul compte pour les deux rôles. Spotify doit aussi être en lecture sur un appareil (l'application de bureau, votre téléphone ou un lecteur web) pendant que les spectateurs demandent des chansons.

Mode développement et autres comptes Une nouvelle application Spotify démarre en mode développement. Dans ce mode, un compte qui n'est pas propriétaire de l'application doit être ajouté à la liste des utilisateurs autorisés de l'application dans le tableau de bord développeur de Spotify, sinon Spotify refuse ses requêtes. Connecter le compte propriétaire de l'application évite ce souci.

02Configurer Spotify dans le tableau de bord

en brefUne page de configuration, quatre étapes: Bienvenue, Créer ton application, Ajouter tes clés, Connecter Spotify.

Ouvrez dashboard.itsbagelbot.com/songqueue. Tant que Spotify n'est pas connecté, la page affiche une configuration en quatre étapes: Bienvenue, Créer ton application, Ajouter tes clés et Connecter Spotify. Suivez les étapes ci-dessous dans l'ordre. Chaque étape de la configuration a un bouton «Demande de l’aide à ton IA», décrit à la fin de ce guide.

Démarrer la configuration

À l'étape Bienvenue, lisez la note «Spotify Premium est requis», puis sélectionnez Configurer Spotify.
Ouvrir le tableau de bord développeur Spotify

À l'étape Créer ton application, sélectionnez Ouvrir le tableau de bord Spotify. Cela ouvre developer.spotify.com/dashboard dans un nouvel onglet. Connectez-vous avec le compte Spotify qui sera propriétaire de l'application.
Créer l'application sur Spotify

Dans le tableau de bord développeur de Spotify, sélectionnez Create an App. Donnez un nom et une description à l'application, acceptez les conditions d'utilisation pour développeurs (Developer Terms of Service) et créez l'application. Spotify affiche le nom et la description à toute personne qui se connecte par elle, choisissez donc quelque chose que vous reconnaissez.
Copier la Redirect URI

Revenez à l'onglet ItsBagelBot. Sous URI de redirection, sélectionnez Copier. Le bouton devient «Redirect URI copiée.»
La coller dans votre application Spotify

Dans Spotify, ouvrez les paramètres de votre application. Collez la valeur dans le champ Redirect URIs et enregistrez vos modifications. Elle doit correspondre exactement, sans barre oblique ni espace en plus. Spotify la compare caractère par caractère.
Confirmer que l'application est créée

De retour dans ItsBagelBot, sélectionnez Mon application est prête. Si la Redirect URI est manquante, le bouton reste désactivé et la page explique que la valeur est indisponible pour le moment.
Copier votre Client ID et votre Client Secret

À l'étape Ajouter tes clés, passez sur Spotify et ouvrez les Settings de votre application. Copiez le Client ID. Affichez le Client Secret sur la même page et copiez-le aussi.
Coller les deux dans le tableau de bord

Collez la première valeur dans Client ID et la seconde dans Secret client, puis sélectionnez Enregistrer et continuer. Collez-les sans espaces. ItsBagelBot stocke le secret chiffré et ne le réaffiche jamais, recollez-le donc si vous le changez un jour.
Connecter votre compte Spotify

À l'étape Connecter Spotify, la page indique «Ton application est enregistrée et prête.» Sélectionnez Connecter Spotify. Spotify ouvre un écran d'autorisation. Approuvez les autorisations sur l'écran de Spotify. Fermer l'écran sans approuver interrompt la connexion. Un avertissement peut apparaître juste après la connexion. La connexion fonctionne quand même, et le tableau «En cas de problème» indique quoi faire.
Vérifier le résultat

Spotify vous ramène à la page Demandes de musiques. La zone Connexion affiche le badge Connecté et un message «Spotify connecté.» apparaît. Vous pouvez maintenant activer les demandes.

Gardez votre Client Secret privé Collez le Client ID et le Client Secret uniquement dans les champs du tableau de bord ItsBagelBot indiqués ci-dessus. Ne collez jamais un Client Secret dans une discussion avec une IA, sur un serveur Discord ou dans un message au support. S'il fuit, changez-le dans le tableau de bord développeur de Spotify et collez le nouveau dans ItsBagelBot.

03Activer les demandes de musique

en brefActivez le module, puis choisissez le chat, les points de chaîne, ou les deux.

Une fois Spotify connecté, la page Demandes de musiques affiche le reste de la configuration. Les deux chemins partagent la même file, et l'un peut être actif sans l'autre.

Activer le module

Activez Activer les demandes de musiques en haut de la page. Tant que c'est désactivé, la page indique que les demandes sont en pause et qu'aucun chemin n'alimente la file.
Configurer la commande de chat

Dans la carte Commande chat (!sr), activez Autoriser !sr. Sous Qui peut demander, choisissez parmi Moi uniquement, Modérateurs uniquement, VIP uniquement, Abonnés uniquement ou Tout le monde. En live uniquement est activé par défaut, donc les demandes ne fonctionnent que pendant votre stream. Désactivez-le pour autoriser les demandes hors ligne. Ces interrupteurs s'enregistrent dès que vous les changez.
Limiter le nombre de morceaux par spectateur

Cette étape est facultative. Dans Limites par spectateur, saisissez un nombre pour chaque palier (Tout le monde, Abonnés, VIP, Modérateurs) et sélectionnez Enregistrer les limites. Un palier vide signifie aucune limite. Vous n'êtes jamais limité.
Créer la récompense de points de chaîne

Dans la carte Points de chaîne, la ligne Demande de morceau indique «Non configurée» tant que vous n'avez pas créé la récompense. Ouvrez-la et sélectionnez Créer la récompense. Remplissez Titre de la récompense (par défaut «Passe une demande de musique»), Coût en points, Délai global (0 = désactivé) et Réponse chat. Couleur est facultative. La récompense apparaît dans le menu de points Twitch dès l'enregistrement.
Choisir ce qui se passe après un échange

Sous Après l'échange, choisissez: «Accomplir : la chanson se met en file (par défaut)», «Annuler : rembourser les points, ignorer la file», ou «Laisser en attente pour que les mods tranchent».
Accepter les échanges

Activez Accepter les échanges de récompense. Tant que c'est désactivé, les échanges sont remboursés et rien ne se met en file. En live uniquement dans cette carte est aussi activé par défaut. Désactivez-le pour autoriser les échanges hors ligne.

Les spectateurs tapent !sr suivi d'un titre, d'une paire «artiste - titre» ou d'un lien Spotify. Les échanges de points de chaîne fonctionnent pareil: le spectateur tape la chanson en échangeant la récompense. La carte File d'attente de la même page montre ce qui joue et ce qui attend, avec un bouton Passer.

#votre_chaine chat

SnackPackPanda !sr artiste - titre

ItsBagelBot @SnackPackPanda « Titre » de Artiste ajouté(e), position #2.

Une demande depuis le chat, comme le bot y répond.

04En cas de problème

en brefLes messages affichés par la configuration et le module, avec quoi faire.

Le premier tableau liste les messages que vous voyez dans le tableau de bord. Le second liste ce que les spectateurs voient dans le chat. Les messages sont copiés tels que le tableau de bord les affiche. La liste couvre les messages que vous êtes susceptible de voir.

Messages dans le tableau de bord.
Ce que vous voyez	Ce que ça signifie	Quoi faire
Spotify Premium est requis	Le compte connecté doit avoir Premium. Le compte propriétaire de votre application Spotify doit aussi avoir Premium, et chaque application peut connecter au maximum 5 comptes.	Connectez un compte avec Premium, vérifiez que le propriétaire de l'application a Premium, et restez à 5 comptes.
Vous avez fermé l’écran des autorisations Spotify avant de les approuver. Choisissez Connecter Spotify et approuvez les autorisations pour terminer.	Vous avez quitté l'écran d'autorisation de Spotify sans approuver, donc rien n'a été connecté.	Sélectionnez de nouveau Connecter Spotify, puis approuvez les autorisations sur l'écran de Spotify.
Le lien de connexion a expiré ou a été rejoué. Relancez la connexion.	Le lien de connexion utilisé n'est plus valide.	Sélectionnez de nouveau Connecter Spotify pour démarrer une nouvelle connexion.
Spotify a refusé la connexion. Vérifiez que l'identifiant client et le secret client correspondent à votre application Spotify et que l'URI de redirection affichée sur cette page est enregistrée dans cette application. Puis reconnectez-vous.	Spotify a rejeté les identifiants ou la Redirect URI.	Copiez de nouveau le Client ID et le Client Secret depuis les Settings de votre application. Vérifiez que la Redirect URI affichée dans le tableau de bord est enregistrée dans votre application Spotify, caractère pour caractère. Puis reconnectez-vous.
Spotify n’a pas envoyé de nouveau jeton de connexion. Ouvrez spotify.com/account/apps, supprimez l’accès de votre application, puis choisissez Connecter Spotify et acceptez de nouveau.	Spotify n'a pas émis de nouveau jeton pour cette connexion.	Ouvrez `spotify.com/account/apps`, supprimez l'accès de votre application, puis sélectionnez de nouveau Connecter Spotify et approuvez de nouveau les autorisations.
Ajoutez votre application Spotify avant de connecter votre compte.	Aucune application Spotify n'est encore enregistrée.	Retournez à l'étape Ajouter tes clés, collez le Client ID et le Secret client, puis sélectionnez Enregistrer et continuer.
La configuration de Spotify est indisponible de notre côté pour le moment. Réessayez plus tard. Si cela dure plus d’un jour, écrivez à support@itsbagelbot.com.	Le problème vient d'ItsBagelBot, pas de votre application Spotify.	Réessayez plus tard. Si cela dure plus d'un jour, écrivez à `support@itsbagelbot.com`.
Le jeton n'a pas pu être stocké. Réessayez dans un instant.	Spotify a accepté la connexion, mais ItsBagelBot n'a pas pu enregistrer le jeton.	Patientez un instant et sélectionnez de nouveau Connecter Spotify.
Ces valeurs ne ressemblent pas à un identifiant client et à un secret client. Copiez-les à nouveau depuis la page Paramètres de votre application dans le tableau de bord des développeurs Spotify, sans espaces.	Les deux valeurs ne ressemblaient pas à un Client ID et à un Client Secret valides, elles n'ont donc pas été enregistrées.	Copiez-les de nouveau depuis la page des paramètres de votre application dans Spotify, collez-les sans espaces, puis sélectionnez Enregistrer et continuer.
Impossible d'enregistrer l'application Spotify.	Les identifiants n'ont pas pu être enregistrés.	Sélectionnez de nouveau Enregistrer et continuer. Si cela échoue encore, vérifiez les valeurs et réessayez plus tard.
La Redirect URI est indisponible de notre côté pour le moment, tu ne peux donc pas encore continuer. Réessaie plus tard.	Le tableau de bord ne peut pas vous montrer la Redirect URI à copier.	Réessayez plus tard.
Il manque une permission à votre connexion Spotify pour les demandes de musique. Reconnectez-vous pour l'accorder.	La connexion Spotify a été faite sans une permission dont les demandes ont besoin.	Sélectionnez Reconnecter Spotify, puis approuvez les autorisations sur l'écran de Spotify.
Il manque à votre connexion Twitch l'autorisation d'accès aux points de chaîne nécessaire à cette récompense. Reconnectez-vous avec Twitch pour l'accorder.	Votre connexion Twitch n'inclut pas l'autorisation d'accès aux points de chaîne. C'est une permission Twitch, pas Spotify.	Sélectionnez Se reconnecter avec Twitch et approuvez la permission.
Spotify n'accepte plus cette connexion, les demandes de chansons sont donc en pause. Reconnectez-vous pour les reprendre.	Spotify a cessé d'accepter la connexion enregistrée. La page affiche aussi Reconnexion requise.	Reconnectez Spotify. Si cela échoue, suivez la ligne sur «Spotify n’a pas envoyé de nouveau jeton de connexion».
Passer une piste nécessite Spotify Premium.	Le bouton Passer demande Premium sur le compte connecté.	Utilisez un compte avec Premium.
Aucun appareil Spotify actif. Lancez d'abord une lecture.	Spotify ne joue sur aucun appareil.	Ouvrez Spotify sur un appareil, lancez un morceau, puis réessayez.
Spotify n'accepte plus cette connexion. Reconnectez-la puis réessayez.	La connexion a cessé de fonctionner pendant que vous appuyiez sur Passer.	Reconnectez Spotify, puis passez de nouveau la piste.
Impossible de joindre le serveur. Réessayez dans un instant.	La page n'a pas pu charger les réglages des demandes de musique.	Patientez un instant et rechargez la page.
Donnez un titre à la 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 en 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 global est hors de la plage autorisée.	Saisissez un délai de 0 seconde (désactivé) à 7 jours.
Impossible d'enregistrer la récompense.	La récompense n'a pas pu être enregistrée.	Patientez un instant et enregistrez de nouveau.
Impossible de supprimer la récompense.	La récompense n'a pas pu être supprimée.	Patientez un instant et réessayez.
Impossible d'enregistrer les réglages de la commande.	Les réglages de Commande chat (!sr) n'ont pas pu être enregistrés.	Changez de nouveau le réglage, ou rechargez la page et réessayez.
Impossible d'enregistrer l'interrupteur.	L'interrupteur Activer les demandes de musiques n'a pas pu être enregistré.	Rechargez la page, vérifiez l'interrupteur et réessayez.
Impossible d'enregistrer les limites.	Les Limites par spectateur n'ont pas pu être enregistrées.	Sélectionnez de nouveau Enregistrer les limites.
Impossible de passer la piste. Réessayez dans un instant.	Le bouton Passer n'a pas abouti.	Patientez un instant et passez de nouveau la piste.
Impossible de déconnecter Spotify.	La déconnexion n'a pas abouti.	Patientez un instant et réessayez.
Impossible de supprimer l'application Spotify.	La suppression de l'application Spotify enregistrée n'a pas abouti.	Patientez un instant et réessayez.
Copie impossible. Sélectionnez l'URL et copiez-la manuellement.	Votre navigateur a bloqué le bouton de copie.	Sélectionnez la Redirect URI à la souris et copiez-la à la main.
Spotify est connecté, mais a refusé l’accès à ce compte. En mode développement, le compte propriétaire de votre application Spotify a besoin de Premium. Passez ce compte à Premium dans Spotify, puis reconnectez-vous.	La connexion a fonctionné, mais Spotify a refusé l’accès à ce compte. En mode développement, le compte propriétaire de votre application Spotify a besoin de Premium.	Dans Spotify, passez le compte propriétaire de votre application à Premium. Reconnectez-vous ensuite depuis la page Demandes de musiques.
Spotify est connecté, mais ce compte ne fait pas partie des utilisateurs autorisés de votre application. Dans le tableau de bord des développeurs Spotify, ajoutez ce compte aux utilisateurs de votre application, puis reconnectez-vous.	La connexion a fonctionné, mais ce compte ne figure pas dans la liste des utilisateurs autorisés de votre application.	Dans le tableau de bord des développeurs Spotify, ouvrez les réglages de votre application et ajoutez ce compte Spotify aux utilisateurs de l’application. Le nom de cet onglet peut différer, cherchez donc les réglages de gestion des utilisateurs. Reconnectez-vous ensuite depuis la page Demandes de musiques.

Ce que les spectateurs voient dans le chat. «@viewer» représente le nom du spectateur et N un nombre.
Ce que vous voyez	Ce que ça signifie	Quoi faire
@viewer les demandes de musique ne sont pas encore configurées.	La configuration n'est pas terminée sur la chaîne.	Terminez la configuration ci-dessus.
@viewer les demandes de musique sont en pause jusqu'à ce que Spotify soit reconnecté sur cette chaîne.	Spotify a cessé d'accepter la connexion enregistrée.	Sélectionnez Reconnecter Spotify sur la page Demandes de musiques.
@viewer les demandes de musique nécessitent Spotify Premium sur cette chaîne.	Le compte connecté n'a pas Premium.	Connectez un compte avec Premium.
@viewer Spotify ne joue de musique sur aucun appareil pour le moment.	Spotify n'a aucun appareil actif.	Ouvrez Spotify et lancez un morceau.
@viewer Spotify est occupé pour le moment, réessaie dans un instant.	Spotify est temporairement occupé.	Patientez un instant et redemandez.
@viewer ce lien Spotify n'est pas pris en charge. Partage un lien vers un titre ou un album.	Le spectateur a partagé un lien qui n'est ni un titre ni un album.	Partagez un lien vers un titre ou un album, ou un nom de chanson.
@viewer la recherche musicale est en panne pour le moment, réessaie dans un instant.	La recherche de chansons est indisponible pour le moment.	Réessayez plus tard.
@viewer les demandes de musique dans le chat sont désactivées pour le moment.	Autoriser !sr est désactivé.	Activez Autoriser !sr.
@viewer les demandes de musique sont réservées à un groupe plus restreint pour le moment.	Le spectateur ne fait pas partie du groupe choisi sous Qui peut demander.	Changez Qui peut demander si vous voulez qu'il puisse demander.
@viewer les demandes de musique ne fonctionnent que lorsque le stream est en direct.	En live uniquement est activé et le stream est hors ligne.	Lancez votre live, ou désactivez En live uniquement.
@viewer aucune piste trouvée. Essaie un lien Spotify ou « artiste - titre ».	Spotify n'a trouvé aucune correspondance.	Essayez un lien Spotify ou une paire «artiste - titre».
@viewer tu as atteint ta limite de chansons (N en file à la fois). !sr remove libère une place.	Le spectateur a atteint sa limite sous Limites par spectateur.	Attendez qu'une chanson passe, ou augmentez la limite.
@viewer la file de chansons est pleine pour le moment.	La file a atteint sa taille maximale.	Attendez que des chansons passent.
les demandes de musique avec les points de chaîne sont désactivées pour le moment, tes points ont été remboursés.	Accepter les échanges de récompense est désactivé.	Activez Accepter les échanges de récompense.
les demandes de musique ne fonctionnent que pendant une diffusion en direct, tes points ont été remboursés.	En live uniquement est activé dans la carte Points de chaîne et le stream est hors ligne.	Lancez votre live, ou désactivez En live uniquement.
saisis un nom de chanson ou un lien Spotify, tes points ont été remboursés.	Le spectateur a échangé la récompense sans taper de chanson.	Échangez de nouveau en tapant un nom de chanson ou un lien Spotify.
tu as atteint ta limite de chansons pour le moment, tes points ont été remboursés.	Le spectateur a atteint sa limite.	Attendez qu'une chanson passe.
la file de chansons est pleine, tes points ont été remboursés.	La file a atteint sa taille maximale.	Attendez que des chansons passent.
ce titre n'a pas pu être ajouté à la file, tes points ont été remboursés.	Spotify n'a pas pu ajouter ce titre.	Échangez de nouveau avec une autre chanson.
@viewer tu n'as aucune chanson en file à retirer.	Le spectateur a utilisé `!sr remove` sans chanson en file.	Rien à corriger. Le spectateur peut d'abord demander une chanson.
Aucune chanson à la position #N.	Un modérateur a retiré une position qui n'est pas dans la file.	Vérifiez la bonne position dans la carte File d'attente et réessayez.

05Demander de l'aide à une IA

en brefLe tableau de bord peut copier un message prêt à l'emploi qui renvoie à ce guide.

Chaque étape de la configuration a un bouton Demande de l’aide à ton IA. Il copie un message dans votre presse-papiers. Le message nomme l'étape où vous êtes, inclut le message affiché par le tableau de bord et la Redirect URI, et contient un lien vers ce guide. Collez-le dans ChatGPT, Claude ou Gemini. Ne collez jamais votre Client Secret dans la discussion. L'IA n'en a pas besoin.

Note Vérifié le 12 octobre 2026.