Documentation

1. Inviter le bot

1. Cliquez sur « Ajouter à Discord » depuis la page d’accueil.
2. Choisissez votre serveur (permission « Gérer le serveur » requise) et validez les permissions proposées : voir les salons, envoyer des messages, intégrer des liens, lire l’historique des messages, mentionner @everyone et les rôles.
3. Le bot apparaît dans votre liste de membres et poste un message de bienvenue (lien vers le panel, premiers pas) dans le premier salon où il peut écrire. Il ne poste ensuite aucune notification tant que vous n’en avez pas configuré.
4. Il n’a ni préfixe ni commande à retenir : seule la commande /aide (alias /help) rappelle, en message visible de vous seul, comment le configurer.

2. Se connecter au panel

1. Ouvrez dashboard.streamilf.com/dashboard.
2. Cliquez « Se connecter avec Discord » et autorisez l’accès : identité, adresse email et liste de vos serveurs (voir la politique de confidentialité).
3. Vos serveurs où vous avez « Gérer le serveur » s’affichent en deux groupes : ceux où le bot est présent (cliquez sur la carte du serveur pour le configurer) et ceux où il n’est pas encore installé (cliquez sur la carte pour l’inviter).

3. Ajouter une chaîne

• Twitch : saisissez le nom de la chaîne (ex. pseudo) ou son URL.
• YouTube : URL de la chaîne, @handle ou identifiant UC….
• Offre gratuite : jusqu’à 3 chaînes par serveur (illimité en Premium). Au-delà (par exemple après la fin du Premium), les chaînes en fin de liste sont signalées « Hors quota » : elles n’émettent plus, sans être supprimées — l’ordre de la liste (glisser-déposer) décide lesquelles restent actives.
• L’interrupteur à côté du nom d’une chaîne (Activer / Désactiver) la met en pause. Retirer (icône corbeille, deux clics) arrête son suivi ; ses réglages sont conservés et retrouvés si vous l’ajoutez de nouveau.

4. Configurer les notifications

Chaque chaîne propose un bloc par type d’événement — Twitch : live, clip, VOD ; YouTube : vidéo, live, VOD, Short. Pour chaque bloc :

• Activée : interrupteur du bloc (les types réservés au Premium sont verrouillés en gratuit).
• Salon de destination : où poster la notification — obligatoire pour activer.
• Message : texte avec variables {chaine}, {titre}, {url}, {plateforme}, {jeu}, et {notif} pour placer la mention où vous le souhaitez (sans {notif}, la mention est placée au début du message) — aperçu en direct.
• Messages longs ou sur plusieurs lignes (Premium) : au-delà de 200 caractères ou avec des retours à la ligne.
• Embed (Premium) : titre, description, couleur, et choix des éléments affichés (image, horodatage, avatar de la chaîne, logo de la catégorie), avec prévisualisation.
• Mention (Premium) : un rôle ou @everyone.
• Moment d’annonce de la VOD (bloc Nouvelle VOD Twitch uniquement) : Dès que la VOD est disponible (défaut — Twitch crée l’archive pendant le live, la VOD est donc annoncée pendant le stream) ou Uniquement à la fin du live (recommandé pour éviter le doublon entre la notification de live et celle de VOD).
• Miniature auto-actualisée (bêta, bloc Début de live Twitch uniquement) : actualise la miniature du stream dans la notification après un délai réglable par l’administrateur, au lieu de rester figée sur l’aperçu du tout début du live. Deux modes : En continu (à chaque fois que le délai est écoulé, tant que le live dure) ou Une seule fois. Sans effet si l’image de l’embed est désactivée ou remplacée par le logo de la catégorie — voir « Fonctionnalités en bêta » ci-dessous pour l’activer.
• Tester : envoie immédiatement une notification d’exemple dans le salon choisi, avec la configuration enregistrée — enregistrez d’abord vos modifications (1 test toutes les 10 secondes).

Pensez à Enregistrer chaque bloc : la prise en compte est immédiate.

5. Gratuit vs Premium

Le comparatif à jour est affiché sur la page d’accueil. Le Premium est gratuit, accordé sur demande : bouton « Demander le Premium » sur la page de votre serveur dans le panel, l’administrateur valide, et vous êtes prévenu par email. Aucun paiement.

• Indiquez votre email de contact et, si vous le souhaitez, un message.
• Une seule demande en attente par serveur.
• Si la demande est acceptée, les fonctionnalités Premium se déverrouillent immédiatement. Si le Premium expire ou est retiré, vos réglages sont conservés : les fonctions Premium cessent simplement d’agir, et reviennent telles quelles avec le Premium.

6. Fonctionnalités en bêta

Certaines fonctionnalités expérimentales sont marquées « Bêta » dans le comparatif — indépendantes du statut Premium (un serveur Premium n’y a pas automatiquement accès, et inversement). Elles sont activables serveur par serveur, sur simple demande auprès de l’administrateur via notre serveur Discord. Une fois l’accès accordé, le réglage correspondant apparaît normalement dans le panel.

7. Dépannage

• Pas de notification ? Vérifiez que le bloc est activé, qu’un salon est choisi, que la chaîne n’est ni en pause ni « Hors quota », et que le bot peut, dans ce salon, le voir, y écrire, intégrer des liens et lire l’historique (plus « Mentionner @everyone » pour les mentions @everyone ou d’un rôle non mentionnable). Un envoi refusé par Discord est signalé en haut de la page du serveur dans le panel, avec sa raison. Le bouton « Tester » permet de vérifier après correction.
• « Chaîne introuvable » : vérifiez l’orthographe exacte du nom Twitch ou utilisez l’URL complète de la chaîne YouTube. Les très nouvelles chaînes YouTube peuvent mettre quelques minutes à être trouvées.
• Les notifications mettent du temps à arriver ? Ça dépend du type de contenu : Twitch (début de live) est instantané (webhook temps réel EventSub) ; Twitch (clips et VOD) est détecté par sondage périodique (quelques minutes), Twitch ne proposant pas de webhook pour ces événements ; YouTube (vidéos, lives, VOD et Shorts) est reçu en push (WebSub) dès la publication ou la mise à jour sur la chaîne — généralement rapide, mais Google ne garantit aucun délai, d’où un sondage de secours (quelques minutes) qui rattrape les cas retardés ou manqués.
• Un Short annoncé comme une vidéo (ou l’inverse) ? Une vidéo de 60 s ou moins, ou portant le tag #shorts, est un Short ; entre 1 et 3 minutes, le bot vérifie auprès de YouTube si elle est publiée comme Short. Les cas limites sont rares mais possibles.
• Notification en double ? Ça ne devrait jamais arriver — chaque contenu n’est annoncé qu’une fois. Contactez-nous si vous constatez le contraire.
• Une autre question ? Page contact du site, ou notre serveur Discord.