Documentation

Guide SquadBot

Tout ce qu'il faut savoir pour installer SquadBot, configurer les permissions, et utiliser chaque commande disponible sur votre serveur Discord.

🚀 Installation

Ajouter SquadBot à votre serveur prend moins d'une minute. Suivez ces étapes :

1
Inviter le bot
Cliquez sur le bouton « Ajouter à Discord » en haut de la page, ou utilisez directement le lien d'invitation officiel. Vous serez redirigé vers le portail d'autorisation Discord.
2
Choisir votre serveur
Dans le menu déroulant, sélectionnez le serveur Discord sur lequel vous souhaitez installer SquadBot. Vous devez avoir la permission Gérer le serveur ou être administrateur pour l'ajouter.
3
Accepter les permissions
Discord vous présente la liste des permissions demandées par SquadBot. Acceptez-les toutes pour un fonctionnement optimal. Ces permissions sont détaillées dans la section Permissions ci-dessous.
4
Lancer la configuration
Une fois le bot présent sur votre serveur, tapez /setup dans n'importe quel salon textuel pour démarrer l'assistant de configuration guidé.
💡 SquadBot est entièrement gratuit et ne nécessite aucune inscription ni compte tiers. Il s'intègre directement à l'API Twitch pour détecter les lives de vos membres.

🔐 Permissions requises

SquadBot demande les permissions suivantes lors de son installation. Voici pourquoi chacune est nécessaire :

👁️ Voir les salons
Permet au bot de lire la liste des salons disponibles lors de la configuration avec /setup. Requise
✉️ Envoyer des messages
Indispensable pour poster les notifications de live dans le salon configuré. Requise
🖼️ Intégrer des liens
Permet d'afficher les aperçus enrichis (embed) : miniature du stream, jeu en cours, lien Twitch. Requise
👥 Voir les membres du serveur
Nécessaire pour lire les membres portant le rôle streamer afin d'identifier et surveiller leurs comptes Twitch. Requise
🏷️ Mentionner les rôles
Permet de mentionner le rôle « membres » configuré au moment d'une notification de live. Requise
🗑️ Gérer les messages
Utilisée pour supprimer ou modifier automatiquement la notification à la fin d'un live (selon le comportement configuré). Requise
📎 Joindre des fichiers
Peut être utile pour l'affichage de miniatures dans certains contextes de canal. Optionnelle
⚠️ Si SquadBot ne parvient pas à envoyer de messages dans le salon configuré, vérifiez que ces permissions sont bien accordées au niveau du salon lui-même, et pas seulement au niveau du serveur.

⚙️ Configuration initiale

Après avoir ajouté SquadBot, lancez la commande /setup pour démarrer l'assistant. Il vous guidera à travers cinq étapes interactives :

1 Langue Choisissez entre le français et l'anglais pour les réponses du bot.
2 Salon de notifications Sélectionnez le salon textuel où les annonces de live seront postées.
3 Rôle Streamers Désignez le rôle attribué aux membres dont les lives doivent être surveillés.
4 Rôle à mentionner Choisissez le rôle qui sera mentionné dans chaque notification.
5 Comportement de fin de live Supprimer la notification ou la remplacer par un lien VOD.
ℹ️ Important : SquadBot identifie les streamers en faisant correspondre leur pseudo affiché sur Discord avec un login Twitch. Si le pseudo Discord d'un membre diffère de son login Twitch, utilisez la commande /set_streamer pour lier manuellement les deux comptes.

⌨️ Référence des commandes

Toutes les commandes de SquadBot sont des commandes slash (préfixées par /). Les commandes marquées Admin nécessitent la permission Administrateur sur le serveur.

Configuration du serveur

Lance l'assistant de configuration interactif en plusieurs étapes. Permet de définir le salon de notifications, le rôle streamers à surveiller, le rôle à mentionner (ou aucun ping) et le comportement de fin de live.

À la fin de la configuration, SquadBot abonne automatiquement tous les membres portant le rôle streamer (en résolvant leur pseudo Discord en login Twitch) et vérifie si certains d'entre eux sont déjà en live.

Cette commande peut être relancée à tout moment pour mettre à jour la configuration du serveur.

Affiche un récapitulatif de la configuration actuelle du serveur : salon de notifications, rôle streamers, rôle à mentionner et langue du bot. Réponse visible uniquement par l'administrateur (éphémère).

Modifie le comportement du bot lorsqu'un streamer termine son live. Deux options sont disponibles :

delete 🗑️ Supprimer le message de notification dès la fin du live.
vod 📼 Remplacer la notification par un lien vers le VOD Twitch (si disponible).
Paramètre
behavior Le comportement souhaité. Choisir entre delete ou vod.
Gestion des streamers

Abonne un membre Discord aux notifications de live. SquadBot résout automatiquement le pseudo Discord du membre en login Twitch correspondant.

Sans paramètre, la commande s'applique à l'utilisateur qui l'exécute. Un administrateur peut abonner n'importe quel autre membre en spécifiant le paramètre member.

Paramètre
member optionnel Le membre Discord à abonner. Réservé aux administrateurs. Laissez vide pour vous abonner vous-même.
⚠️ La résolution automatique du login Twitch repose sur le pseudo affiché sur le serveur Discord. Si ce pseudo ne correspond pas exactement au login Twitch, utilisez /set_streamer pour lier les comptes manuellement.

Retire un streamer des notifications de live. Sans paramètre, désabonne l'utilisateur lui-même. Les administrateurs peuvent désabonner n'importe quel membre via member, ou un streamer externe via login.

Note : les paramètres member et login sont mutuellement exclusifs.

Paramètres
member optionnel Le membre Discord à désabonner. Réservé aux administrateurs. Laissez vide pour vous désabonner vous-même.
login optionnel Login Twitch d'un streamer externe à désabonner. Réservé aux administrateurs. Ne pas utiliser avec member.

Permet de suivre un streamer Twitch qui n'est pas membre du serveur Discord. Les notifications seront envoyées dans le salon configuré, exactement comme pour un membre normal.

Utile par exemple pour notifier les lives d'un partenaire ou d'un créateur affilié à votre communauté.

Paramètre
login Le login Twitch du streamer à suivre (ex : squeezie, sardoche).

Affiche la liste complète de tous les membres abonnés aux notifications, avec leur login Twitch associé. Indique également si un salon dédié (/set_channel) a été configuré pour l'un d'eux.

Les membres dont le login Twitch n'a pas pu être résolu sont listés séparément avec une icône ❌.

Crée ou met à jour manuellement le lien entre un membre Discord et un compte Twitch. Indispensable lorsque le pseudo Discord d'un membre diffère de son login Twitch (pseudos accentués, underscores, etc.).

SquadBot vérifie que le login Twitch fourni existe bien avant d'enregistrer l'association.

Paramètres
member Le membre Discord à lier.
login Le login Twitch exact du membre (ex : squeezie). Insensible à la casse.
Salons dédiés

Attribue un salon d'annonce dédié à un streamer spécifique. Lorsqu'il sera en live, sa notification sera envoyée dans ce salon plutôt que dans le salon par défaut configuré via /setup.

Pratique pour organiser les annonces par streamer si votre communauté est grande.

Paramètres
member Le membre streamer auquel attribuer un salon dédié.
channel Le salon textuel à utiliser pour les annonces de ce streamer.

Supprime le salon dédié associé à un streamer. Après cette opération, ses notifications seront de nouveau envoyées dans le salon par défaut configuré lors du /setup.

Paramètre
member Le membre streamer dont supprimer le salon dédié.