Intégration YouTube

Fourni avec strAImer : ce module s'installe avec l'application, il n'y a donc rien à télécharger. Il figure dans Catalogue de modules → Intégrés.

Ce qu'est cette page

La page connecte une chaîne YouTube à l'appli — comme sa description le dit, "Configurez l'intégration YouTube pour recevoir les messages du chat et gérer les diffusions." Elle existe en deux variantes : la chaîne elle-même, et un compte séparé depuis lequel le bot répond.

Comment la configurer

1. Ouvrez Connexions → Chaînes et ouvrez la page YouTube. Son en-tête indique Chaîne YouTube (Lit les événements, diffusion).
2. État de la connexion montre où vous en êtes : Déconnecté tant qu'aucune chaîne n'est connectée, Connecté en tant que {nom d'utilisateur} une fois qu'elle est en place, Reconnectez-vous en jaune quand YouTube a cessé d'accepter votre connexion, et Google a refusé les clés de l'application en rouge dans le cas rare décrit plus bas. L'indice à côté nomme ce qui est demandé : "Nécessite une autorisation pour vérifier les diffusions actives et envoyer des messages dans le chat YouTube."
3. Appuyez sur Autoriser via le navigateur. La page a un bouton et aucun champ pour un jeton — la connexion s'ouvre dans votre navigateur habituel et s'y termine.
4. Connectez-vous au compte Google qui possède la chaîne et acceptez les permissions. Laissez toutes les cases cochées. Google liste ses permissions une par une et vous permet de les décocher, et en décocher une est la raison la plus courante pour laquelle YouTube finit connecté et silencieux : sans la permission de voir vos diffusions, l'appli n'apprend jamais que vous êtes en direct, et un chat qu'elle ne peut pas trouver est un chat qu'elle ne peut pas lire. Depuis la version 0.9.2, l'appli refuse une telle connexion et le dit sur cette page ; avant, la connexion devenait simplement verte et rien n'arrivait. En cas de succès, la page du navigateur indique Autorisation réussie ! — "Le compte {nom d'utilisateur} a été connecté avec succès à YouTube", et en dessous, "Vous pouvez fermer cette fenêtre. Elle se fermera automatiquement dans quelques secondes." Pendant ce temps, la page du module affiche "Terminez la connexion dans la fenêtre du navigateur — cette page se mettra à jour toute seule.", au bout de deux minutes "Nous attendons toujours le navigateur…", et au bout de quinze minutes elle abandonne avec "La connexion n'a pas abouti. La fenêtre du navigateur a été fermée ou l'accès a été refusé — appuyez sur le bouton pour réessayer."
5. La page du module rapporte Configuration YouTube enregistrée avec succès ! et se ferme un moment plus tard. Nom du compte (connexion) montre maintenant la chaîne connectée ; le champ est en lecture seule.
6. Le chat arrive avec une diffusion : le module lit le chat en direct d'une diffusion en cours. Sans rien en direct, il n'y a rien à lire. Une diffusion publique est récupérée en une minute ; une non listée peut prendre jusqu'à une demi-heure, car elle n'est pas affichée sur la page de la chaîne et l'appli doit demander à Google — rarement, pour rester dans une limite de requêtes partagée par tous ceux utilisant strAImer. Appuyer sur Autoriser via le navigateur la trouve immédiatement. Le démarrage effectif du chat d'un stream en cours se voit sur la pastille YouTube dans Connexions → Chaînes, pas sur cette page : le guide « Connexion aux plateformes », section « YouTube : le chat arrive avec la diffusion », explique ce que signifie chaque pastille.
7. Si la connexion cesse de fonctionner plus tard, le badge passe au jaune, Reconnectez-vous, et le nom de la chaîne reste sur la page. Appuyez à nouveau sur Autoriser via le navigateur : le même bouton la renouvelle. Déconnecté ne signifie jamais une connexion expirée, seulement qu'aucune chaîne n'est connectée du tout.
8. La flèche en haut à gauche, Retour, quitte la page.

Le compte du bot

La même page sous Connexions → Bots est intitulée Compte bot YouTube (Envoie les réponses au chat), et elle fonctionne différemment de la page de chaîne ci-dessus : un bouton, pas deux.

1. Appuyez sur Connecter le bot. Une fenêtre s'ouvre dans l'appli : "connectez-vous au compte Google du bot, puis choisissez la chaîne YouTube sous laquelle il écrit. Un compte peut contenir plusieurs chaînes, et l'appli ne peut pas deviner laquelle vous voulez."
2. Connectez-vous en tant que le compte depuis lequel le bot doit répondre — pas le compte propre à la chaîne.
3. Choisissez la chaîne sur la page qui suit. Ce choix est ce que les viewers verront comme l'auteur des messages du bot.

Une fois connecté, le bouton change en Se reconnecter ou changer de chaîne et la ligne en dessous explique pourquoi la connexion existe : "Le bot écrit comme un navigateur, donc ses réponses et modérations n'utilisent pas la limite de requêtes YouTube partagée." Appuyez sur le même bouton pour déplacer le bot vers une autre chaîne du même compte.

Faites du bot un modérateur de votre chaîne. Sans cela, YouTube refuse les bans, time-outs et suppressions de messages, peu importe ce que fait l'appli — la modération est un droit accordé par la plateforme, pas un réglage ici.

Si la connexion enregistrée cesse de fonctionner, la page le dit : "La connexion enregistrée a cessé de fonctionner, donc le bot n'écrit pas. Appuyez sur le bouton pour vous reconnecter." Les connexions expirent — c'est la manière normale d'en renouveler une.

Si votre propre connexion cesse de fonctionner, le stream est toujours lu. Le statut affiche Reconnectez-vous, et la page explique ce qui s'arrête : "YouTube n’accepte plus votre connexion. L’application trouve toujours vos diffusions publiques et lit leur chat, mais tant que vous ne vous serez pas reconnecté, elle ne pourra ni envoyer de messages en votre nom ni trouver les diffusions visibles uniquement via le lien, et elle ne pourra modérer le chat qu’avec le compte bot." Cela ne marche que si l'application a déjà identifié votre chaîne. Sinon, la page indique qu'elle ne trouve pas votre diffusion, et la seule solution est de vous reconnecter avant de passer en direct.

Connecter le bot n'est pas une optimisation : sans lui, l'application se tait sur YouTube. C'est la partie à lire deux fois. Les minuteurs, les réponses aux commandes et l'agent IA sont des messages automatiques, et un message automatique sans connexion du bot derrière n'est pas envoyé du tout : la raison part dans la console de logs et nulle part ailleurs. Vos propres messages, tapés à la main dans la tuile du chat, font exception : ils partent qu'un bot soit configuré ou non, tant qu'un direct est en cours.

Quand la connexion existe mais cesse de fonctionner, le message n'est pas abandonné. Il part par la voie officielle sous le nom de votre propre chaîne, les spectateurs le voient donc de vous et non du bot. C'est un palliatif délibéré : le silence signifierait que les minuteurs, les réponses aux commandes et l'agent se taisent tous en même temps. L'application écrit un avertissement dans le log à chaque fois : un bot qui se met soudain à écrire sous votre nom est le signe que sa connexion doit être renouvelée.

Les deux cas exigent un direct réellement en cours. Sans rien en ligne, il n'y a pas de chat où écrire, et le message est refusé pour cette raison.

Si la page indique "Google a refusé les clés de l'application"

Ce badge rouge n'a rien à voir avec une connexion expirée : Google n'accepte plus les clés avec lesquelles l'application elle-même se connecte, et se reconnecter n'aide pas. La page l'explique avec un code : "Google n'accepte plus les clés avec lesquelles strAImer se connecte (code : {code}). Tant que strAImer n'est pas mis à jour, vous reconnecter ne servira à rien : mettez-le à jour puis reconnectez-vous. Si vous avez déjà la dernière version, écrivez-nous dans Aide & Retour → Contact." Donc : mettez l'application à jour, puis appuyez sur Autoriser via le navigateur ; si l'application est déjà à la dernière version, écrivez via Aide & Retour → Contact en citant le code.

D'ici là, une diffusion publique est toujours trouvée et son chat toujours lu, tant que l'application connaît déjà votre chaîne. L'envoi de messages en votre nom, les diffusions visibles uniquement via le lien et la modération autrement que par le bot ne fonctionnent pas.

Super Chats, stickers et adhésions à la chaîne

Ils n'arrivent que pendant une diffusion en direct, depuis le chat que le module lit.

• Les Super Chats et les Super Stickers arrivent comme des dons, dans la devise payée par le spectateur, et sont convertis dans votre devise de base comme n'importe quel autre don. Dans les listes qui choisissent quels dons comptent, comme Compter les dons de sur un objectif de collecte, ils forment la source YouTube Super Chat : si un objectif ignore les Super Chats, vérifiez que cette source y est cochée.
• Si l'application ne reconnaît pas la devise écrite sur un Super Chat, le montant arrive avec une devise inconnue, la console de logs affiche "Superchat currency not recognised", et un objectif de collecte ne peut pas le convertir : il ne fait donc pas avancer l'objectif.
• Les adhésions à la chaîne, y compris les adhésions offertes, arrivent comme des abonnements et non comme des dons : elles ne font donc pas avancer un objectif d'argent.

Ce qu'elle ne peut pas faire

• Il n'y a nulle part où coller un jeton, une clé d'accès ou une clé de rafraîchissement. Autoriser via le navigateur est le seul moyen d'entrer, et c'est aussi comment une connexion expirée est renouvelée.
• Nom du compte (connexion) ne peut pas être saisi. Pour connecter une autre chaîne, connectez-vous avec le compte qui la possède.
• La page n'affiche pas de liste de permissions par fonctionnalité — YouTube remet son ensemble à la connexion et la page rapporte seulement si le compte est connecté.
• Les clés de l'application refusées par Google ne peuvent pas être remplacées sur cette page : il n'y a pas de champ pour elles.
• Il n'y a pas de champs Google Client ID et Google Client Secret — comme le module le dit, "l'autorisation passe par l'appli strAImer elle-même, aucune clé nécessaire".
• La page n'a pas de bouton Enregistrer : tout est stocké à la fin de la connexion navigateur.
• Une diffusion ne peut pas être choisie ici, et rien sur la page n'en démarre une. La page n'a pas de champ pour une adresse de diffusion ou un lien vidéo.
• La page ne déconnecte pas le compte ni ne supprime la connexion, et elle ne désactive pas le module.
• La chaîne et le compte bot sont configurés séparément : une connexion ne remplit pas l'autre, et elles utilisent différentes fenêtres — la chaîne se connecte via le navigateur, le bot dans l'appli.
• La chaîne du bot ne peut pas être saisie. Elle est choisie dans la liste que la fenêtre de connexion montre, et seules les chaînes du compte avec lequel vous vous êtes connecté sont dessus.
• Rien sur la page n'avertit que les messages automatiques sont refusés. Le badge de la chaîne reste vert : il rend compte de la connexion de la chaîne, pas de celle du bot. Seule la console de logs dit pourquoi YouTube s'est tu.