Startseite
» Gewusst wie
»
Verbinde Matrix mit WhatsApp, Telegram und Discord über separate Brücken.
Verbinde Matrix mit WhatsApp, Telegram und Discord über separate Brücken.
Um WhatsApp, Telegram und Discord zu verbinden, müssen drei separate Bridges eingerichtet, jede als Anwendungsdienst registriert und der jeweilige Anmeldevorgang genutzt werden. Erfolg bedeutet, dass jeder Bot eine authentifizierte Sitzung meldet und Testnachrichten in beide Richtungen über Portalräume übertragen werden; es genügt nicht, dass ein Bot lediglich online erscheint.
Dies richtet sich an Administratoren von Heimservern, die Anwendungsdienste zulassen. Sie können keine selbstgehostete Bridge zu matrix.org hinzufügen, es sei denn, die Administratoren bieten eine solche an; verwenden Sie stattdessen einen Server, den Sie kontrollieren, oder eine verfügbare gehostete Bridge. Die Projektdokumentation wurde am 10. Oktober 2026 geprüft.
1. Entscheiden Sie, was Sie verbinden möchten, und bereiten Sie den Server vor.
Es handelt sich um drei separate Dienste mit jeweils eigener Konfiguration, Registrierung, Datenbank und Anmeldung. Mautrix nutzt hauptsächlich Puppet: Nachrichten werden über Ihr verknüpftes Remote-Konto übertragen und erscheinen in Mautrix unter diesem Konto. Ein Relay-Bot funktioniert anders; wählen Sie ihn nur, wenn Sie eine geteilte Bot-Identität anstelle Ihres persönlichen Kontos verwenden möchten.
Sie benötigen einen anwendungsfähigen Homeserver, Administratorrechte und Netzwerkverbindungen zu jeder Bridge. Docker ist dokumentiert. Weisen Sie jeder Bridge ein eigenes Datenverzeichnis zu und wählen Sie ein Versionskennzeichen, das regelmäßig aktualisiert wird. Mautris weist darauf hin, dass dies latestmöglicherweise den letzten Commit anstelle einer Release-Version verfolgt.
Verwenden Sie pro Bridge eine separate Datenbank. Ein PostgreSQL-Server kann gemeinsam genutzt werden, die Datenbank selbst darf jedoch nicht mit einer anderen Bridge oder Synapse geteilt werden. Für kleinere Instanzen bietet sich SQLite an. Entscheiden Sie sich vor der Anmeldung für eine Ende-zu-Ende-Verschlüsselung, da deren nachträgliche Aktivierung für bestehende Portalräume schwierig ist.
Die Konfiguration und Datenbank jeder Bridge sollten sich in einem eigenen Arbeitsverzeichnis befinden, bevor die Container gestartet werden.
2. Konfigurieren und registrieren Sie alle drei Anwendungsdienste.
Generieren Sie die Erstkonfiguration jeder Bridge. Folgen Sie der Docker-Einrichtungsseite für die jeweilige Bridge und starten Sie den Container einmalig mit dem eingebundenen Datenverzeichnis. Bearbeiten Sie die generierte Konfiguration, bevor Sie sie regulär starten. Tragen Sie die Domain und Adresse des Homeservers, die Bridge-Adresse, die Datenbank-URI und die Berechtigungen ein. Diese Werte sind spezifisch für Ihre Bereitstellung; verwenden Sie keine Beispiel-Secrets in der Produktionsumgebung.
Verwenden Sie containererreichbare Adressen. Wenn Synapse und die Bridges sich ein Docker-Netzwerk teilen, kann die Homeserver-Adresse der Bridge den Synapse-Dienstnamen verwenden, z. B. `example.com` http://synapse:8008. Die Anwendungsdienstadresse muss auf den Dienstnamen und den Listening-Port dieser Bridge verweisen. localhostWenn die Adresse innerhalb eines Bridge-Containers auf denselben Container verweist, nicht auf Synapse oder eine andere Bridge, führt dies in der Regel zu Kommunikationsproblemen. Befindet sich der Homeserver außerhalb von Docker, veröffentlichen oder routen Sie stattdessen den benötigten Bridge-Port.
Generieren und installieren Sie für jede Bridge eine Registrierungsdatei. Führen Sie den Setup-Befehl jeder Bridge aus, um deren Registrierungs-YAML zu generieren, und platzieren Sie anschließend alle drei Dateien an einem Ort, an dem Synapse sie lesen kann. Fügen Sie in der Datei `/etc/synapse/config/example.com` homeserver.yamlderen Pfade unter `/etc/ synapse/config/example.com` hinzu app_service_config_files, zum Beispiel:
Wenn Synapse in Docker ausgeführt wird, binden Sie die Registrierungsdateien im Synapse-Container ein. Starten Sie Synapse nach der Bearbeitung der Liste neu. Ein Tippfehler in der YAML-Datei, ein falscher Pfad, eine nicht lesbare Einbindung oder eine nicht übereinstimmende Bridge-Adresse können die Registrierung verhindern oder den Start von Synapse unterbrechen. Wenn Sie später registrierungsbezogene Bridge-Einstellungen ändern, generieren Sie die entsprechende Registrierungsdatei neu und starten Sie Synapse erneut.
Synapse benötigt für jede Bridge einen separaten, lesbaren Registrierungspfad, gefolgt von einem Neustart des Homeservers.Prüfen Sie, ob Synapse und alle drei Bridge-Container in einem Netzwerk laufen, in dem ihre Dienstnamen aufgelöst werden können.
3. Fügen Sie die dienstspezifischen Anmeldeinformationen hinzu und melden Sie sich an.
WhatsApp
Starten Sie mautrix-whatsapp und öffnen Sie eine Matrix-Direktnachricht mit dem Bridge-Bot @whatsappbot:your.server. Senden Sie eine Nachricht login qrund scannen Sie anschließend den QR-Code auf Ihrem Smartphone unter „Verknüpfte Geräte“. Warten Sie, bis der Bot die Authentifizierung bestätigt hat. Laut Dokumentation kann es bis zu einer Minute dauern, bis die Portalräume angezeigt werden. WhatsApp ist als Gerät verknüpft, es handelt sich also nicht um ein eigenständiges Cloud-Konto. Die Dokumentation besagt, dass die Verbindung zwischen verknüpften Geräten getrennt wird, wenn das Smartphone länger als zwei Wochen offline ist. Wenn Sie Ihr Smartphone nicht durchgehend nutzen können, überlegen Sie, ob diese Bridge Ihre Zuverlässigkeitsanforderungen erfüllt, bevor Sie sie für wichtige Chats verwenden.
Telegram
Erstellen Sie vor der Telegram-Anmeldung eine API-Anwendung unter my.telegram.org/apps und tragen Sie deren api_idWerte api_hashin die Konfiguration von mautrix-telegram ein. Diese API-Werte ermöglichen die Verbindung der Bridge zur Telegram-API; sie authentifizieren jedoch kein Telegram-Konto. Senden Sie anschließend eine Nachricht @telegrambot:your.serverund verwenden Sie login qrdie Option `--code`, indem Sie diese in der Telegram-App unter Einstellungen > Geräte > Desktop-Gerät verknüpfen scannen. Die Code-Option kann an eine bestehende Telegram-Sitzung anstatt per SMS übermittelt werden, und die Bridge kann Sie zur Eingabe Ihres Zwei-Faktor-Authentifizierungspassworts auffordern. Überprüfen Sie die Einstellungen für das Importieren älterer Nachrichten vor der Anmeldung; Änderungen nach der Erstellung von Portalräumen sind möglicherweise nicht mehr möglich.
Discord
Verwenden Sie für einen Server einen dedizierten Discord-Bot und nicht die Automatisierung Ihres persönlichen Kontos: Discord verbietet Self-Bots und kann Konten sperren. Erstellen Sie eine Anwendung und einen Bot im Entwicklerportal, aktivieren Sie nur die privilegierten Intents, die die Bridge benötigt und Ihre App abrufen kann, und laden Sie sie anschließend mit dem OAuth2-Bot-Scope und den minimalen Kanalberechtigungen ein. Der Intent-Zugriff ist richtliniengesteuert; ohne die erforderlichen Zugriffsrechte für Nachrichteninhalte oder Mitglieder funktionieren einige Funktionen möglicherweise nicht. In Matrix senden Sie eine Direktnachricht @discordbot:your.serverund folgen Sie den Anweisungen zur Anmeldung mit dem Bot-Token von mautrix-discord. Ein Bot bietet nicht denselben Zugriff auf persönliche Direktnachrichten wie eine Benutzerkonto-Bridge.
Überprüfen Sie den Dienst-Hostnamen, den Bridge-Listener und die eindeutigen Datenbankdetails in der jeweiligen Konfiguration jeder Bridge.
4. Testen Sie die Auslieferung und passen Sie anschließend nur die Ergebnisse an.
Senden Sie jedem Bridge-Bot eine Direktnachricht und bestätigen Sie den Authentifizierungsstatus. Senden Sie in einem Portalraum pro Dienst eine Testnachricht von Matrix und antworten Sie über die Remote-App. Stellen Sie sicher, dass beide Nachrichten im richtigen Raum ankommen. Bei Gruppen oder Discord-Kanälen prüfen Sie zunächst, ob das Bridge-Konto vorhanden ist und Lese-/Schreibberechtigungen besitzt. Ein erfolgreicher Login allein beweist noch keine Zustellung.
Wenn ein Bot keine Meldungen ausgibt, überprüfen Sie seine Protokolle auf fehlende Werte, Datenbankfehler oder Verbindungsprobleme mit dem Homeserver. Wenn die Anmeldung funktioniert, aber keine Räume angezeigt werden, überprüfen Sie die Portal- und Backfill-Einstellungen. Bei fehlenden Discord-Kanalnachrichten überprüfen Sie die Bot-Mitgliedschaft, Berechtigungen und den Zugriff auf Intents. Falls Synapse nicht startet, überprüfen Sie die YAML-Einrückung und die korrekte Einbindung der Registrierungsdatei.
Der Funktionsumfang variiert je nach Bridge-Version und Kontotyp; Anrufe, Reaktionen, verschlüsselte Chats, Medien und der Import des Verlaufs können abweichen oder nicht unterstützt werden. Prüfen Sie die aktuelle Funktionsliste der jeweiligen Bridge, bevor Sie diese als einzigen Zugriffspunkt nutzen. Beschränken Sie den Zugriff auf Registrierungsdateien und Zugangsdaten, sichern Sie Bridge-Daten sicher und widerrufen Sie verknüpfte Sitzungen oder Token, falls diese offengelegt wurden.