Étape 3 : Récupérer le Client ID et générer le Client Secret
Une fois l'application créée, récupérez le Client ID.
Cliquez sur New Secret pour générer le Client Secret.
Étape 4 : Utiliser le Client ID et le Client Secret dans le bot Discord
Dans Discord, tapez les commandes :
!set_api_key twitch_id VOTRE_CLIENT_ID
!set_api_key twitch_secret VOTRE_CLIENT_SECRET
Vous recevrez une confirmation : ✅ Clés API Twitch enregistrées avec succès !
🤖 Utiliser l’IA du bot Discord (!ask & !reset_ask)
Que fait la commande !ask ?
!ask permet de dialoguer avec une intelligence artificielle (ChatGPT) directement dans Discord.
L’IA peut répondre à des questions, expliquer des concepts, ou générer du texte sur demande.
La commande est réservée aux administrateurs et superadmins du bot sur le serveur.
Suivi de la conversation : contexte intelligent
L’IA est capable de relire l’historique des messages !ask du salon et ses propres réponses pour comprendre le fil de la discussion.
Le contexte est propre à chaque salon Discord : il n’y a pas de mélange avec d’autres serveurs ou salons.
Le bot ignore tous les autres messages et ne tient compte que des échanges !ask et réponses IA.
Il n’utilise l’historique que dans la limite des derniers messages du salon (pratique pour garder la conversation fluide).
Réinitialiser le contexte avec !reset_ask
La commande !reset_ask permet d’effacer tout le contexte précédent dans le salon : l’IA repart alors d’une page blanche à la prochaine question !ask.
Le bot poste un message "🔁 Contexte réinitialisé" qui sert de repère : toute question !ask après ce message sera considérée comme le début d’une nouvelle conversation.
Très pratique pour changer complètement de sujet ou éviter que le bot mélange plusieurs discussions anciennes.
Plus la conversation dure longtemps sans reset, plus l’IA se souvient du fil, mais cela peut aussi utiliser davantage de crédits/tokens OpenAI.
Le reset n’est pas obligatoire, mais il est recommandé après un changement de sujet important, ou si le contexte devient trop lourd pour l’IA.
Bonnes pratiques
Si vous constatez que l’IA mélange des sujets, utilisez !reset_ask pour repartir de zéro.
Pensez à bien formuler vos questions, surtout si vous souhaitez que le bot fasse une recherche sur Internet (ajoutez par exemple "actuel", "aujourd’hui", "dernières infos", etc.).
Exemples
!ask Donne-moi les DERNIERS chiffres du chômage en France juin 2025
!reset_ask→ L’IA oublie la discussion précédente dans ce salon.
!ask Donne-moi les dernières actualités sur le jeu Diablo IV.
🛡️ Gestion des administrateurs du bot Discord
Qui peut gérer les administrateurs ?
Seul le propriétaire du serveur Discord peut ajouter ou retirer des administrateurs secondaires via les commandes.
Les administrateurs secondaires peuvent ensuite utiliser les commandes du bot réservées aux admins (comme !ask, !search, !youtube, !twitch, etc.).
⚠️ Pour accéder aux outils de gestion du dashboard (interface web), le propriétaire du serveur doit s’enregistrer une seule fois en tant que super admin avec la commande suivante : !superadmin PseudoDiscord
✅ Une fois superadmin, il pourra gérer les autres admins (ajout/retrait) directement depuis le dashboard sans passer par les commandes Discord.
Ajouter un administrateur secondaire
Depuis Discord, tapez la commande suivante :
!addadmin PseudoDeLUtilisateur
Exemple :
!addadmin David
✅ Le membre mentionné sera désormais administrateur et pourra utiliser les commandes admin du bot.
🖥️ Cette action peut également être effectuée via le dashboard (si vous êtes super admin).
Retirer un administrateur secondaire
Depuis Discord, tapez la commande suivante :
!removeadmin PseudoDeLUtilisateur
Exemple :
!removeadmin David
✅ Le membre ne pourra plus utiliser les commandes réservées aux admins.
Afficher la liste des administrateurs secondaires
Depuis Discord, tapez :
!listadmins
📋 Le bot affichera tous les administrateurs secondaires enregistrés pour ce serveur.
Envoyer un message privé à tous les membres (admin only)
Depuis Discord, tapez la commande suivante :
!mpall Votre message ici...
Le bot tentera d’envoyer un message privé à chaque membre du serveur (sauf bots et vous-même) avec 1 seconde de délai entre chaque envoi pour éviter le flood.
Seuls les administrateurs du bot (ajoutés via !addadmin ou !superadmin) peuvent utiliser cette commande.
⚠️ Utilisation à risque :
— N’abusez pas de cette commande : elle peut être considérée comme du spam par Discord et certains membres peuvent avoir bloqué la réception des MP de bots.
— Cette commande est à réserver aux annonces vraiment importantes pour la communauté.
— Discord peut limiter ou bloquer le bot s’il envoie trop de messages privés à la chaîne.
🎮 Créer un Looking For Group (LFG)
Que fait la commande !lfg ?
Elle permet de créer une annonce pour rechercher des joueurs sur un jeu.
Les autres membres peuvent rejoindre le groupe en cliquant sur la réaction ✅.
Le LFG se ferme automatiquement une fois le temps écoulé ou si l'organisateur l'annule.
ModeDeJeu : Le mode spécifique (Exemple : Classé, Ranked, etc. Ce champ peur rester vide mais placer quand meme les " ").
JoueursRecherchés : Le nombre de joueurs que tu recherches (hors toi).
Durée (optionnel) : Combien de temps le LFG reste actif. Format : 2h (heures) ou 30m (minutes). Par défaut : 24 heures.
Exemple :
!lfg "Apex Legends" "Battle Royale" "2" "1h"
Ce qu’il se passe après :
Le bot crée un message interactif dans le salon avec un bouton et la réaction ✅.
Les membres cliquent pour rejoindre. Le message est mis à jour automatiquement.
Le LFG se ferme automatiquement après la durée choisie ou si l'organisateur l'annule.
⚠️ Rappel :
Commande accessible uniquement aux super admin et admin secondaires.
📅 Créer et gérer un Événement
Que fait la commande !event ?
Elle permet d’organiser des événements à une date et heure précise.
Les membres peuvent s’inscrire à l’événement en cliquant sur la réaction ✅.
L’organisateur peut annuler l’événement avec le bouton ❌.
Le bot envoie un rappel automatique 30 minutes avant le début de l’événement à chaque participant.
Une fois terminé, l’événement expire automatiquement et est archivé.
C’est idéal pour organiser des rendez-vous, des tournois, ou des activités communautaires programmées.
🔔 L’heure de l’événement est automatiquement affichée dans le fuseau horaire local de chaque utilisateur grâce à Discord.
Créer un Événement
Commande de base :
!event create "Titre de l'événement" "Description" "YYYY-MM-DD HH:MM" ParticipantsMax
Exemple :
!event create "Tournoi Valorant" "Un tournoi intense en 5v5 pour les meilleurs tireurs !" "2025-04-25 20:00" 10
Explications des paramètres :
Titre de l'événement : Le nom affiché dans l'annonce.
Description : Un résumé ou message expliquant l'événement.
YYYY-MM-DD HH:MM : La date et l’heure de début de l’événement (heure locale du créateur, format 24h).
ParticipantsMax : Le nombre maximum de participants à inscrire.
Affichage intelligent de la date dans Discord :
Le bot utilise le système <t:TIMESTAMP:F> de Discord.
➡️ Chaque utilisateur voit l’heure de l’événement dans son propre fuseau horaire.
Exemple : un événement programmé à 20:00 en France apparaîtra à 14:00 au Québec.
Ce qu’il se passe après :
Le bot publie un message interactif dans le salon où tu exécutes la commande.
Les membres peuvent cliquer sur ✅ pour s’inscrire à l’événement.
L’organisateur (admin) peut annuler l’événement en cliquant sur le bouton ❌.
Fonctionnement de l’Événement :
✅ Chaque participant s’inscrit avec la réaction ✅.
📋 Le bot affiche la liste des participants en temps réel.
🔔 30 minutes avant le début, le bot envoie un message de rappel privé à chaque participant et un message dans le salon.
⏰ 48 heures après la date prévue, l’événement est automatiquement supprimé de la base de données.
⚠️ Rappel :
✅ Seuls les administrateurs peuvent créer des événements avec !event create.
📌 Respecte le format de date/heure : YYYY-MM-DD HH:MM (exemple : 2025-04-25 20:00).
📌 Le nombre de participants est limité par ParticipantsMax ➔ Au-delà, l'inscription est bloquée.
📅 Utiliser l’Agenda partagé (Calendrier Discord)
Qu’est-ce que l’agenda partagé ?
Un outil d’agenda en ligne dédié à chaque serveur Discord où le bot NexusIA est installé.
Permet d’afficher à tous les membres du serveur les prochains événements de la guilde, soirées, réunions, annonces, etc.
L’agenda est accessible à tous via un simple lien web public, mais seuls les administrateurs du bot peuvent le modifier.
Qui peut créer ou gérer un agenda ?
Création :Seul le super admin du bot sur le serveur (généralement le propriétaire du serveur Discord) peut créer un agenda pour ce serveur via le dashboard admin.
Activation/désactivation : Uniquement le super admin peut activer ou désactiver l’agenda.
Ajout/modification/suppression d’événements : Tous les super admins et admins secondaires du bot sur le serveur peuvent ajouter, modifier ou supprimer des événements dans l’agenda.
Consultation de l’agenda :Tous les membres (et même les visiteurs sans compte) peuvent consulter l’agenda via le lien public.
Comment fonctionne l’agenda ?
Activation par le super admin :
Dans le dashboard, sélectionnez votre serveur dans la section « Calendrier partagé ».
Cliquez sur « Créer l’agenda » puis « Activer ».
Une fois activé, un lien public s’affiche : https://dashboard.nexusia.fun/dashboard/calendar.html?server_id=VOTRE_ID
Ce lien est à partager sur Discord (salon d’annonce, pins, etc.) pour que toute la guilde puisse voir l’agenda.
Ajout/modification d’événements :
Connectez-vous au dashboard avec un compte ayant le rôle admin ou super admin sur le serveur.
Accédez au calendrier via le lien public ou le dashboard.
Cliquez sur un jour du calendrier pour ajouter ou modifier un événement (titre, description, couleur, etc.).
Pour supprimer un événement, ouvrez-le puis cliquez sur « Supprimer ».
Lecture seule pour les visiteurs :
Les utilisateurs non connectés ou qui ne sont pas admins du bot sur le serveur voient uniquement l’agenda en lecture seule, sans pouvoir ajouter ou modifier des événements.
Un bouton « Se connecter » apparaîtra si l’utilisateur veut s’authentifier pour obtenir les droits admin.
Fonctionnalités clés
Affichage du calendrier toujours à la bonne date (jours, mois, années corrects, gestion des années bissextiles).
Affichage du nom du serveur au-dessus du calendrier.
Coloration personnalisée des événements selon l’admin.
Historique limité à 3 mois (nettoyage automatique, pas de surcharge inutile).
Cas d’usage typiques
Programmer les soirées farming, raids, réunions de guilde, sorties, etc.
Informer les membres à l’avance sans spammer les salons Discord.
Centraliser toutes les dates importantes de la communauté sur un seul lien public, consultable même sur mobile.
ℹ️ Résumé des droits :
Super admin : Création/activation/désactivation du calendrier + gestion totale des événements.
Utilisateur simple : Accès lecture seule à l’agenda public.
📋 Fonctionnement des Rosters
Qu’est-ce qu’un roster ?
Un roster est une fiche d’organisation d’un groupe (ex : raid MMO, tournoi, etc.).
Chaque roster contient des classes/roles personnalisés définis par l’admin.
Les joueurs s’inscrivent eux-mêmes via un lien public, sans devoir être admin.
Qui peut créer un roster ?
Seuls les administrateurs ou superadmins peuvent créer, déployer ou valider des rosters.
Mais tout le monde peut s'y inscrire une fois le roster actif.
Comment ça fonctionne ?
L’admin crée un modèle de roster dans le dashboard admin (avec ses classes, description, etc.).
Une fois activé, il génère un lien public du style : /dashboard/roster.html?roster_id=...
Les utilisateurs peuvent consulter le lien et cliquer sur une classe pour s’y inscrire.
L’admin peut valider les pré-inscriptions depuis l’interface, ou les retirer.
Quand le roster est finalisé (par l’admin), les inscrits sont définitivement enregistrés.
✉️ Une fois le roster finalisé, chaque participant validé recevra automatiquement un message privé (DM) contenant les détails.
🔒 Assurez-vous d’avoir autorisés les messages privés depuis les membres du serveur pour pouvoir le recevoir.
💸 Transférer des NexusCoins à un autre utilisateur
Utilise la commande !give @pseudo 100 pour transférer des NexusCoins à un autre membre du même serveur Discord.
Le membre doit être présent sur le serveur (en ligne ou non) : il recevra les coins même s’il n’a jamais utilisé le bot.
Le transfert est immédiat et irréversible : vérifie toujours la mention et le montant avant d’envoyer !
Aucun historique de transaction n’est conservé : ces transferts sont anonymes et non traçables après coup.
Si tu tentes d’envoyer plus de coins que tu n’en possèdes, le transfert sera refusé.
Impossible d’envoyer à soi-même ou à un bot.
Exemple : !give @David 500
🎲 Lancer de dés (D&D, jeux de rôle, etc.)
Le bot permet de lancer des dés pour tes parties de jeu de rôle, concours, ou simples décisions aléatoires.
Commande de base : !roll (lance 1d20)
Tu peux personnaliser le lancer :
!roll d6 (lance 1 dé à 6 faces)
!roll d100 (lance 1 dé à 100 faces)
!roll 3d10 (lance 3 dés à 10 faces et affiche la somme)
Jusqu’à 20 dés en une commande (!roll 20d6), chaque dé de 2 à 100 faces.
Résultat affiché à tous dans le salon : pratique pour Donjons & Dragons, Neverwinter Nights, ou simplement se départager au hasard !
Accessible à tous les membres, aucune permission spéciale requise.
🎯 Tirage au sort entre joueurs (!draw)
Le bot permet de tirer au sort un ou plusieurs gagnants parmi les joueurs d’un salon Discord, pour un loot, un giveaway ou toute situation à départager au hasard.
Commande de base : !draw
Tire 1 gagnant aléatoire parmi tous les membres du salon (hors bots).
Tu peux tirer plusieurs gagnants d’un coup :
!draw 3 → 3 gagnants aléatoires dans le salon
Tu peux faire un tirage uniquement entre certains joueurs :
!draw @Pseudo1 @Pseudo2 @Pseudo3 → tire au sort un gagnant parmi ces personnes
!draw 2 @Pseudo1 @Pseudo2 @Pseudo3 → tire au sort 2 gagnants parmi la liste
Limite : 25 participants par tirage.
Les bots ne sont jamais inclus dans le tirage.
Affichage stylé : le bot crée un suspense "3... 2... 1..." avant d’annoncer le résultat dans un embed avec la/les mention(s) du ou des gagnants 🎉
Pratique pour :
Désigner qui reçoit un loot dans un donjon, un event, un jeu de société...
Organiser des giveaways ou des mini-lotteries sur ton serveur Discord.
Départager les joueurs de façon 100% transparente et équitable.
Accessible à tous les membres, aucune permission spéciale requise.
🔐 Qui peut faire quoi ? (Utilisateurs, Admins, Superadmins)
Utilisateur normal
Peut s’inscrire à un roster actif.
Peut participer à un sondage, LFG ou événement.
✅ Est automatiquement enregistré dans la base de données lors de la première interaction.
✅ Peut accéder au dashboard utilisateur pour suivre ses NexusCoins, ses rosters, etc.
Peut utiliser la commande !roll pour lancer des dés (D&D, jeux de rôle, etc.).
Peut transférer des NexusCoins à d'autres utilisateurs présents sur le même serveur Discord grâce à la commande !give.
Administrateur (ajouté via !addadmin)
Peut créer des sondages, LFG et événements.
Peut créer des modèles de roster.
Peut valider des pré-inscrits dans les rosters qu’il gère.
Superadmin (ajouté via !superadmin)
Bénéficie des droits d’admin + accès complet au dashboard admin.
Peut ajouter ou retirer d’autres administrateurs pour un serveur.
Cas particulier : l’utilisateur devient admin
✅ Lorsqu’un membre est promu admin/superadmin, il est automatiquement enregistré en tant qu’utilisateur si ce n’est pas déjà fait.
En résumé : Tout utilisateur qui participe à quelque chose (LFG, sondage, roster...) est enregistré automatiquement dans la base de données, et peut être récompensé !
🔧 Configuration des Permissions du Bot NexusIA
Pour garantir le bon fonctionnement du bot NexusIA sur votre serveur Discord, il est essentiel de lui accorder certaines permissions. Sans ces droits, le bot risque de ne pas pouvoir répondre correctement à vos commandes, gérer les événements ou les sondages.
✅ Permissions Recommandées lors de l’ajout du bot :
📌 Lire les messages
📌 Envoyer des messages
📌 Ajouter des réactions ➔ pour les sondages, LFG et événements
📌 Gérer les messages ➔ pour nettoyer les réactions en double ou supprimer certains messages
📌 Lire l’historique des messages ➔ pour pouvoir modifier les messages envoyés par le bot (ex : LFG / Events)
📌 Intégrer des liens (Embed Links) ➔ pour afficher les messages enrichis (embeds)
📌 Utiliser des emojis externes (facultatif) ➔ si vous souhaitez intégrer des emojis personnalisés dans les réactions
✅ Où donner ces permissions ?
Rendez-vous dans les paramètres de votre serveur ➔ Rôles
Sélectionnez le rôle attribué à NexusIA ou créez-en un dédié pour lui
Vérifiez que ce rôle est positionné assez haut dans la hiérarchie pour s'appliquer correctement
Activez toutes les permissions listées ci-dessus
✅ Permissions par salon (channels) :
Accédez aux Paramètres du canal ➔ Permissions
Ajoutez le bot NexusIA ou son rôle dans la liste des membres avec accès
Donnez-lui au minimum les droits suivants :
Voir les salons
Lire les messages
Envoyer des messages
Ajouter des réactions
Lire l’historique des messages
Gérer les messages
⚠️ Important :
Si le bot ne répond pas dans un salon, pensez à vérifier :
Que le bot a bien le droit d'**envoyer des messages** et **d'ajouter des réactions** dans ce salon
Que les rôles sont bien positionnés dans la hiérarchie
❓ **À noter** :
Si le bot n’a pas la permission d’envoyer des messages dans un salon, **aucun message d’erreur ne s’affichera**.
Pour les utilisateurs, cela donne simplement l’impression que le bot ne fonctionne pas.
Vérifiez toujours les permissions si le bot reste silencieux !
💡 Conseil : Créez un salon dédié aux commandes admin pour les actions comme !lfg et !event.