So konfigurieren Sie Bridges in Matrix: WhatsApp, Telegram und Discord

Um Matrix mit WhatsApp, Telegram oder Discord zu verbinden, betreiben Sie einen kompatiblen Bridge-Dienst neben Ihrem Heimserver, registrieren Sie diesen Dienst als Matrix-Anwendung und verknüpfen oder autorisieren Sie anschließend das externe Konto. Jedes Netzwerk benötigt eine eigene Bridge-Konfiguration und eigene Zugangsdaten. Ein laufender Prozess allein beweist nicht, dass ein Raum verbunden ist: Testen Sie nach der Einrichtung den Versand einer Nachricht in beide Richtungen.

Diese Anleitung verwendet mautrix-whatsapp und mautrix-telegram sowie das Matrix.org-Projekt matrix-appservice-discord für Discord. Eine Bridge ist ein separates serverseitiges Programm und kein Switch in Element. Die Matrix-Spezifikation bezeichnet diese Art der Integration als Anwendungsdienst: Er empfängt relevante Homeserver-Ereignisse und kann Benutzer oder Räume innerhalb des für ihn registrierten Namensraums erstellen. Siehe die technische Übersicht zu Matrix und die Spezifikation der Application Service API .

Sollten Sie die Bridges selbst hosten oder eine öffentliche Instanz verwenden?

Selbsthosting gibt Ihnen die Kontrolle darüber, wo die Bridge läuft, wie Protokolle und Zugangsdaten gespeichert werden und welche Benutzer sich verbinden dürfen. Sie müssen außerdem drei Dienste verwalten, aktualisieren, deren Datenbanken schützen und Verbindungsprobleme beheben. Eine öffentliche Bridge lässt sich zwar schneller testen, aber der Betreiber kontrolliert Verfügbarkeit, Zugriffsrichtlinien und Datenverarbeitung. Prüfen Sie die aktuelle Dokumentation und den Supportbereich der Bridge, bevor Sie sich für eine Instanz entscheiden; Verfügbarkeit und Funktionen können sich ändern.

Diese Verbindungen ersetzen nicht die native Unterstützung der Messaging-Dienste. Die bereitgestellten Funktionen können je nach Netzwerk variieren, und Sprach-/Videoanrufe, Reaktionen, Bearbeitungen, Threads, Lesebestätigungen, Verlauf oder Gruppenverwaltung sind möglicherweise nicht vollständig verfügbar. Testen Sie die Funktionen, die Ihre Community tatsächlich benötigt, bevor Sie wichtige Unterhaltungen übertragen.

Was benötigen Sie vor der Installation?

• Ein Matrix-Homeserver, der Anwendungsdienste und Administratorzugriff zur Registrierung dieser Dienste unterstützt. Die folgenden Beispiele verwenden Synapse; andere Homeserver haben ihren eigenen Registrierungsprozess.
• Ein erreichbarer Netzwerkpfad zwischen dem Homeserver und jeder Bridge. In Docker localhostbedeutet „innerhalb eines Containers“ den Container selbst; verwenden Sie ein gemeinsames Docker-Netzwerk und den Netzwerknamen des Bridge-Dienstes, wenn der Homeserver einen anderen Container erreichen muss.
• Für jede Bridge werden eine separate Konfiguration, eine Registrierungsdatei, ein Speicherort für persistente Daten und ein geheimer Speicher benötigt. Beachten Sie die aktuellen Projektanweisungen bezüglich unterstützter Datenbanken, Laufzeitversionen und Container-Images; die Anforderungen können variieren und sich ändern.
• Für WhatsApp benötigen Sie ein Telefon, auf dem das Konto installiert ist, das Sie verknüpfen möchten. Für Telegram benötigen Sie ein Konto, das bereits über einen offiziellen Telegram-Client angemeldet ist. Für Discord benötigen Sie eine Discord-Anwendung bzw. einen Discord-Bot sowie die Erlaubnis des Serverinhabers oder -administrators.

Wie registriert man eine Bridge bei Synapse?

1. Stellen Sie jeweils nur eine Bridge bereit. Beginnen Sie mit einer aktuellen Version und deren Beispielkonfiguration. Konfigurieren Sie die Homeserver-Adresse, den öffentlichen Servernamen, die Bridge-Listener-Adresse, die Datenbank und die Speicherpfade gemäß der Projektanleitung. Vermeiden Sie die gemeinsame Nutzung einer Datenbank durch nicht verwandte Bridge-Dienste.
2. Generieren Sie die Registrierungsdatei. Der Einrichtungsprozess der Bridge erstellt eine YAML-Registrierungsdatei, die die Identität des Anwendungsdienstes und Authentifizierungstoken enthält. Behandeln Sie diese Token wie Passwörter: Beschränken Sie die Dateiberechtigungen, speichern Sie sie nicht in Git und fügen Sie sie nicht in öffentliche Räume, Screenshots oder Support-Beiträge ein.
3. Stellen Sie sicher, dass die Datei für Synapse sichtbar ist. Kopieren oder mounten Sie die Registrierungsdatei an einem Ort, wo der Synapse-Prozess sie lesen kann. Fügen Sie ihren Pfad app_service_config_filesin der Synapse-Konfigurationsdatei hinzu homeserver.yaml. Erstellen Sie für jede Bridge einen separaten Eintrag; überschreiben Sie keine Einträge anderer Dienste. Die Anleitung zur App-Service-Registrierung von Mautrix beschreibt diesen Ablauf und weist darauf hin, dass Synapse nach Änderungen an der Registrierungsliste neu gestartet werden muss.
4. Starten Sie Synapse neu und prüfen Sie die Protokolle. Starten Sie Synapse nach einer Registrierungsänderung neu und starten Sie anschließend die Bridge. Falls Synapse nicht startet, prüfen Sie zuerst die YAML-Einrückung, den Dateipfad im Container und die Leseberechtigungen. Falls die Bridge startet, aber keine Verbindung herstellen kann, prüfen Sie die Homeserver-URL, die Netzwerkroute, das TLS-Zertifikat und die Listener-Adresse.

Bei Docker-Bereitstellungen muss die konfigurierte Anwendungsadresse der Bridge vom Homeserver-Container aus erreichbar sein. Die Hinweise zur Erstkonfiguration von Mauttrix erläutern, warum ein Containername in einem gemeinsam genutzten Netzwerk funktionieren kann, wo er sonst localhostnicht funktioniert. Das Discord-Projekt dokumentiert seinen Registrierungsablauf und eine Beispielkonfiguration ebenfalls in der zugehörigen README-Datei .

Wie verbindet man ein WhatsApp-Konto?

Nachdem mautrix-whatsapp registriert und gestartet wurde, öffnen Sie einen privaten Matrix-Chat mit dem zugehörigen Bridge-Bot und senden Sie eine Nachricht login qr. Öffnen Sie WhatsApp auf dem Telefon, dem das Konto gehört, gehen Sie zu „Verknüpfte Geräte“ und scannen Sie den vom Bridge-Bot angezeigten Code. Die Bridge-Dokumentation beschreibt auch die Möglichkeit, eine Telefonnummer per Pairing-Code zu verwenden; nutzen Sie die Methode, die von Ihrer installierten Version unterstützt wird. Kopieren Sie niemals einen Anmeldecode oder ein QR-Bild in einen öffentlichen Chatraum.

Halten Sie Telefon und Konto während der Kopplung verfügbar und vergewissern Sie sich, dass die Bridge eine erfolgreiche Anmeldung meldet, bevor Sie Portalräume öffnen. Dadurch wird ein Konto über eine Sitzung im Stil eines Begleitgeräts verknüpft; die Bridge wird dadurch nicht in eine offizielle WhatsApp Business API-Integration umgewandelt. WhatsApp kann das Verhalten der Geräteverknüpfung ändern. Befolgen Sie daher die aktuellen Anweisungen zur mautrix-whatsapp-Authentifizierung . Eine Bridge synchronisiert möglicherweise nur den Verlauf, den der externe Dienst einem verknüpften Gerät zur Verfügung stellt und den die Bridge implementiert.

Wie verbindet man Telegram?

Starten Sie einen privaten Chat mit dem mautrix-telegram-Bot. Die Verbindung unterstützt QR-Code-Login und einen sechsstelligen Anmeldecode, der an einen bereits angemeldeten Telegram-Client gesendet wird; es wird kein neues Telegram-Konto erstellt. Für den QR-Code-Login öffnen Sie Telegram auf Ihrem Smartphone, gehen Sie zu Einstellungen > Geräte > Desktop-Gerät verknüpfen , senden Sie login qrden Code an den Bot und scannen Sie ihn. Folgen Sie den Anweisungen des Bots, falls die Zwei-Faktor-Authentifizierung für Ihr Telegram-Konto aktiviert ist.

Verwenden Sie ein bereits bestehendes Konto und beachten Sie die Anmelderegeln von Telegram. Die Betreiber der Brücke weisen darauf hin, dass Telegram neue Konten, die Drittanbieter-Clients verwenden, möglicherweise als verdächtig einstuft. Dies ist ein plattformseitiges Risiko, das ein Matrix-Administrator nicht ausschließen kann. Lesen Sie vor der Anmeldung die Anleitung zur Authentifizierung von mautrix-telegram und bewahren Sie Einmalcodes und Passwörter im privaten Bot-Chat auf.

Wie konfiguriert man Discord?

Das Projekt „matrix-appservice-discord“ verwendet eine Discord-Anwendung und einen Bot. Erstellen Sie die Anwendung im Discord Developer Portal , erstellen/konfigurieren Sie den zugehörigen Bot-Benutzer und legen Sie die Bot-Zugangsdaten in der Bridge-Konfiguration anhand des aktuellen Beispiels des Projekts fest. Geben Sie das Bot-Token nicht preis. Führen Sie den dokumentierten Autorisierungslink-Befehl oder -Ablauf der Bridge aus und lassen Sie anschließend den Discord-Serverbesitzer den Bot für den gewünschten Server mit den von der Bridge benötigten Berechtigungen autorisieren.

Ermitteln Sie für einen bestimmten Kanal dessen Server- und Kanal-IDs mithilfe der von Discord unterstützten Entwicklertools. Laden Sie den Matrix-seitigen Bridge-Bot in den Matrix-Raum ein und verwenden Sie den dokumentierten Raumbefehl der Bridge. Die zugehörige README-Datei enthält ein Beispiel im Format `<link>` !discord bridge ServerID ChannelID. Unter Umständen ist eine Administratorgenehmigung erforderlich, um die Verknüpfung zu vervollständigen. Verwenden Sie nicht die IDs aus dem Beispiel, sondern ersetzen Sie diese durch die tatsächlichen Kennungen. Überprüfen Sie den Befehl und die Berechtigungen anhand der README-Datei Ihrer installierten Version.

Discord ist besonders abhängig von Bot-Berechtigungen und Serverrichtlinien. Falls der Bot zwar beitreten kann, aber keine Nachrichten gesendet werden, überprüfen Sie, ob der Kanal für ihn sichtbar ist, die erforderlichen Nachrichtenberechtigungen erteilt wurden und die Bridge alle Administratorbestätigungen abgeschlossen hat. Das Projekt kennzeichnet sich in seiner README-Datei als Beta-Projekt. Prüfen Sie daher den aktuellen Projektstatus und das unterstützte Verhalten, anstatt anzunehmen, dass alle Discord-Funktionen übernommen wurden.

Wie kann man die Funktionsfähigkeit der Brücke überprüfen?

Nutzen Sie zunächst einen kleinen, privaten Testraum und einen risikoarmen Kanal. Senden Sie eine eindeutige Klartextnachricht aus Matrix und prüfen Sie, ob sie auf dem Remote-Dienst erscheint. Antworten Sie anschließend vom Remote-Server und prüfen Sie, ob die Antwort in Matrix angezeigt wird. Überprüfen Sie die Zuordnung, den Antwortverlauf, Anhänge, Bearbeitungen und Reaktionen separat, falls diese für Ihren Anwendungsfall relevant sind. Ein grüner Prozessstatus bedeutet lediglich, dass das Programm ausgeführt wird: Er bestätigt weder eine erfolgreiche Anmeldung noch den Kanalzugriff des Bots oder die korrekte Zuordnung von Raum zu Kanal.

Wenn ein Test fehlschlägt, vergleichen Sie den genauen Zeitpunkt der Meldung mit den Logs der Bridge und des Homeservers. Schwärzen Sie Zugriffstoken, Telefonnummern, Discord-IDs (sofern vertraulich) und Kontaktnamen, bevor Sie die Logs weitergeben. Prüfen Sie bei Container-Bereitstellungen außerdem, ob die Registrierungsdatei in Synapse eingebunden ist, der Bridge-Endpunkt im gemeinsamen Netzwerk aufgelöst werden kann und keine Firewall den konfigurierten Listener blockiert.

Was sollten Sie über Verschlüsselung und Datenschutz wissen?

Anwendungsdienste empfangen Ereignisse in den Namensräumen und Räumen, für deren Verarbeitung sie konfiguriert sind. Gehen Sie nicht davon aus, dass ein verschlüsselter Matrix-Raum automatisch von jeder Bridge lesbar ist. Einige Mauttrix-Bridges unterstützen Ende-zu-Bridge-Verschlüsselung, die explizit konfiguriert werden muss und eigene Anforderungen an die Schlüsselverwaltung stellt. Konsultieren Sie den Mauttrix-Leitfaden zur Ende-zu-Bridge-Verschlüsselung und prüfen Sie die Unterstützung für die jeweilige Bridge. Die Verschlüsselungsfunktionen von Discord-Bridges können abweichen. Wenn eine Bridge den Verschlüsselungsmodus des Raums nicht verarbeiten kann, verwenden Sie einen geeigneten unverschlüsselten Testraum oder wählen Sie eine Bridge mit dokumentierter Unterstützung, anstatt einen Produktionsraum durch Vermutungen zu schwächen.

Denken Sie daran, dass Nachrichteninhalte und Zugangsdaten über Ihre eigene oder die Software eines öffentlichen Bridge-Betreibers übertragen werden. Beschränken Sie die Anzahl der Bridge-Bots, die Sie einladen können, schützen Sie Datenbanken und Backups, wechseln Sie Token regelmäßig, falls diese kompromittiert werden, und überprüfen Sie die aktuellen Datenschutz- und Sicherheitsrichtlinien der Bridge. Prüfen Sie vor Aktualisierungen die Dokumentation des ursprünglichen Anbieters: Konfigurationsschlüssel, Anmeldevorgänge, Abhängigkeiten und Plattformrichtlinien können sich unabhängig voneinander ändern.

Checkliste für schnelle Entscheidungen

• Wählen Sie eine Bridge-Instanz, deren Betreiber und Zugriffsrichtlinie Sie vertrauen.
• Registrieren Sie jede Bridge separat und schützen Sie jedes generierte Token.
• Überprüfen Sie, ob der Homeserver nach der Bereitstellung die Bridge-Adresse erreichen kann.
• Verknüpfe WhatsApp-/Telegram-Konten privat und autorisiere den Discord-Bot mit einem Serveradministrator.
• Testen Sie die Nachrichten in beide Richtungen und anschließend nur die zusätzlichen Funktionen, die Sie benötigen.
• Prüfen Sie die Unterstützung von Verschlüsselung, das bisherige Verhalten und den Wartungsstatus, bevor Sie die Brücke für sensible oder wichtige Kommunikation nutzen.