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.

Liste des répertoires du terminal avec des dossiers séparés mautrix-whatsapp, mautrix-telegram et mautrix-discord, chacun affichant son propre fichier de configuration et de base de données.
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

  1. 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.
  2. 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.
  3. 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 :
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

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.

Éditeur de code affichant le fichier homeserver.yaml de Synapse avec trois chemins d'enregistrement de service d'application distincts pour WhatsApp, Telegram et Discord.
Synapse nécessite un chemin d'enregistrement lisible distinct pour chaque pont, suivi d'un redémarrage du serveur d'accueil.
Le panneau d'état des conteneurs affiche Synapse et trois conteneurs de pont mautrix en cours d'exécution sur un réseau Matrix partagé.
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.

Un éditeur de configuration de pont affichant une adresse de service Synapse, une adresse de service mautrix-whatsapp et un nom de base de données de pont distinct.
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.

Pour les commandes spécifiques à votre version, veuillez utiliser les instructions Docker de Mautrix , le guide d'enregistrement , la référence de configuration et les pages d'authentification WhatsApp , Telegram et Discord . Consultez également la politique de Discord concernant les bots .

Laisser un commentaire

Nettoyez vos anciens messages et fichiers multimédias Synapse sans perdre de données.

Utilisez les API d'historique et de purge multimédia de Synapse ou les paramètres de rétention pour supprimer les données obsolètes en toute sécurité, puis vérifiez l'achèvement de l'opération et la récupération de l'espace disque.

Créez un robot Matrix Echo en Python avec Simple-Matrix-Bot-Lib

Créez un robot Matrix Echo en Python avec Simple-Matrix-Bot-Lib

Installez la bibliothèque actuelle, connectez un compte Matrix dédié et exécutez un petit bot !echo avec une gestion des identifiants plus sûre et un test clair.

Connectez Matrix à WhatsApp, Telegram et Discord via des ponts séparés.

Connectez Matrix à WhatsApp, Telegram et Discord via des ponts séparés.

Configurez trois ponts Mautrix avec des enregistrements, des connexions et des tests distincts, et évitez ainsi les surprises liées au réseau Docker, aux politiques de compte et à la synchronisation.

Récupérez de l'espace disque sur Synapse Media sans endommager les fichiers partagés

Découvrez ce qui occupe l'espace de stockage de Synapse, définissez une durée de conservation des médias sécurisée et purgez le cache distant sans supprimer directement les fichiers du disque.

Désactiver les utilisateurs inactifs de Matrix sans supprimer l'historique des salles

Désactiver les utilisateurs inactifs de Matrix sans supprimer l'historique des salles

Consultez l'activité des appareils, désactivez les comptes Synapse inactifs confirmés via l'API d'administration et découvrez ce que supprime réellement l'option d'effacement.

Réduire la pression sur la mémoire de PostgreSQL dans Matrix Synapse

Déterminez si la mémoire utilisée par PostgreSQL provient des requêtes, des tampons partagés, des connexions ou de la maintenance, puis apportez des modifications ciblées compatibles avec Synapse.

Pourquoi les jonctions de salles Matrix Synapse sont-elles lentes ? Que vérifier ?

Pourquoi les jonctions de salles Matrix Synapse sont-elles lentes ? Que vérifier ?

Avant de modifier les paramètres Synapse, vérifiez si la lenteur des connexions à une salle Matrix se fait à un serveur distant, si le délai de fédération est dépassé, si la charge de la base de données locale est excessive ou si la file d'attente de l'expéditeur est trop longue.

Fermer les inscriptions à Matrix ou exiger des jetons d'invitation sur Synapse

Empêchez la création de comptes ouverts sur un serveur Synapse auto-hébergé, ou limitez les inscriptions aux invitations uniquement avec des jetons d'inscription à usage limité.

Avertissement relatif à l'identité de session : vérifiez votre connexion en toute sécurité.

L'avertissement de session non vérifiée de Clear Element utilise un appareil de confiance ou une clé de récupération, avec des contrôles qui protègent votre historique de conversation chiffré.

Évitez les délais d'expiration de verrouillage de fichiers ownCloud grâce au bon backend

Distinguez les conflits de verrouillage de base de données des verrous WebDAV expirés, puis choisissez et configurez le correctif ownCloud 10 approprié.