Intégrations

Discord

La connexion, le bot d'annonces, les quêtes qui lisent votre serveur, et les rôles distribués comme récompenses.

Cinq fonctionnalités distinctes portent le nom Discord, et en activer une n'active pas les autres.

Ce que vous voulezCe que c'est réellementOù cela se configure
Les fans se connectent avec leur compte DiscordUn fournisseur de connexionPar communauté, par nos soins
Les fans rattachent Discord à un compte qu'ils ont déjàLa liaison de comptePar communauté, par nos soins
Votre serveur reçoit un message quand vous publiez quelque choseLe bot FanBaseSettings, puis Automation
Une quête qui vérifie qu'un fan a rejoint le serveur ou détient un rôleDeux modèles de quêteQuêtes Discord
Un rôle Discord attribué pour avoir terminé quelque choseUn type de récompenseRécompenses

Connexion et liaison de compte

Ce sont deux choses différentes, configurées indépendamment.

La connexion, c'est Discord comme porte d'entrée de votre application. Un fan appuie sur Continuer avec Discord et il est connecté, sans mot de passe distinct. Elle côtoie Google, X, Twitch et Shopify, et vous choisissez lesquels apparaissent.

La liaison de compte, c'est un fan déjà connecté qui rattache son compte Discord après coup, depuis son profil. Elle est activée par défaut, car un fan qui s'est connecté avec Google a quand même besoin d'un compte Discord lié avant qu'une quête Discord puisse être vérifiée.

C'est la liaison qui compte pour les quêtes. Un fan qui s'est connecté avec Discord est lié automatiquement, mais un fan qui s'est connecté autrement ne l'est pas, et ses quêtes Discord restent bloquées tant qu'il n'a pas lié son compte. La carte gère cela elle-même. Voir Modèles qui nécessitent un compte lié.

Indiquez à votre contact FanBase quelles méthodes de connexion vous voulez et si la liaison Discord doit être disponible : c'est un changement de configuration, pas un développement. Méthodes de connexion donne la liste complète.

Les noms d'utilisateur dans l'application ressemblent à name#1234. C'est un identifiant FanBase qui reprend la forme de ceux de Discord, sans aucun rapport avec le compte Discord du fan.

Annonces dans votre serveur

Le bot publie dans un salon de votre serveur quand quelque chose se passe dans l'application. L'annonce part, que quelqu'un dans votre équipe pense ou non à en écrire une.

DéclencheurCe que voit le serveur
Une quête est publiéeUn message avec la quête et un lien pour y accéder
Un événement commenceUn message à l'ouverture de l'événement
Un événement se termineUn message à sa clôture

Chaque type de notification a son propre interrupteur, vous pouvez donc annoncer les quêtes et rester silencieux sur tout le reste. D'autres types arrivent : les publications du fil d'actualité, les changements de la boutique et les gagnants d'événements sont ceux sur lesquels nous travaillons. En développement

Mise en place

Faites entrer le bot dans votre serveur

Allez dans Settings, puis Automation. Appuyez sur Connect sur la carte Discord. Discord vous demande de choisir le serveur et d'approuver le bot, puis vous renvoie au panneau d'administration.

La personne qui clique doit avoir la permission Manage Server (Gérer le serveur) sur ce serveur Discord, alors assurez-vous de sa présence avant de commencer. Si la carte propose déjà Disconnect, le bot est en place et vous pouvez passer cette étape.

Choisissez le salon

Indiquez l'identifiant du salon où vous voulez recevoir les messages. Un salon dédié vaut la peine d'être créé : dans un salon général animé, les annonces disparaissent en quelques minutes.

Choisissez un rôle à mentionner, ou aucun

Facultatif. Choisissez un rôle et chaque message le mentionne. Laissez le champ vide et le message ne notifie personne.

Mentionner tout le monde à chaque quête, c'est ainsi qu'un serveur apprend à mettre votre salon d'annonces en sourdine. Si vous voulez une mention, créez un rôle sur inscription pour les fans qui l'ont demandé.

Activez les notifications que vous voulez

Activez-les une par une et laissez les autres désactivées. Vous pourrez revenir en ajouter une fois que vous connaîtrez le volume.

Obtenir les identifiants

Les deux identifiants se trouvent derrière le Mode développeur de Discord, que Trouver les identifiants explique comment activer.

Identifiant nécessaireComment l'obtenir
Identifiant du salonClic droit sur le salon dans la liste des salons, puis Copy Channel ID (Copier l'identifiant du salon)
Identifiant du rôleClic droit sur le rôle dans Server Settings (Paramètres du serveur), puis Roles, et Copy Role ID (Copier l'identifiant du rôle)

Vérifiez que le rôle du bot peut voir le salon et y envoyer des messages. Un salon où le bot ne peut pas publier ressemble exactement à un bot qui ne fonctionne pas, et c'est la première piste à écarter.

Discord comme source de quêtes

Deux modèles lisent votre serveur au lieu d'y écrire.

Join the server (rejoindre le serveur) demande à un fan d'être membre d'un serveur que vous désignez, et le vérifie. Hold a role (détenir un rôle) demande un rôle précis et le vérifie aussi : c'est ainsi que vous récompensez les personnes qui ont déjà gagné quelque chose dans Discord.

Les deux nécessitent que le compte Discord du fan soit lié, et les deux nécessitent l'identifiant du serveur. Tous les champs sont dans Quêtes Discord.

Un rôle Discord peut aussi servir de condition d'accès plutôt que de quête : vous pouvez masquer une quête, ou la bloquer, jusqu'à ce qu'un fan détienne un rôle. C'est expliqué dans Quêtes masquées et conditions d'accès.

Un rôle Discord comme récompense

L'autre sens. Un fan termine une quête et le bot lui attribue un rôle dans votre serveur, sans intervention humaine.

C'est ce qui rend possible le schéma que la plupart des partenaires veulent : le niveau dix dans l'application donne droit à une couleur dans Discord. Il faut que le bot soit connecté, et le rôle du bot doit se trouver au-dessus du rôle qu'il attribue dans la liste des rôles de votre serveur. Discord ne laisse pas un bot accorder un rôle classé plus haut que le sien. Vérifiez cet ordre en premier si un rôle n'est pas attribué.

Les types de récompense que vous pouvez associer à une quête sont dans Récompenses.

Sur cette page