Accueil
» Comment faire
»
Connectez Matrix à WhatsApp, Telegram et Discord via des ponts séparés.
Connectez Matrix à WhatsApp, Telegram et Discord via des ponts séparés.
Pour connecter WhatsApp, Telegram et Discord, exécutez trois passerelles distinctes, enregistrez chacune d'elles comme service applicatif et connectez-vous via son propre flux. La connexion doit être réussie si chaque bot signale une session authentifiée et si les messages de test circulent dans les deux sens via les salons dédiés ; la simple présence d'un bot en ligne ne suffit pas.
Ce message s'adresse à l'administrateur d'un serveur domestique autorisant les services applicatifs. Vous ne pouvez pas ajouter de pont auto-hébergé à matrix.org, sauf si ses administrateurs en proposent un ; utilisez un serveur que vous contrôlez ou un pont hébergé disponible. La documentation du projet a été vérifiée le 10 octobre 2026.
1. Déterminez ce que vous allez connecter et préparez le serveur.
Il s'agit de trois services distincts, chacun avec sa propre configuration, inscription, base de données et connexion. Mautrix utilise principalement le système de relais : les messages transitent par votre compte distant lié et apparaissent dans Matrix sous l'identité de ce compte. Un bot relais fonctionne différemment ; choisissez-le uniquement si vous souhaitez une identité partagée pour un bot plutôt que votre compte personnel.
Vous avez besoin d'un serveur d'hébergement compatible avec les services applicatifs, d'un accès administrateur et d'une connexion réseau pour chaque pont. La documentation Docker est disponible. Attribuez à chaque pont son propre répertoire de données et choisissez une étiquette de version maintenue ; Mautrix précise qu'elle latestpeut suivre le dernier commit plutôt qu'une version.
Utilisez une base de données distincte par passerelle ; un serveur PostgreSQL peut être partagé, mais la base de données elle-même ne doit pas être partagée avec une autre passerelle ni avec Synapse. SQLite est une option pour les petites instances. Décidez du chiffrement de bout en bout avant la connexion, car son activation ultérieure pour les salles portail existantes est complexe.
Avant de démarrer les conteneurs, conservez la configuration et la base de données de chaque pont dans son propre répertoire de travail.
2. Configurez et enregistrez les trois services d'application
Générez la configuration initiale de chaque pont. Suivez les instructions de la page d'installation Docker pour ce pont et exécutez son conteneur une première fois avec son propre répertoire de données monté. Modifiez la configuration générée avant de la démarrer normalement. Renseignez le domaine et l'adresse du serveur d'accueil, l'adresse du pont, l'URI de la base de données et les permissions. Ces valeurs sont spécifiques à votre déploiement ; n'utilisez pas d'exemples de secrets en production.
Utilisez des adresses accessibles depuis les conteneurs. Lorsque Synapse et les ponts partagent un réseau Docker, l'adresse du serveur principal du pont peut utiliser le nom de service de Synapse, par exemple ` http://synapse:8008<nom_du_service>`. L'adresse du service applicatif doit pointer vers le nom de service et le port d'écoute de ce pont. localhostSi l'adresse `<adresse_du_service>` à l'intérieur d'un conteneur de pont pointe vers ce même conteneur, et non vers Synapse ou un autre pont, la communication est généralement interrompue. Si le serveur principal est situé en dehors de Docker, publiez ou acheminez le port du pont requis.
Générez et installez un fichier d'enregistrement par pont. Exécutez la commande d'installation de chaque pont pour générer son fichier YAML d'enregistrement, puis placez les trois fichiers à un emplacement accessible à Synapse. Dans le fichier `/etc/synapse.yml` homeserver.yaml, ajoutez leurs chemins d'accès sous `/etc app_service_config_files/synapse.yml`, par exemple :
Si Synapse est exécuté dans un conteneur Docker, montez les fichiers d'enregistrement à l'intérieur de celui-ci. Redémarrez Synapse après avoir modifié la liste. Une faute de frappe dans le fichier YAML, un chemin incorrect, un point de montage illisible ou une adresse de pont incorrecte peuvent empêcher l'enregistrement ou le démarrage de Synapse. Si vous modifiez ultérieurement les paramètres de pont liés à l'enregistrement, régénérez le fichier d'enregistrement correspondant et redémarrez Synapse.
Synapse nécessite un chemin d'enregistrement lisible distinct pour chaque pont, suivi d'un redémarrage du serveur d'accueil.Vérifiez que Synapse et les trois conteneurs de pont sont exécutés sur un réseau où leurs noms de service sont résolus.
3. Ajoutez les identifiants spécifiques au service et connectez-vous.
WhatsApp
Lancez mautrix-whatsapp et ouvrez une conversation Matrix Direct avec son bot de passerelle @whatsappbot:your.server. Envoyez un message login qr, puis scannez le code QR depuis l'écran « Appareils connectés » de WhatsApp sur votre téléphone. Attendez que le bot confirme l'authentification ; la documentation de la passerelle indique que l'affichage des salons peut prendre environ une minute. WhatsApp est connecté en tant qu'appareil, il ne s'agit donc pas d'un compte cloud indépendant. La documentation de la passerelle précise que les appareils connectés se déconnectent si le téléphone reste hors ligne pendant plus de deux semaines. Si vous ne pouvez pas maintenir votre téléphone actif, évaluez si cette passerelle répond à vos exigences de fiabilité avant de l'utiliser pour des conversations importantes.
Telegram
Avant de vous connecter à Telegram, créez une application API sur my.telegram.org/apps et renseignez ses api_idparamètres api_hashdans la configuration de mautrix-telegram. Ces valeurs API permettent au pont de se connecter à l'API de Telegram ; elles n'authentifient pas un compte Telegram à elles seules. Envoyez ensuite un message @telegrambot:your.serveret utilisez login qrle code, en le scannant depuis l'application mobile Telegram, dans Paramètres > Appareils > Lier un appareil de bureau. Le code peut être envoyé dans une session Telegram existante plutôt que par SMS, et le pont peut vous demander votre mot de passe pour la vérification en deux étapes. Vérifiez les paramètres de remplissage du pont avant de vous connecter si l'importation des anciens messages est importante ; modifier les attentes après la création des salons du portail pourrait être trop tard.
Discord
Pour un serveur, utilisez un bot Discord dédié et non l'automatisation de votre compte personnel : Discord interdit les bots personnels et peut supprimer les comptes. Créez une application et un bot sur le portail développeur, activez uniquement les intents privilégiés requis par le pont et accessibles à votre application, puis invitez-le avec le périmètre OAuth2 du bot et les autorisations minimales du canal. L'accès aux intents est contrôlé par des règles ; sans accès au contenu des messages ou aux membres, certaines fonctionnalités peuvent être indisponibles. Dans Matrix, envoyez un message privé @discordbot:your.serveret suivez les instructions de connexion du jeton du bot de mautrix-discord. Un bot ne donne pas accès aux messages privés personnels comme un compte utilisateur.
Vérifiez le nom d'hôte du service, l'écouteur de pont et les détails uniques de la base de données dans la configuration propre à chaque pont.
4. Effectuez un test de livraison, puis ajustez uniquement ce que le résultat indique.
Envoyez un message privé à chaque bot de passerelle pour confirmer son authentification. Dans un salon portail par service, envoyez un message de test depuis Matrix et répondez depuis l'application distante. Vérifiez que les deux messages arrivent bien dans le bon salon. Pour les groupes ou les canaux Discord, assurez-vous d'abord que le compte de passerelle est présent et dispose des autorisations de lecture et de publication. Une connexion réussie ne garantit pas à elle seule la réception du message.
Si un bot est inactif, consultez ses journaux pour détecter d'éventuelles valeurs manquantes, erreurs de base de données ou problèmes de connexion au serveur principal. Si la connexion fonctionne mais que les salons n'apparaissent pas, vérifiez les paramètres du portail et du remplissage. En cas d'absence de messages sur les canaux Discord, vérifiez l'appartenance du bot, ses permissions et l'accès aux intents. Si Synapse ne démarre pas, vérifiez l'indentation du fichier YAML et la lisibilité des points de montage des fichiers d'enregistrement.
La prise en charge des fonctionnalités varie selon la version du pont et le type de compte ; les appels, les réactions, les conversations chiffrées, les médias et l’importation de l’historique peuvent différer ou ne pas être pris en charge. Consultez la liste des fonctionnalités actuelles de chaque pont avant de l’utiliser comme unique point d’accès. Limitez l’accès aux fichiers d’enregistrement et aux identifiants, sauvegardez les données du pont en toute sécurité et révoquez une session ou un jeton lié s’il est compromis.