Bienvenue et au revoir

Dès qu'un membre rejoint le serveur, le bot enchaîne ces étapes, l'une après l'autre :

1. Il publie les journaux d'arrivée et d'invitation, si ces salons de journaux sont configurés (voir Journaux).
2. Il passe le membre aux protections de l'anti-raid et du mode raid. Si l'une d'elles l'expulse, tout s'arrête là.
3. Si le captcha est actif, il attend que le membre recopie le code (jusqu'à 3 minutes). En cas d'échec, le membre est expulsé et tout s'arrête.
4. Il envoie le message de bienvenue dans le salon d'arrivée (et en message privé si tu as écrit un message personnalisé).
5. Il donne les rôles de bienvenue.

Le message est publié dans le salon d'arrivée : Salon d'annonce des arrivées sur le site, Salon des arrivées/départs dans /config. Sans salon, aucun message n'est publié ; les rôles de bienvenue sont quand même donnés, tant que tu n'as pas écrit de message personnalisé (voir Problèmes fréquents). Le texte est écrit dans la langue du serveur.

Tant que tu n'as pas écrit de message personnalisé, le bot utilise son texte par défaut :

• le titre « Nouveau membre ! » ;
• « Bienvenue sur nom du serveur ! », puis une phrase d'accueil avec le nom affiché du membre (son pseudo sur le serveur, sinon son nom Discord) et le nombre total de membres du serveur ;
• l'avatar du membre en vignette, à droite ;
• en dessous, la carte de bienvenue (voir Les cartes de bienvenue et d'au revoir).

Le texte par défaut ne mentionne pas le membre : il ne reçoit donc pas de notification. Pour le mentionner, écris un message personnalisé avec la variable {user}.

Le message personnalisé (Message d'accueil personnalisé sur le site, Message personnalisé dans /config) remplace le titre et le texte par défaut. L'avatar et la carte restent affichés. Il accepte 2000 caractères et la mise en forme Discord (### pour un titre, **gras**, -# pour un petit texte…).

Les variables

Exemple de message :

### Bienvenue {user} sur **{guildName}** ! ☕
Tu es notre **{guildMemberCount}e** membre, installe-toi et présente-toi !

• Une variable inconnue reste telle quelle dans le message. Attention : {memberCount} n'existe que dans le texte par défaut, utilise {guildMemberCount}.
• Pour un emoji, colle directement le caractère (☕) ou la syntaxe Discord d'un emoji de ton serveur (<:nom:id>).
• Sur le site, les étiquettes de variables s'insèrent d'un clic, et Insérer le texte par défaut ajoute un modèle proche du texte du bot (en français).
• Dans /config, le champ est obligatoire : pour revenir au texte par défaut, vide le message depuis le site.

Le message privé

Avec un message personnalisé, le bot envoie aussi le message au nouveau membre en message privé : le même texte, son avatar et la carte, suivis d'un bouton « Envoyé par nom du serveur » qui ouvre le salon d'arrivée. Si le membre a fermé ses messages privés, l'envoi échoue sans bruit. Avec le texte par défaut, aucun message privé n'est envoyé.

Les rôles de bienvenue sont ajoutés au membre juste après le message de bienvenue, tous en une fois. Le journal d'audit de Discord indique la raison « Assignation des rôles de bienvenue ».

Pour qu'un rôle soit donné :

• le bot doit avoir la permission Gérer les rôles ;
• le rôle doit être placé sous le rôle le plus haut du bot et ne pas être géré par une intégration (rôle d'un bot, rôle Booster…) ;
• le rôle doit toujours exister : un rôle supprimé est simplement ignoré.

Dans /config, tu peux choisir jusqu'à 25 rôles, et seuls les rôles valides sont acceptés. Sur le site, la liste propose les rôles non gérés par une intégration, sans limite de nombre.

Les rôles ne sont pas donnés quand le membre a été expulsé par l'anti-raid, le mode raid ou le captcha.

Le captcha fait partie de l'anti-raid (Sécurité Captcha). Il est actif quand l'anti-raid est activé, que la protection captcha est activée et qu'un salon captcha textuel est choisi. Il se règle sur la page Sécurité et anti-raid du site ou dans /config → Antiraid.

Quand il est actif :

1. le bot publie dans le salon captcha une image avec un code de 6 caractères et mentionne le nouveau membre ;
2. le membre doit taper ce code dans le salon avant la fin du compte à rebours (3 minutes) ; ses messages sont supprimés au fur et à mesure ;
3. s'il réussit, le bot envoie le message de bienvenue puis donne les rôles de bienvenue ;
4. s'il échoue ou ne répond pas à temps, il est expulsé du serveur et reçoit un message privé.

Pendant ces 3 minutes, le membre n'a encore aucun rôle de bienvenue : le salon captcha doit donc être visible par @everyone. Le détail des protections est sur la page Anti-raid et sécurité.

Quand un membre quitte le serveur (de lui-même, expulsé ou banni), le bot publie un message d'au revoir dans le salon des départs : Salon d'annonce des départs sur le site. Il peut être le même que le salon d'arrivée ou un autre.

• Sans salon des départs, rien n'est publié. Comme pour l'arrivée, il doit s'agir d'un salon textuel.
• Aucun message privé n'est envoyé : la personne n'est plus sur le serveur.
• Le texte par défaut affiche le titre « Un membre nous quitte », le nom affiché du membre, un remerciement et le nombre de membres restants, avec son avatar et la carte d'au revoir.

Le message d'au revoir personnalisé se règle uniquement sur le site. Il accepte les mêmes variables que la bienvenue ; {guildMemberCount} y donne le nombre de membres restants.

Chaque message est accompagné d'une image de 1200 × 400 pixels générée par le bot, dans la langue du serveur.

Les emojis et les caractères que la police ne connaît pas sont retirés des noms. Si le nom d'utilisateur ne contient plus rien, le titre devient simplement « BIENVENUE ! » ou « AU REVOIR ! ».

Le fond de la carte

Pour la bienvenue, le bot prend le premier fond disponible :

1. le fond personnel du membre pour ses cartes de bienvenue, s'il en a choisi un dans ses préférences du site (option des offres personnelles, voir Le tableau de bord) ;
2. l'image du serveur (Bannière & Image d'accueil sur le site, Image dans /config) ;
3. l'image par défaut de Dispatch.IO.

Pour l'au revoir, c'est l'image d'au revoir du serveur (Bannière & Image d'au revoir, sur le site uniquement), sinon l'image par défaut. Les fonds personnels ne s'appliquent pas à l'au revoir.

Le voile sombre (activé par défaut, réglable sur le site uniquement) assombrit l'image pour garder le texte lisible. Désactive-le si ton image est déjà sombre. L'image de bienvenue sert aussi de fond de secours pour les cartes de niveau et de flamme.

• La langue des messages et des cartes est celle du serveur (Langue et fuseau horaire).
• Le module n'a aucune limite liée aux offres Premium. Seuls les fonds personnels des membres dépendent de leur offre personnelle (voir Offres Premium et limites).
• Une image changée depuis /config peut mettre jusqu'à une heure à apparaître sur les cartes.

Tester avant d'ouvrir les portes

Sur le site, les boutons Tester la bienvenue et Tester l'au revoir font envoyer par le bot le vrai message, comme si tu venais d'arriver ou de partir :

• il faut d'abord enregistrer un salon : le test utilise la configuration enregistrée, pas le formulaire en cours ;
• avec un message personnalisé, tu reçois aussi le message privé ;
• aucun rôle n'est donné pendant un test ;
• un test par serveur toutes les 60 secondes.

L'aperçu de la carte affiché sur le site est généré par le bot lui-même : s'il ne s'affiche pas, vérifie que le bot est en ligne.

Pour aller plus loin : Configuration du bot, Permissions et rôles et Dépannage.