Skip to main content

🌐 ioBroker.matrix-org

ioBroker.matrix-org – Anleitung für Matrix-Integration mit eigenem Server

🔗 Projektlink: github.com/oelison/ioBroker.matrix-org

⚠️ Wichtig:
Der Adapter unterstützt keine verschlüsselten Räume!
Ende-zu-Ende-Verschlüsselung beim Erstellen des Raums unbedingt deaktivieren.
Bei eigenem Matrix-Server mit HTTPS ist die Verbindung dennoch sicher verschlüsselt, nur eben nicht Ende-zu-Ende.

🏠 1. Raum erstellen (z.B. in Element)

  • Raumtyp: privat
  • Ende-zu-Ende-Verschlüsselung: deaktivieren
  • Nur Nutzer von lmatrix.de erlauben: aktivieren
  • Raum-Alias: wird später gesetzt (siehe Schritt 3)

👤 2. Matrix-Benutzer erstellen

  • Username: bot.iobroker
  • Homeserver: lmatrix.de
  • Ergebnis: @bot.iobroker:lmatrix.de
  • Passwort: merken (wird im Adapter eingetragen)

🏷️ 3. Raum-Alias unter „Lokale Adressen“ setzen

  1. Raum in Element öffnen
  2. Raumeinstellungen → Raumadressen → Lokale Adresse
  3. Alias eingeben: iobroker
  4. Hinzufügen klicken

➡️ erzeugt: #iobroker:lmatrix.de

💡 Hinweis:
Matrix unterscheidet Groß-/Kleinschreibung – #ioBroker ≠ #iobroker

⚙️ 4. Adapter-Konfiguration in ioBroker

ioBroker.matrix-org.jpg (Ab Version 1.2.0 ist der Adapter kompatibel mit Node.js 22)

Adapter: matrix-org.0

Einstellung Wert
Server lmatrix.de
Port 443
Bot-Name @bot.iobroker:lmatrix.de
Bot-Passwort xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Raumname #iobroker:lmatrix.de
[✔] Dem eingeladenen Kanal automatisch beitreten

🤖 5. Bot in den Raum einladen

Der Bot (@bot.iobroker:lmatrix.de) muss aktiv in den Raum eingeladen werden:

  • Manuell über Element
  • Oder automatisch durch die Adapter-Option
    „Dem eingeladenen Kanal automatisch beitreten“

🧪 6. Test über JavaScript-Adapter

Adapter-Instanz: matrix-org.0

Im Blockly-Editor folgenden Block verwenden:

matrix instanz: "matrix-org.0"
nachricht:      "Testnachricht von ioBroker 🤖"

➡️ sendet direkt eine Nachricht an den konfigurierten Raum.
➡️ Voraussetzung: Bot ist Mitglied im Raum und Adapter läuft.
➡️ Nachricht erscheint im Raum #iobroker:lmatrix.de.

🧩 7. Blockly-Nutzung (optional)

Im Blockly kannst Du:

Variante 1:
Den Block „matrix instanz → nachricht“ verwenden (funktioniert direkt).

ioBroker.Matrix-org_Blockly.jpg

Variante 2:
Den generischen sendTo-Block ohne Befehl verwenden:

[sendTo]
→ Instanz: matrix-org.0
→ Befehl: *(leer lassen)*
→ Parameter: "Deine Nachricht"

💡 Hinweis:
Diese Anleitung beschreibt die grundlegende Einrichtung für die Matrix-Kommunikation via ioBroker.
Weitere Optionen findest Du im GitHub-Repository des Adapters: github.com/oelison/ioBroker.matrix-org

Back to top