Diese #howto-Anleitung beschreibt, wie der in discourse-chat-integration enthaltene Matrix (element.io)-Anbieter eingerichtet wird.
\u003e Vielen Dank an @ara4n und die Mitglieder des Raums #matrix-dev:matrix.org für ihre Unterstützung bei dieser Integration
Installation
Das discourse-chat-integration-Plugin ist in Discourse enthalten. Stellen Sie sicher, dass es aktiviert ist, indem Sie in den Site-Einstellungen chat_integration_enabled auf true setzen. Weitere Details finden Sie im discourse-chat-integration-Plugin-Thema.
Einrichtung von Matrix
Diese Anweisungen gehen davon aus, dass Sie den Web-Client element.io verwenden. Ähnliche Schritte sollten auch mit anderen Schnittstellen möglich sein.
Öffnen Sie https://app.element.io/ in einem neuen Inkognito-Fenster (Sie werden später verstehen, warum)
Erstellen Sie ein Benutzerkonto für Ihren Bot. Es ist ratsam, das Passwort irgendwo aufzuschreiben, falls Sie sich später wieder anmelden möchten. Discourse benötigt es nicht.
Nutzen Sie die Schnittstelle, um an beliebigen Räumen teilzunehmen, an die Sie Benachrichtigungen senden möchten
Öffnen Sie die Benutzereinstellungen, indem Sie oben links auf Ihr Avatar klicken, dann auf \u003ckbd\u003eAlle Einstellungen\u003c/kbd\u003e
Konfigurieren Sie den Anzeigenamen und das Avatar des Bots
Wechseln Sie zum Reiter „Hilfe und Über", scrollen Sie nach unten zu „Erweitert" und kopieren Sie die Homeserver-Adresse sowie Ihr „Zugriffstoken" – Sie werden diese später benötigen.
NICHT AUF ABMELDEN KLICKEN. Wenn Sie dies tun, wird das Zugriffstoken ungültig und funktioniert nicht. Schließen Sie stattdessen einfach das Inkognito-Fenster. Falls Sie vergessen haben, ein Inkognito-Fenster zu öffnen, gehen Sie zurück zu Schritt 1
Einrichtung von Discourse
Geben Sie in Ihren Discourse-Site-Einstellungen Ihre Homeserver-Adresse in die Einstellung chat_integration_matrix_homeserver ein. Stellen Sie sicher, dass Sie das Protokoll einschließen (z. B. https://matrix.org). Fügen Sie kein abschließendes Schrägstrich hinzu.
Fügen Sie das zuvor kopierte Zugriffstoken in die Site-Einstellung chat_integration_matrix_access_token ein
Aktivieren Sie chat_integration_matrix_enabled
Gehen Sie zum Reiter \u003ckbd\u003ePlugins\u003c/kbd\u003e, dann zu \u003ckbd\u003eChat-Integrationen\u003c/kbd\u003e
Gehen Sie zum Reiter \u003ckbd\u003eMatrix\u003c/kbd\u003e, dann zu \u003ckbd\u003eKanal erstellen\u003c/kbd\u003e
Geben Sie einen Namen für den Kanal ein (dies wird nur in der Admin-Oberfläche angezeigt und kann beliebig sein)
Geben Sie die „Raum-ID" für einen Raum ein, an den Sie Benachrichtigungen senden möchten. Im Element-Web-Client finden Sie diese, indem Sie Ihren Raum öffnen, oben auf den Namen klicken und dann nach unten scrollen. Sie sieht ungefähr so aus:
!cdGUowUAqlgLHVerqE:matrix.org
Hinweis: Neuere Matrix-Raum-IDs der Version 12 enthalten möglicherweise kein :server-Suffix (z. B. !abcdefghijkl). Beide Formate werden unterstützt.
\u003ckbd\u003eKanal speichern\u003c/kbd\u003e
Verwenden Sie die Taste \u003ckbd\u003eTest\u003c/kbd\u003e auf dem soeben erstellten Kanal, um zu prüfen, ob alles funktioniert. Sie sollten etwas Ähnliches wie Folgendes sehen:
Zum Zeitpunkt des Schreibens scheint es keine benutzerfreundliche Möglichkeit zu geben, ein „Zugriffstoken" für einen „Bot" zu erhalten. Die Lösung mit dem Inkognito-Fenster ist die benutzerfreundlichste Methode, die ich finden konnte.
Dieses Plugin sendet Rich-Text-Nachrichten im Format org.matrix.custom.html, das Teil der Matrix-Spezifikation ist. Clients, die formatierte Nachrichten nicht unterstützen, fallen auf eine Klartext-Nachricht zurück.
Standardmäßig werden Nachrichten als m.notice gesendet (was Matrix-Clients in der Regel leiser darstellt). Sie können dies auf m.text ändern, indem Sie die Site-Einstellung chat_integration_matrix_use_notice deaktivieren.
Diese Implementierung sieht keine Möglichkeit zum „Aktualisieren" von Zugriffstoken vor. Dies basiert auf der Annahme, dass die meisten aktuell verwendeten Homeserver Token nicht verfallen. Sollte sich dies in Zukunft ändern, muss dies erneut überprüft werden.
I just tried setting up a matrix integration using the instructions above, and it all worked ok. Can you confirm that you’re running the latest version of Discourse and this plugin?
Are you using the matrix.org homeserver, or your own homeserver? The 422 error is coming from that server.
I would suggest double checking your channel identifier, and also your matrix access token in your Discourse site settings.
I have absolutely the same issue as @almereyda has. @david, can you update obtaing “Access Token”, please? (Riot seems to be intensively developed )
+“Doctor log”
Ich habe die Einrichtung gerade selbst durchlaufen und es schien in Ordnung zu funktionieren. Ein paar Theorien:
Sind Ihre Räume verschlüsselt? Ich bin mir nicht sicher, ob wir zusätzliche Arbeit leisten müssen, um verschlüsselte Räume zu unterstützen.
Vielleicht laufen die Zugriffstoken nach einiger Zeit ab. Das passierte früher nicht, als ich die Integration 2017 erstellt habe, aber das ist lange her . Ich werde meine lokale Konfiguration später diese Woche noch einmal ausprobieren und sehen, ob sie immer noch funktioniert.
Zur Information: @mattdm und ich konnten dies auf einen nachgestellten Schrägstrich in der Homeserver-URL in den Discourse-Einstellungen zurückführen.
Ich habe dies in den Anweisungen im OP vermerkt und auch die Anweisungen für das Zugriffstoken aktualisiert, damit sie mit der neuesten Benutzeroberfläche von element.io funktionieren.
Der Zugriffstoken des Bot-Kontos wurde unabhängig verifiziert, indem eine Nachricht mit der API (_matrix/client/r0/rooms/{room_id}/send/m.room.message) an unseren eigenen Matrix-Server gesendet wurde.
Die Discourse-Logs zeigen:
Started POST "/admin/plugins/chat-integration/test" for 141.142.60.55 at 2022-11-16 18:16:47 +0000
Processing by DiscourseChatIntegration::ChatController#test as */*
Parameters: {"channel_id"=>"107", "topic_id"=>"466"}
Completed 500 Internal Server Error in 62ms (ActiveRecord: 0.0ms | Allocations: 10109)
NameError (uninitialized constant FinalDestination::HTTP)
app/controllers/application_controller.rb:387:in `block in with_resolved_locale'
app/controllers/application_controller.rb:387:in `with_resolved_locale'
lib/middleware/omniauth_bypass_middleware.rb:71:in `call'
lib/content_security_policy/middleware.rb:12:in `call'
lib/middleware/anonymous_cache.rb:361:in `call'
config/initializers/100-quiet_logger.rb:23:in `call'
config/initializers/100-silence_logger.rb:31:in `call'
lib/middleware/enforce_hostname.rb:23:in `call'
lib/middleware/request_tracker.rb:198:in `call'
Ich habe es nicht versucht, aber das wäre interessant. Meinen Sie, alle Beiträge in einem Thread zusammenzufassen, um die Kanalunordnung zu reduzieren, oder würden dabei Themenantworten in einem Matrix-Thread veröffentlicht werden?
Ich bin neugierig, ob es Entwicklungen beim Hinzufügen von Thread-Antwortunterstützung für Matrix gab. Einige unserer Benutzer würden dies zu schätzen wissen.
)
. Ich werde meine lokale Konfiguration später diese Woche noch einmal ausprobieren und sehen, ob sie immer noch funktioniert.