Kapitel 51
Matrix-Brücke
Auf dieser Seite
Die Matrix-Brücke verbindet einen Chat-Raum in Coviqo mit einem Raum auf einem beliebigen Matrix-Homeserver – zum Beispiel matrix.org oder dem eigenen Server eurer Community. Was an einer Stelle geschrieben wird, erscheint auch an der anderen: Leute auf Matrix nutzen weiter ihre Matrix-App (Element, FluffyChat …), Leute in Coviqo nutzen weiter Coviqo.
Du findest sie unter Space-Einstellungen → Apps & Integrationen → Matrix-Brücke. Du musst Eigentümer oder Administrator des Space sein (Berechtigung Space verwalten).
Bevor du loslegst#
- Tarif: Die Brücke ist ab Community Pro enthalten (Free: nicht verfügbar). Der Tarif bestimmt, wie viele Räume eines Space verbunden werden können.
- Richtlinie der Organisation: Unternehmen können Brücken verbieten (Organisation → Richtlinien → Matrix-Brücken erlauben; die Voreinstellungen Medium und Geschlossen schalten sie aus). Ist die Option aus, kann kein Raum in den Spaces der Organisation verbunden werden, und Nachrichten verwalteter Mitglieder werden nie zu Matrix übertragen – aus keinem Space.
- Ein Bot-Nutzer auf Matrix: Lege auf dem Homeserver deiner Wahl einen eigenen Matrix-Nutzer für die Brücke an (nicht dein persönliches Konto) und hol dir sein Zugangstoken (in Element: Einstellungen → Hilfe & Info → Zugangstoken, oder über die Login-API). Alles, was dieser Nutzer in verbundenen Räumen sehen kann, wird zu Coviqo übertragen.
- Nur unverschlüsselte Räume: Ende-zu-Ende-verschlüsselte Coviqo-Räume und verschlüsselte Matrix-Räume lassen sich nicht verbinden.
Einrichten#
- Schalte Matrix-Brücke in diesem Space ein.
- Klicke auf Bot-Konto hinzufügen und gib die Homeserver-Adresse (z. B.
https://matrix-client.matrix.org) und das Zugangstoken ein. Coviqo prüft das Token beim Homeserver und zeigt den Matrix-Nutzer an, zu dem es gehört. Das Token wird verschlüsselt gespeichert und nie wieder angezeigt. - Klicke auf Raum verbinden:
- Wähle den Coviqo-Raum und das Bot-Konto,
- gib den Matrix-Raum ein:
#room:example.org(Adresse) oder!id:example.org(Raum-ID); ein matrix.to-Link funktioniert auch. Bei einem privaten Matrix-Raum lädst du den Bot-Nutzer zuerst dorthin ein, - setze optional das Häkchen bei Die letzten 50 Matrix-Nachrichten übernehmen,
- lies den Hinweis – Nachrichten dieses Raums werden an den Homeserver übertragen – und bestätige ihn.
- Der Bot tritt dem Matrix-Raum bei. Ab jetzt werden Nachrichten in beide Richtungen übertragen.
Was übertragen wird#
| Von Coviqo zu Matrix | Von Matrix zu Coviqo |
|---|---|
| Nachrichten als „Name (Coviqo): Text“ – mit deinem Namen in diesem Space | Nachrichten mit dem Namen und Bild der Matrix-Person und einem Abzeichen Matrix · Homeserver |
| Antworten und Thread-Antworten | Antworten und Threads |
| Bearbeitungen und Löschungen | Bearbeitungen (nur durch die ursprünglich verfassende Person) und Löschungen |
| Reaktionen – eine pro Emoji von der Brücke | Reaktionen – angezeigt als eine Reaktion der Brücke pro Emoji |
| Anhänge bis 20 MB (nach der Malware-Prüfung) | Anhänge bis 20 MB (geprüft wie jeder Upload) |
Erwähnungen werden zu einfachen Namen (@Dana). Leute auf Matrix können in Coviqo niemanden anpingen, und @everyone von Matrix bewirkt nichts. Nachrichten von Matrix lassen sich in Coviqo nicht bearbeiten; Moderierende können sie löschen (das entfernt sie nur in Coviqo).
Der Hinweis im Raum#
Alle in einem verbundenen Raum sehen: „Dieser Raum ist mit Matrix verbunden – Nachrichten werden an <homeserver> übertragen“. Denk daran, dass das, was du dort schreibst, Coviqo verlässt: Das Matrix-Netzwerk verteilt es an alle Server, die am Raum beteiligt sind. Wird eine Nachricht in Coviqo gelöscht, wird auch ihre Kopie auf Matrix entfernt; bereits übertragene Kopien bleiben aber auf Matrix, wenn ein Coviqo-Konto gelöscht wird.
Status und Probleme#
Jedes Bot-Konto und jede Verbindung zeigt ihren Zustand – Aktiv, Gestört, Pausiert oder Fehler – und wann zuletzt etwas übertragen wurde:
- Token ungültig – das Token wurde widerrufen oder ist abgelaufen: Nutze Token ersetzen (gleicher Matrix-Nutzer).
- Der Homeserver bremst (Rate-Limit) / Homeserver nicht erreichbar – Coviqo versucht es automatisch erneut.
- Der Matrix-Raum ist jetzt verschlüsselt / Der Raum ist jetzt Ende-zu-Ende-verschlüsselt – nicht unterstützt; trenne den Raum.
- Der Bot ist nicht mehr im Matrix-Raum / darf nicht schreiben – lade den Bot erneut ein oder gib ihm das Recht zu schreiben und schalte die Verbindung dann wieder ein.
Das Ausschalten einer Verbindung pausiert sie; Nachrichten, die während der Pause geschrieben werden, werden nicht nachträglich übertragen. Trennen beendet die Übertragung endgültig, der Bot verlässt den Matrix-Raum, und bis dahin übertragene Nachrichten bleiben auf beiden Seiten erhalten. Bot-Konto entfernen trennt alle seine Räume und löscht das Token in Coviqo – widerrufe es zusätzlich auf dem Homeserver.