Comment relier Discord à Telegram, Matrix ou Slack avec matterbridge

matterbridge relie un salon Discord à des salons sur Telegram, Matrix, Slack, IRC, Mattermost et d’autres : ce qui est dit dans l’un apparaît dans les autres. Vous choisissez les salons dans matterbridge.toml sous Files, vous mettez le token du bot Discord sur la page Bot et, pour Telegram, le token du bot Telegram sous Environnement.

La version 1.26.0 est installée ; le projet n’a rien publié depuis 2023, nous le proposons donc tel quel.

1. Dans le Discord Developer Portal, créez le bot, copiez son token, et activez Server Members Intent et Message Content Intent.
2. Dans le panel, faites tourner matterbridge sur le serveur (Changer ce qui tourne), collez le token Discord dans la carte Configurer votre bot et invitez le bot.
3. Pour Telegram, créez un bot avec @BotFather et collez son token sous Bot, Environnement, Identifiants, Telegram bot token.
4. Ouvrez matterbridge.toml dans Files, renseignez l’ID de votre serveur Discord et les salons à relier, et supprimez la ligne qui contient PNH_EXAMPLE_CONFIG.
5. Cliquez sur Démarrer dans la Console.

Chaque étape est expliquée plus bas. Le fichier d’exemple relie un salon Discord à un groupe Telegram, le cas le plus courant.

1. Côté Discord

1. Créez le bot et copiez son token : Comment créer un bot Discord et obtenir son token. Sur la page Bot de l’application, activez Server Members Intent et Message Content Intent et cliquez sur Save Changes.
2. Ouvrez votre serveur dans le panel. Dans l’Aperçu, sur la carte Configurer votre bot, cliquez sur l’étape Ce qui tourne. Si elle n’indique pas « Ce bot fait tourner matterbridge. », cliquez sur Changer ce qui tourne, choisissez matterbridge, cliquez sur Étape suivante, cochez la confirmation et cliquez sur Changer le type de serveur.
3. Étape Connexion à Discord : collez le token dans Collez le token de votre bot, cliquez sur Se connecter, puis sur Oui, continuer.
4. Étape Permissions : les deux intents doivent afficher Activé sous Dans votre portail. Sous Lien d’invitation, cliquez sur Ajouter à un serveur Discord. Le lien inclut Gérer les webhooks, ce qui permet aux messages venus de l’autre côté de s’afficher avec le nom et la photo de chaque expéditeur.

2. Côté Telegram

1. Dans Telegram, parlez à @BotFather : envoyez /newbot, choisissez un nom et copiez le token qu’il vous donne.
2. Toujours avec @BotFather, envoyez /setprivacy, choisissez votre bot puis Disable. Sinon, un bot Telegram ne voit que les commandes dans un groupe, pas les messages ordinaires.
3. Ajoutez le bot à votre groupe Telegram. Pour trouver l’ID de discussion du groupe (un nombre négatif), ajoutez un instant @getidsbot au groupe.
4. Dans le panel, ouvrez la page Bot et cliquez sur Environnement. Sur la carte Identifiants, cliquez sur Définir à côté de Telegram bot token, collez-le et cliquez sur Enregistrer.

3. Remplir matterbridge.toml

1. Ouvrez Files et cliquez sur matterbridge.toml.
2. Dans [discord.mydiscord], remplacez YOUR_DISCORD_SERVER_ID par l’ID de votre serveur : dans Discord, Paramètres, Avancé, activez le Mode développeur, puis faites un clic droit sur l’icône du serveur et choisissez Copier l’identifiant du serveur.
3. Sous [[gateway]], mettez dans le channel Discord le nom de votre salon sans le #, et dans le channel Telegram l’ID de discussion du groupe.
4. Supprimez la première ligne qui contient PNH_EXAMPLE_CONFIG, puis enregistrez.

Les parties remplies ressemblent à ceci :

[discord.mydiscord]
Server="123456789012345678"
RemoteNickFormat="[{PROTOCOL}] <{NICK}> "
AutoWebhooks=true
PreserveThreading=true

[telegram.mytelegram]
RemoteNickFormat="<{NICK}> "
MessageFormat="HTMLNick"

[[gateway]]
name="gateway1"
enable=true

    [[gateway.inout]]
    account="discord.mydiscord"
    channel="general"

    [[gateway.inout]]
    account="telegram.mytelegram"
    channel="-1001234567890"

Gardez les noms de compte discord.mydiscord et telegram.mytelegram : c’est ainsi que les deux tokens enregistrés dans le panel arrivent à matterbridge, sans avoir à les écrire dans le fichier.

4. Le démarrer

Ouvrez la Console et cliquez sur Démarrer. Quand le fichier est prêt, vous voyez la ligne de version, puis :

[PlayNHost] Starting your bot

Écrivez un message dans le salon Discord ; il apparaît dans le groupe Telegram avec le nom de l’expéditeur, et inversement.

Matrix ou Slack à la place de Telegram

Le panel n’a un champ d’identifiants que pour Telegram. Pour les autres réseaux, ajoutez une section de compte à matterbridge.toml avec son identifiant de connexion dans le fichier lui-même, puis ajoutez ce compte à la passerelle. Toute personne qui a accès aux fichiers de votre serveur peut le lire, et les backups l’incluent.

• Matrix : créez un compte Matrix distinct pour le pont, pas le vôtre. Ajoutez [matrix.mymatrix] avec Server="https://matrix.org" (votre homeserver), Login et Password, puis un [[gateway.inout]] avec account="matrix.mymatrix" et channel="#yourroom:matrix.org". Les salons chiffrés ne sont pas pris en charge.
• Slack : matterbridge 1.26.0 se connecte à Slack avec le token d’un utilisateur Slack dédié. Les règles de token de Slack ont changé depuis cette version : suivez donc le wiki de matterbridge pour Slack et testez avant de compter dessus.

Toutes les options de tous les réseaux sont sur le wiki de matterbridge (github.com/42wim/matterbridge/wiki). Redémarrez le bot après chaque modification du fichier.

Lignes de console que vous pouvez voir

[PlayNHost] matterbridge is not set up yet: matterbridge.toml is still the example.

La ligne PNH_EXAMPLE_CONFIG ou YOUR_DISCORD_SERVER_ID est encore dans le fichier. Terminez l’étape 3, puis cliquez sur Redémarrer.

[PlayNHost] Created matterbridge.toml from the example.

Il n’y avait pas de matterbridge.toml, un nouvel exemple a donc été écrit. Remplissez-le comme à l’étape 3.

[PlayNHost] matterbridge is not installed. Reinstall it on the Bot page, Code, then press Start.

Le programme est absent. Cliquez sur Réinstaller sur la carte Réinstaller sous Bot, Code et confirmez. Votre matterbridge.toml reste.

Bon à savoir

• Debug log sous Bot, Code, Paramètres consigne chaque message que matterbridge relaie. Activez-le seulement le temps de chercher un problème : tapez 1, cliquez sur Enregistrer, redémarrez ; 0 le désactive.
• matterbridge ne fait que se connecter vers l’extérieur aux réseaux de discussion. Il n’ouvre aucun port et n’a pas besoin de domaine.
• Vous écrivez plutôt votre propre bot Telegram, Slack ou Matrix ? Comment héberger un bot Telegram, Twitch, Slack ou Matrix.