Matrix

Matrix ist ein offenes Chat-Netz mit vielen Servern; die bekannteste App ist Element. Mit dem Baustein Matrix schreibt ein eigenes Bot-Konto jeden Alarm in einen Raum, etwa für deine Community. Matrix gibt es im Plan Community; jeder Raum zählt wie eine Telegram-Gruppe gegen die 20 Ziele.

Warum ein eigenes Konto? Bellchain schreibt in deinem Namen in den Raum. Ein gemeinsamer Bellchain-Bot dürfte auf matrix.org nur etwa eine Nachricht in fünf Sekunden schicken, für alle Kunden zusammen. Mit deinem eigenen Bot-Konto zählt nur dein Kontingent.

Einrichten

1. Bot-Konto anlegen: Registriere auf deinem Homeserver ein zweites Konto, etwa bellchain-bot auf matrix.org über app.element.io, mit Benutzername und Passwort (nicht über „Mit Google anmelden“).

2. In den Raum einladen: Lade das Bot-Konto mit deinem eigenen Konto in den Raum ein, etwa @bellchain-bot:matrix.org. Annehmen musst du nichts: Beim ersten Alarm oder Test tritt das Bot-Konto selbst bei.

3. Zugangstoken holen: Melde das Bot-Konto einmal im Terminal an. Für matrix.org:

   curl -s -X POST https://matrix-client.matrix.org/_matrix/client/v3/login \
     -H 'Content-Type: application/json' \
     -d '{"type":"m.login.password","identifier":{"type":"m.id.user","user":"bellchain-bot"},"password":"DEIN-PASSWORT","initial_device_display_name":"Bellchain"}'

   Die Antwort enthält "access_token": "…". Kopier den Wert ohne Anführungszeichen. Bei einem eigenen Server steht statt matrix-client.matrix.org dessen Adresse.

4. Zieh im Editor den Baustein Matrix aufs Board und trag Homeserver (etwa https://matrix.org), Zugangstoken und Raum ein: die Adresse wie #alarme:matrix.org oder die ID, die mit ! beginnt (in Element unter Raumeinstellungen → Erweitert).

5. Klick in den Eigenschaften auf Test senden. Kommt die Nachricht im Raum an, verbinde den Baustein mit deiner Bedingung.

Achtung

Nimm nicht das Token aus den Einstellungen von Element: Auf Servern mit dem neuen Login (wie matrix.org) läuft es nach wenigen Minuten ab. Das Token aus Schritt 3 gilt, bis du die Sitzung „Bellchain“ des Bot-Kontos abmeldest. Wer es kennt, kann als Bot schreiben; es bleibt im Export einer Chain leer.

Was im Raum steht

• Kopfzeile mit 🔔 und dem Namen der Chain, darunter deine Nachricht als Zitat, die Werte beim Auslösen und Paar, Zeiteinheit mit „Schluss“ und Uhrzeit in deiner Zeitzone.
• Keine Erwähnungen: @room und Namen in der Nachricht pingen niemanden an.
• Benachrichtigen: Unter den erweiterten Einstellungen wählst du Still; dann kommt der Alarm als Hinweis (m.notice), den Element ohne Ton zeigt.
• Scanner: Melden mehrere Coins eines Scanners an derselben Kerze, kommt eine Nachricht mit allen.

Grenzen

• Verschlüsselte Räume: Bellchain schickt unverschlüsselt. In einem verschlüsselten Raum kommt die Nachricht trotzdem an, Element markiert sie dann als nicht verschlüsselt. Für reine Alarm-Räume schalte die Verschlüsselung beim Anlegen aus.
• Tempo: Synapse-Server wie matrix.org lassen ein Konto nach zehn schnellen Nachrichten nur noch etwa eine je fünf Sekunden schicken. Bellchain wartet dann und versucht es erneut.
• Der Homeserver muss aus dem Internet per https erreichbar sein.

Wenn etwas nicht ankommt

Grund im Verlauf	Bedeutung
matrix_token_invalid	Das Token ist falsch oder abgemeldet. Hol in Schritt 3 ein neues.
matrix_not_invited	Das Bot-Konto ist nicht in den Raum eingeladen, oder er ist für es gesperrt.
matrix_room_not_found	Diese Raumadresse gibt es nicht.
matrix_forbidden	Im Raum dürfen nur bestimmte Mitglieder schreiben; gib dem Bot-Konto die Rechte dafür.
matrix_rate_limited, matrix_unavailable, matrix_network	Der Server bremst oder war nicht erreichbar; Bellchain versucht es später erneut.