Matrix-Nachricht senden (flow.matrix-message)
Postet eine Nachricht in einen Chat-Raum oder Space-Chat.
Wofür Sie diesen Baustein nutzen
In vielen schulischen Abläufen reicht es nicht, einen Vorgang nur in der Aufgabenliste festzuhalten — die betroffenen Personen sollen unmittelbar im Chat davon erfahren. Der Baustein „Matrix-Nachricht senden" schreibt automatisch eine Nachricht in einen Prilog-Chat-Raum oder in den Chat eines bestimmten Spaces, sobald der Flow diesen Schritt erreicht.
Typische Anwendungsfälle in Schulen sind zum Beispiel:
- Eine neue Anmeldung trifft über ein Webformular ein, und das Sekretariat soll sofort eine Meldung im Team-Chat erhalten.
- Ein Genehmigungsantrag wird abgeschlossen, und der antragstellenden Person wird der Ausgang direkt in ihren Raum geschrieben.
- Ein automatisierter Ablauf meldet am Ende jeder Woche den Stand offener Aufgaben in den Chat der Schulleitung.
Der Baustein ist ein Aktions-Baustein: Er steht innerhalb eines Flows, nicht am Anfang. Er kann beliebig oft in einem Flow auftauchen — zum Beispiel, um sowohl den Antragsteller als auch die Schulleitung getrennt zu benachrichtigen.
Die Nachricht kann feste Texte enthalten oder Platzhalter nutzen, die beim Ausführen mit echten Werten aus dem Flow gefüllt werden. So entstehen persönliche, kontextbezogene Mitteilungen, ohne dass jemand manuell eingreifen muss.
Die Einstellungen im Detail
| Feld | Pflicht | Was es bewirkt |
|---|---|---|
| Matrix-Raum-ID | ✗ Nein | Gibt den genauen Matrix-Raum an, in den gepostet wird |
| Prilog-Space-ID | ✗ Nein | Alternative zur Raum-ID; postet in den Chat des angegebenen Space |
| Nachricht | ✓ Ja | Der Text, der in den Chat geschrieben wird |
Entweder die Matrix-Raum-ID oder die Prilog-Space-ID muss angegeben sein — beide Felder gleichzeitig leer zu lassen führt dazu, dass der Schritt fehlschlägt.
Matrix-Raum-ID
Die Matrix-Raum-ID ist der technische Bezeichner eines Chat-Raums in der Matrix-Welt. Sie beginnt immer mit einem Ausrufezeichen und enthält den Server-Namen nach einem Doppelpunkt.
Beispielwert: !room:example.org
Die Raum-ID finden Sie in den Raum-Einstellungen Ihres Prilog-Chats oder erhalten Sie von Ihrer Prilog-Administration. Das Feld akzeptiert auch Platzhalter, falls die Raum-ID je nach Flow-Durchlauf variieren soll, zum Beispiel ${data.raumId}.
Verwenden Sie dieses Feld, wenn Sie einen bestimmten Raum ansprechen möchten, der nicht zu einem Space gehört — etwa einen persönlichen Direktkanal oder einen Raum, der für mehrere Spaces gemeinsam genutzt wird.
Prilog-Space-ID
Die Prilog-Space-ID ist der interne Bezeichner eines Space innerhalb Ihres Prilog-Systems. Jeder Space besitzt einen solchen Bezeichner, der beim Anlegen des Space vergeben wird.
Beispielwert: space-xyz
Wenn Sie dieses Feld angeben, postet Prilog die Nachricht automatisch in den Chat-Raum, der zum jeweiligen Space gehört. Sie müssen in diesem Fall keine Matrix-Raum-ID kennen. Das Feld akzeptiert ebenfalls Platzhalter, zum Beispiel ${data.spaceId}.
Verwenden Sie dieses Feld, wenn Ihre Nachricht in den Gruppen-Chat eines bestimmten Spaces gehört — das ist der häufigste Fall bei schulischen Abläufen, da Spaces in der Regel Klassen, Teams oder Fachgruppen entsprechen.
Nachricht
Das Nachrichtenfeld enthält den Text, der in den Chat geschrieben wird. Es handelt sich um ein Langtextfeld, das mehrzeilige Inhalte unterstützt.
Platzhalter der Form ${data.FELDNAME} werden vor dem Versand aufgelöst. So können Sie den Namen einer Person, eine Klasse, ein Datum oder andere Werte aus dem laufenden Flow direkt in den Nachrichtentext einfließen lassen.
Tipp
Formulieren Sie die Nachricht so, als würden Sie sie selbst tippen. Kurze, direkte Sätze kommen im Chat besser an als lange Absätze. Nutzen Sie Platzhalter gezielt, damit der Empfänger auf einen Blick alle relevanten Informationen sieht.
Variablen / Platzhalter
Alle drei Felder — Matrix-Raum-ID, Prilog-Space-ID und Nachricht — unterstützen Platzhalter. Die Syntax ist einheitlich:
${data.FELDNAME}
Prilog ersetzt diesen Ausdruck beim Ausführen des Schritts durch den tatsächlichen Wert, der unter dem Namen FELDNAME im Flow gespeichert ist. Dieser Wert kann aus einem vorherigen Baustein stammen, zum Beispiel aus einem Webhook-Trigger, einem Formular oder einem Datenbankschritt.
Einige Beispiele:
${data.name}— der Name der Person, die den Flow ausgelöst hat${data.klasse}— die Klasse, auf die sich der Vorgang bezieht${data.spaceId}— die Space-ID, die ein vorheriger Schritt ermittelt hat${data.betreff}— ein Betreff aus einem Antragsformular
Hinweis
Wenn nach dem Ersetzen aller Platzhalter noch ein nicht aufgelöster Ausdruck der Form ${…} im Text übrig bleibt, schlägt der Schritt absichtlich fehl. Prilog sendet in diesem Fall keine unvollständige Nachricht. Das schützt davor, dass Empfänger eine Mitteilung mit sichtbaren Platzhalterbruchstücken erhalten.
Wenn etwas schiefgeht
Die Nachricht wird nicht gesendet, obwohl der Flow läuft
Prüfen Sie zunächst, ob entweder die Matrix-Raum-ID oder die Prilog-Space-ID korrekt eingetragen ist. Beide Felder leer zu lassen führt dazu, dass der Schritt übersprungen oder mit einem Fehler beendet wird. Vergleichen Sie den eingetragenen Wert zeichengenau mit dem tatsächlichen Bezeichner im System.
Fehler: Variable konnte nicht aufgelöst werden
Dieser Fehler tritt auf, wenn im Nachrichtentext oder in einem der ID-Felder ein Platzhalter steht, dessen Wert im Flow nicht vorhanden ist. Prüfen Sie in diesem Fall:
- Ob der Feldname im Platzhalter exakt dem Namen entspricht, den ein vorheriger Baustein gesetzt hat. Groß- und Kleinschreibung spielen dabei eine Rolle.
- Ob der vorherige Baustein, der diesen Wert erzeugen sollte, tatsächlich erfolgreich ausgeführt wurde. Im Flow-Log können Sie den Zustand jedes Schritts einzeln nachvollziehen.
Fehler: Nachricht ist leer
Das Nachrichtenfeld darf nicht leer sein. Wenn das Feld nur aus Platzhaltern besteht und alle Platzhalter leere Werte liefern, entsteht nach dem Ersetzen ein leerer Text. Prilog sendet keine leeren Nachrichten und meldet den Schritt als fehlgeschlagen.
Achtung
Tragen Sie in das Raum-ID-Feld oder das Space-ID-Feld keine geratenen Werte ein. Eine falsche ID führt dazu, dass die Nachricht an einen falschen Raum geht oder gar nicht ankommt, ohne dass dies auf den ersten Blick ersichtlich ist. Lassen Sie sich die korrekte ID von der Prilog-Administration bestätigen.
Beispiel
Szenario: Sekretariat wird bei neuer Online-Anmeldung benachrichtigt
Eine Schule hat einen Flow eingerichtet, der startet, sobald über das Schulwebformular eine neue Anmeldung eingeht (Webhook-Baustein am Anfang). Das Formular übergibt die Felder name und klasse. Im zweiten Schritt soll das Sekretariat sofort eine Nachricht in seinen Space-Chat erhalten.
Einstellungen des Bausteins „Matrix-Nachricht senden":
Prilog-Space-ID:
space-sekretariatMatrix-Raum-ID: (leer gelassen, da die Space-ID ausreicht)
Nachricht:
Neue Anmeldung von ${data.name} (Klasse ${data.klasse}) eingegangen.
Sobald das Formular abgeschickt wird, erscheint im Sekretariats-Space-Chat eine Nachricht wie:
Neue Anmeldung von Maria Müller (Klasse 4b) eingegangen.
Das Sekretariat kann sofort reagieren, ohne erst die Aufgabenliste oder eine E-Mail-Inbox zu öffnen.