Créer un bot Discord

Pour transférer des messages depuis Discord, vous pouvez utiliser votre propre compte. Vous n'avez pas besoin d'inviter un bot sur le serveur d'origine. Vous n'avez pas besoin de posséder ce serveur. Vous n'avez pas besoin d'être administrateur. Votre compte doit seulement avoir accès aux salons concernés. Si c'est ce dont vous avez besoin, commencez par Connecter un compte Discord.

Un bot Discord peut envoyer du texte et les médias pris en charge — comme des images, des vidéos et des fichiers — vers votre serveur Discord. Les embeds Discord peuvent également être transférés depuis des sources Discord. Choisissez les types de messages dans Options de Transfert ; la limite d'envoi du serveur de destination s'applique toujours. Si vous le souhaitez, le bot peut aussi lire les messages d'origine à la place de votre compte.

• Votre compte lit les messages et un bot les envoie ? Invitez le bot uniquement sur le serveur qui reçoit les copies.
• Vous voulez aussi que le bot lise les messages ? Invitez-le également sur le serveur source et donnez-lui accès aux salons à surveiller.

Vous n'avez pas besoin d'écrire du code. Vous n'avez pas besoin d'héberger le bot. ForwardMsg le fait fonctionner pour vous.

Créer le bot dans Discord

1. Ouvrez le Portail des développeurs Discord.
2. Sélectionnez New Application.
3. Saisissez un nom facile à reconnaître, par exemple Transferts communautaires.
4. Sélectionnez Create.
5. Ouvrez Bot dans le menu à gauche de l'application.

Dans Discord, les paramètres du bot sont regroupés dans une application. La page Bot permet de gérer son nom, son image et son token de connexion.

Copier le token du bot

Le token d'un bot est son mot de passe. Il est différent du token de votre compte Discord personnel.

1. Sur la page Bot, repérez Token.
2. Sélectionnez Reset Token pour générer un token que vous pourrez copier.
3. Confirmez l'opération dans Discord.
4. Copiez le token et gardez-le secret.

Les deux sections suivantes expliquent où vérifier ou modifier ces paramètres vous-même avant d'inviter le bot.

Autoriser la lecture du texte des messages

Discord appelle ces interrupteurs des intentions. Pour ForwardMsg, activez les deux intentions ci-dessous. C'est la configuration recommandée que le bot envoie des copies, lise des messages ou fasse les deux. Les intentions sont distinctes des autorisations qui lui permettent de voir ou de publier dans un salon.

1. Ouvrez Bot dans le Portail des développeurs.
2. Repérez Privileged Gateway Intents.
3. Activez Server Members Intent et Message Content Intent.
4. Enregistrez les changements si Discord affiche un bouton d'enregistrement.

Choisir les autorisations nécessaires

Il s'agit des autorisations par défaut demandées lorsque vous invitez le bot. Configurez-les ou vérifiez-les avant d'utiliser le lien d'invitation :

1. Ouvrez Installation dans le Portail des développeurs.
2. Sous Installation Contexts, activez Guild Install. Guild est le terme de Discord pour désigner un serveur.
3. Sous Default Install Settings, repérez les paramètres Guild Install.
4. Incluez le scope bot, qui permet d'ajouter le bot à un serveur. Le transfert avec ForwardMsg n'utilise pas les commandes slash ; vous n'avez pas besoin de configurer des commandes.
5. Vérifiez les autorisations ci-dessous. L'invitation standard de ForwardMsg demande cet ensemble complet.
6. Enregistrez si le portail vous le demande.

Autorisations incluses dans l'invitation standard

Conservez les autorisations sélectionnées par défaut pour que le bot soit prêt à utiliser les fonctionnalités de transfert que vous choisissez. Certaines autorisations ci-dessous ne servent qu'aux fonctionnalités facultatives ; vous pouvez les laisser activées même si vous n'activez pas ces fonctionnalités.

Autorisations facultatives selon le comportement

Ces autorisations sont également incluses dans l'invitation standard. Elles ne sont nécessaires que si vous utilisez la fonctionnalité correspondante :

Vous n'avez pas besoin d'accorder Administrator au bot. Après son installation, vérifiez ses autorisations réelles sur le serveur et dans les salons. La référence des autorisations Discord explique ces réglages.

Si le bot est déjà sur le serveur, modifier les valeurs par défaut dans le portail ne change pas ses accès sur ce serveur. Dans Discord, ouvrez Server Settings → Roles, sélectionnez le rôle du bot et vérifiez Permissions. Pour un seul salon, ouvrez Edit Channel → Permissions et vérifiez le rôle du bot ou son entrée individuelle. Les règles d'une catégorie ou d'un salon peuvent bloquer l'accès même si le rôle du serveur l'autorise.

Installer le bot sur un serveur

Pour envoyer des copies, ajoutez le bot au serveur où vous voulez les recevoir. Si votre compte lit les messages d'origine, le bot n'a pas besoin de rejoindre le serveur source. Ajoutez-le à ce serveur uniquement si vous voulez qu'il lise lui-même ces salons.

Pendant l'étape Ajouter un bot Discord dans ForwardMsg, utilisez Ajouter au serveur de destination pour ouvrir l'invitation. Choisissez le serveur de réception — ou le serveur source si vous configurez le bot pour lire les messages. Autorisez-le dans Discord, revenez dans ForwardMsg et sélectionnez Terminé. S'il est déjà sur le bon serveur, vous pouvez sélectionner Terminé sans l'inviter de nouveau.

Vous pouvez aussi l'inviter depuis le Portail des développeurs :

1. Ouvrez Installation dans le Portail des développeurs.
2. Sous Install Link, choisissez Discord Provided Link.
3. Copiez le lien et ouvrez-le dans votre navigateur après vous être connecté à Discord.
4. Choisissez Add to server et sélectionnez le serveur voulu.
5. Sélectionnez Authorize et terminez la confirmation de Discord.
6. Vérifiez que le bot apparaît dans la liste des membres du serveur.

Vous pouvez l'inviter si vous possédez le serveur, en êtes administrateur ou disposez de l'autorisation Manage Server. Sinon, demandez à l'administrateur du serveur de l'inviter. Vous n'avez pas besoin de cette autorisation sur le serveur source si votre compte transfère les messages.

Le guide d'installation de Discord présente les commandes du portail si sa disposition change.

Le connecter pour lire des messages

1. Ouvrez une automatisation configurée pour lire les messages avec Bot Discord, puis sélectionnez Ajouter Bot Discord dans Source.
2. Collez le token du bot et sélectionnez Ajouter.
3. Conservez ou modifiez son nom dans ForwardMsg, puis sélectionnez Continuer.
4. Utilisez Ajouter au serveur de destination pour l'inviter sur le serveur dont il lira les messages s'il ne l'a pas déjà rejoint. Autorisez-le dans Discord.
5. Revenez dans ForwardMsg et sélectionnez Terminé.
6. Vérifiez que le bot est sélectionné dans Source.
7. Sélectionnez Mettre à jour les paramètres.
8. Sélectionnez Démarrer et attendez que le statut passe à En cours.
9. Ajoutez les serveurs et les salons qu'il doit lire.

Source désigne l'endroit d'où proviennent les messages d'origine. Choisissez uniquement les salons à surveiller.

Le connecter pour envoyer des messages

Si le bot est déjà enregistré, sélectionnez-le sans recoller son token, puis passez au choix du salon de réception.

1. Cliquez sur la discussion ou le salon source dans la liste de gauche de l'éditeur pour ouvrir ses paramètres.
2. Ouvrez Routage.
3. Sélectionnez Ajouter une destination.
4. Choisissez Ajouter Bot Discord s'il n'est pas encore enregistré.
5. Collez son token et sélectionnez Ajouter.
6. Conservez ou modifiez son nom dans ForwardMsg, puis sélectionnez Continuer.
7. Utilisez Ajouter au serveur de destination pour l'inviter sur le serveur de réception si nécessaire. Autorisez-le dans Discord.
8. Revenez dans ForwardMsg et sélectionnez Terminé.
9. Choisissez ce bot et le salon qui recevra les copies.
10. Terminez la boîte de dialogue de destination.
11. Sélectionnez Enregistrer les modifications.

Destination désigne l'endroit où arrivent les copies. Un bot peut envoyer des messages dans plusieurs salons s'il y a accès.

Réutilisez le même bot pour vos différentes routes de transfert. Sélectionnez le bot enregistré dans les destinations Routage ou les autres automatisations ; vous n'avez pas besoin d'en créer un nouveau pour chaque discussion ou route. Invitez-le sur chaque serveur de réception et donnez-lui accès aux salons concernés.

Envoyez un nouveau message texte avec votre automatisation pour vérifier le résultat. Si un salon ne fonctionne pas, vérifiez les autorisations du bot dans ce salon précis.

Vérifier la configuration automatique de ForwardMsg

Après l'enregistrement du token avec Ajouter un bot Discord, ForwardMsg configure les intentions prises en charge, Guild Install et les paramètres d'installation par défaut, afin que le bot puisse lire et envoyer des messages.

1. Revenez dans le Portail des développeurs et actualisez la page.
2. Ouvrez Bot → Privileged Gateway Intents pour vérifier Message Content et Server Members.
3. Ouvrez Installation pour vérifier Guild Install et ses autorisations par défaut.
4. Invitez le bot si ce n'est pas déjà fait, puis sélectionnez le salon de réception dans ForwardMsg.

Vous pouvez utiliser ce raccourci sans modifier manuellement chaque champ du portail. Si un réglage ne s'est pas actualisé, suivez les étapes manuelles ci-dessus.

Le bot se connecte, mais ne peut pas envoyer de messages

La connexion signifie que ForwardMsg peut s'authentifier avec le compte du bot. Cela ne signifie pas que tous les salons de réception l'autorisent à publier.

• Vérifiez le serveur et le salon. Le bot doit être sur le serveur de réception et avoir les autorisations View Channel et Send Messages dans le salon concerné. Les fils nécessitent également Send Messages in Threads.
• Vérifiez les bots de vérification ou de filtrage. Certains serveurs masquent des salons jusqu'à ce qu'un membre reçoive un rôle tel que Verified ou Member. Un bot fraîchement invité ne reçoit pas forcément ce rôle automatiquement. Demandez à l'administrateur d'attribuer le rôle approprié à votre bot ou de l'autoriser explicitement dans le salon de réception. Par exemple, si seuls les membres Verified peuvent publier dans #news, votre bot doit également avoir cet accès.
• Vérifiez le type de contenu. Autorisez Attach Files pour les fichiers importés et Embed Links pour les embeds. Lorsque Activer les webhooks est utilisé, autorisez également Manage Webhooks.
• Vérifiez le token. Si vous l'avez réinitialisé ou révoqué, ajoutez de nouveau le bot avec le nouveau token et remplacez l'ancienne connexion enregistrée partout où elle est utilisée.

Après avoir corrigé l'accès, sélectionnez Enregistrer les modifications dans Routage, redémarrez l'automatisation si nécessaire, puis envoyez un nouveau message depuis une discussion source pour vérifier qu'il arrive à destination. Vous pouvez utiliser des discussions de test privées.

Consultez Envoi et autorisations pour d'autres vérifications.

Noms d'auteur, réponses et épingles

Un message normal de bot utilise le nom et l'image de profil du bot. Par exemple, un message copié depuis Maya apparaît comme une publication de Transferts communautaires, le nom de votre bot. Format du message peut tout de même inclure le nom de Maya dans le texte.

Si vous voulez que la publication Discord affiche le nom et l'avatar de Maya, utilisez un Webhook pour l'envoi. Chaque copie peut utiliser l'identité de son auteur d'origine au lieu du même profil de bot pour toutes les publications.

Vous pouvez configurer automatiquement votre bot connecté pour cela :

1. Accordez-lui l'autorisation Manage Webhooks dans le salon de réception.
2. Dans ForwardMsg, cliquez sur la discussion source dans la liste de gauche pour ouvrir ses paramètres, ou cliquez sur Paramètres globaux pour appliquer l'option aux endroits qui en héritent.
3. Ouvrez Avancé → Envoyer avec le nom et l'avatar de l'auteur.
4. Activez Activer les webhooks.
5. Sélectionnez Enregistrer les modifications, puis envoyez un nouveau message avec votre automatisation pour voir son nom et son image dans Discord.

Le bot crée et gère désormais les Webhooks utilisés pour l'envoi. Vous n'avez pas besoin de créer manuellement un Webhook distinct pour chaque salon de réception lorsque cette option est activée.

Laissez Activer les webhooks désactivé lorsque vous avez besoin des réponses ou des épingles. Consultez Synchroniser les actions et Options avancées.

Garder le token secret