Permissions du bot
Démarrer

Les permissions du bot

Les quinze permissions demandées par SakurakiBot, à quoi chacune sert, et ce qui cesse de fonctionner si vous en retirez une.

15 permissionsAucune permission de modérationAucun accès vocal

Le principe : le strict nécessaire

SakurakiBot ne demande pas la permission Administrateur. Chaque case cochée sur l'écran d'invitation correspond à une fonctionnalité précise : aucune ne sert « au cas où ». Vous pouvez toutes les vérifier, et même en refuser — cette page dit exactement ce que vous perdez à chaque fois.

Ce n'est pas un bot de modération

Il ne peut ni exclure, ni bannir, ni rendre muet, ni modifier les rôles ou les pseudos de vos membres. Il supprime bien des messages et des fils, mais uniquement autour du proxy des personas, et toujours à la demande de leur auteur.

Il reçoit le texte des messages

Autant le dire clairement : Discord transmet à SakurakiBot le texte des messages de vos salons. C'est indispensable pour reconnaître le préfixe d'un persona — et c'est la seule raison. Ce qu'il en fait est détaillé juste en dessous.

Rien dans les salons vocaux

Aucune permission vocale n'est demandée : le bot ne peut ni se connecter, ni parler, ni déplacer qui que ce soit.

Tout est réversible

Une permission se retire — ou se rend — à tout moment depuis les paramètres du serveur, sans retirer le bot ni refaire l'inscription. Voir corriger des permissions après coup.
Ce que devient le texte de vos messages
  • Le texte est comparé aux préfixes de personas de son auteur, et à rien d'autre. S'il n'en a configuré aucun, il n'y a même rien à comparer. Dans tous les cas où le message ne correspond pas, il est écarté aussitôt : aucun texte n'en est conservé.
  • Les classements ne comptent que des nombres — combien de messages, quel jour, à quelle heure. Jamais leur texte.
  • Seuls les messages que vous envoyez volontairement sous un persona sont enregistrés avec leur texte, pour que vous puissiez les modifier ou les supprimer depuis le site. Les supprimer les efface aussi de nos serveurs.
  • Aucune réponse automatique à la volée : la FAQ ne répond que si l'on tape la commande.
Où voir la liste dans DiscordParamètres du serveur → Rôles → SakurakiBot. Le rôle créé lors de l'ajout du bot porte exactement les permissions décrites ci-dessous, et rien d'autre.

Pour publier ses messages

Le socle : sans ces permissions, le bot est présent dans la liste des membres mais ne peut rien afficher.

Voir les salons

La base de tout. Un salon que le bot ne voit pas n'apparaît même pas dans les menus de /config : impossible de l'y désigner comme salon de confessions, d'anniversaires ou de répertoire.

Envoyer des messages

Publier dans un salon : annonces d'anniversaire, confessions, répertoire, résultats de classements.

Intégrer des liens

Presque tous ses messages sont des embeds : confessions, annonces d'anniversaire, fiches du répertoire, annonces de bump, résultats de classements. Sans elle, Discord refuse l'envoi.

Joindre des fichiers

Tout ce qui est image : bannières d'événement, portraits du répertoire, visuels d'anniversaire, images jointes aux messages de persona.

Voir les anciens messages

Pour retrouver et rééditer ses propres messages. Le répertoire permanent est réécrit à chaque ajout de personnage plutôt que republié ; l'en-tête -# En réponse à … d'un persona a besoin de lire le message cité.

Ajouter des réactions

Les deux cœurs posés automatiquement sous chaque confession, qui servent de vote rapide aux membres.

Utiliser les commandes slash

Les commandes slash elles-mêmes. Sans elle, taper /config ne propose plus rien dans votre serveur.

Pour les fonctionnalités RolePlay

Les six permissions qui font tourner les personas, les confessions et les anniversaires.

Gérer les webhooks

C'est le cœur des personas. Un message de persona n'est pas envoyé par le bot mais par un webhook qu'il crée dans le salon : c'est ce qui lui donne le nom et l'avatar de votre personnage au lieu de ceux du bot. Sans cette permission, /persona ne fonctionne pas du tout — la commande répond par une erreur explicite.

Gérer les messages

Elle sert à deux suppressions précises, et à rien d'autre :
  • Quand vous écrivez avec le préfixe d'un persona, le bot republie votre texte via le webhook puis efface votre message d'origine — sinon vous verriez le message en double, une fois sous votre pseudo et une fois sous celui du personnage.
  • Quand vous supprimez un de vos messages de persona, si le webhook d'origine a été recréé entre-temps et ne reconnaît plus le message, le bot le supprime lui-même.

Créer des fils publics

Le fil « Happy Birthday » ouvert sous chaque annonce d'anniversaire, le fil « Réponses » sous les confessions, et le post « Répertoire des Personnages » quand votre salon de répertoire est un forum.

Créer des fils privés

Pour les fils qui ne doivent pas être visibles de tout le serveur. Elle est demandée en même temps que les fils publics pour éviter un second passage par l'écran d'invitation.

Envoyer des messages dans les fils

Complète les deux précédentes. Sans elle, le fil se crée mais reste vide : le bot ne peut plus y publier le message d'ouverture ni les mises à jour.

Gérer les fils

Deux usages, tous deux à votre demande :
  • Supprimer un fil ou un post de forum entier quand vous effacez le message de persona qui l'a ouvert — l'alternative étant de laisser un fil orphelin sans son message d'origine.
  • Modifier les tags d'un post de forum depuis le site, quand vous éditez le message qu'il contient.
Les webhooks ne donnent pas plus de pouvoir « Gérer les webhooks » ne permet ni de lire vos messages, ni de toucher aux salons : elle autorise seulement à créer et utiliser ces émetteurs de messages personnalisés. Vous pouvez les inspecter à tout moment dans Paramètres du salon → Intégrations → Webhooks.
« Gérer les messages » vaut pour tout le salon C'est la permission la plus sensible de la liste : Discord ne permet pas de la limiter aux seuls messages de personas. Si elle vous gêne, refusez-la — vous gardez les personas, mais votre message d'origine restera visible à côté de celui du personnage.

Pour la fiche de votre serveur

Créer une invitation

Le bouton « Rejoindre » de votre fiche pointe vers une invitation qui peut expirer ou être révoquée. Avec cette permission, le bot en régénère une plutôt que de laisser un bouton cassé sur votre annonce. Il choisit un salon où il a déjà le droit de créer des invitations — à défaut, l'opération échoue proprement, sans rien modifier.

La permission la plus large

Gérer les salons

La seule permission de la liste qui dépasse le besoin d'un salon, et la seule qui ne serve jamais dans votre serveur : SakurakiBot ne l'emploie que sur le serveur SakurakiRP lui-même, pour y ouvrir un salon lorsqu'un partenariat doit être signalé. Les tickets de support et de partenariat, eux, sont ouverts par un autre bot, que vous n'ajoutez pas chez vous.

Vous pouvez la refuser

C'est la seule case de l'écran d'invitation que vous pouvez décocher sans perdre la moindre fonctionnalité dans votre serveur.

Refuser une permission : ce que vous perdez

Les cases de l'écran d'invitation Discord se décochent. Rien n'explose, mais le module concerné s'arrête. Voici la correspondance exacte.

  • Voir les salons → le bot ne voit plus le salon : plus aucun message, et le salon disparaît des menus de configuration.
  • Envoyer des messages → le bot est muet dans le salon concerné, quelle que soit la configuration.
  • Intégrer des liens → confessions, anniversaires, répertoire, bumps et classements ne s'affichent plus.
  • Joindre des fichiers → les messages partent sans leurs images : bannières d'événement, portraits de personnages, images de persona.
  • Voir les anciens messages → le répertoire est republié au lieu d'être mis à jour, et l'en-tête de réponse des personas disparaît.
  • Ajouter des réactions → plus de cœurs sous les confessions. Le reste du module fonctionne.
  • Gérer les webhooks/persona est totalement hors service.
  • Gérer les messages → les personas fonctionnent, mais votre message d'origine n'est plus effacé : chaque réplique apparaît en double.
  • Créer des fils publics / privés → plus de fil « Happy Birthday » ni de fil « Réponses », et le répertoire ne peut plus être publié dans un salon de type forum.
  • Envoyer des messages dans les fils → les fils se créent mais restent vides.
  • Gérer les fils → supprimer un fil de persona entier échoue, et les tags des posts de forum ne sont plus modifiables depuis le site.
  • Créer une invitation → le lien « Rejoindre » de votre fiche ne se répare plus tout seul ; il faudra le remplacer à la main depuis le tableau de bord.
  • Gérer les salons → aucun impact sur votre serveur.
  • Utiliser les commandes slash → les commandes du bot n'apparaissent plus à la saisie.
Un module coupé ne prévient pas toujours Quand Discord refuse un envoi, le bot enregistre l'erreur mais ne peut pas vous alerter dans un salon où il n'a justement pas le droit d'écrire — et il n'envoie pas de message privé pour ça. Si un module semble muet, commencez par vérifier ses permissions dans le salon concerné.

Ce que SakurakiBot ne demande pas

Aucun pouvoir sur vos membres

  • Administrateur
  • Gérer le serveur — donc ni ses réglages, ni son AutoMod, ni la liste de ses invitations
  • Gérer les rôles et gérer les pseudos
  • Expulser, bannir, exclure temporairement
  • Voir les journaux d'audit

Aucun pouvoir sur vos contenus

  • Mentionner @everyone
  • Gérer les émojis et autocollants
  • Se connecter et parler en vocal
Et les statistiques, alors ? Les classements messages, vocal et votants ne demandent aucune permission particulière : le bot compte lui-même au fil de l'eau, et le nombre de membres lui est transmis par Discord à la connexion. C'est pourquoi « Gérer le serveur » ne lui est pas demandée.
Un doute sur un bot ? Le réflexe vaut pour tous : un bot qui réclame Administrateur pour publier des embeds en demande trop. Vérifiez toujours la liste avant d'autoriser, et comparez-la aux fonctionnalités annoncées.

Corriger des permissions après coup

Rendre une permission au bot

  1. Paramètres du serveurRôles
  2. Sélectionnez le rôle SakurakiBot
  3. Onglet Permissions, activez ce qui manque
  4. Le changement est pris en compte immédiatement

Repasser par l'écran d'invitation

Relancer le lien d'ajout du bot sur un serveur où il est déjà présent réaffiche l'écran des permissions et permet de tout recocher d'un coup. Le bot n'est pas ajouté deux fois et votre configuration est conservée.
Une exception de salon prime sur le rôle Si une permission est bien présente sur le rôle mais que le module reste muet dans un seul salon, c'est une exception de salon qui la neutralise. Elle se règle dans Modifier le salon → Permissions, pas dans les paramètres du serveur.
Toujours bloqué ? Passez par le serveur support, dont le lien est donné par /infobot : l'équipe peut vous dire quelle permission manque, et dans quel salon.