# Benachrichtigungen mit Flows

> **Zielgruppe & Rolle**
>
> **Rolle**: Administration | **Voraussetzung**: „Flows verwalten“ für Benachrichtigungen des Mandanten; „Flows
> erstellen“ für eigene; Kanäle richtet ein, wer „E-Mail & Webhooks verwalten“ hat

# Benachrichtigungen mit Flows

Wer bei einem Ereignis informiert wird – „bei jedem kritischen Ticket die Bereitschaft“, „bei jedem Abwesenheitsantrag
die Führungskraft“ –, legen Sie als **Flow** fest: mit einem **Ereignis** als Auslöser und einem **E-Mail**-Schritt.

> [!IMPORTANT] Regeln und Vorlagen gibt es nicht mehr
> Die Seiten **Regeln** und **Vorlagen** unter **Einstellungen › Benachrichtigungen** (heute **E-Mail & Kanäle**) sind entfallen; bestehende Regeln
> wurden nicht übernommen. **Einstellungen › E-Mail & Kanäle** enthält den **Absender**, die **Adressen**, die **Kanäle** und das
> **Zustellprotokoll** und führt mit **Flows** in die Automatisierung. Ihre eigenen Abonnements unter **Meine
> Benachrichtigungen** sind unverändert (siehe [unten](#eigene-abonnements-bleiben)).

## Eine Benachrichtigung einrichten

### Mit einer Vorlage

Der kürzeste Weg: **Automatisierung › Flows › Aus Vorlage**. Diese Vorlagen benachrichtigen bei einem Ereignis; Sie
wählen nur, wer die Nachricht bekommt:

| Vorlage | Ereignis | Wer die Nachricht bekommt |
|---|---|---|
| **Kritische Tickets melden** | Ticket angelegt, mit einer der gewählten Prioritäten | Empfängerinnen und Empfänger |
| **SLA-Warnung weitergeben** | SLA bald fällig | Empfängerinnen und Empfänger |
| **Zustellfehler bei Ticket-Antworten melden** | E-Mail nicht zustellbar | Empfängerinnen und Empfänger |
| **Neuen Lead melden** | Lead angelegt | Empfängerinnen und Empfänger |
| **Abwesenheitsantrag an Vorgesetzte melden** | Abwesenheit beantragt | die vorgesetzte Person, dazu weitere Empfängerinnen und Empfänger |
| **Neue Bewerbung melden** | Bewerbung eingegangen | Empfängerinnen und Empfänger |
| **Lagerbestand unter Mindestmenge melden** | Mindestbestand unterschritten | Empfängerinnen und Empfänger |
| **Fehlerhafte E-Rechnung melden** | E-Rechnung fehlerhaft | Empfängerinnen und Empfänger |
| **Fehlgeschlagene Texterkennung melden** | Texterkennung fehlgeschlagen | Empfängerinnen und Empfänger |

Ohne Auswahl sind Sie selbst die Empfängerin oder der Empfänger. Wählen Sie unter **Besitz** **Mandant**, wenn die
Benachrichtigung für das Unternehmen gilt und nicht an Ihnen hängen soll. Danach öffnet sich der Flow im Builder:
Betreff, Text und Filter passen Sie dort an, dann **Veröffentlichen**.

### Von Hand

1. **Automatisierung › Flows › Flow anlegen**, Besitz **Mandant** mit einem Service-Konto (oder **Persönlich** für eine
   Benachrichtigung nur an Sie).
2. Den manuellen Auslöser durch einen Auslöser **Ereignis** ersetzen und das **Ereignis** wählen, z. B. „Ticket
   angelegt“.
3. Optional einen **Filter** setzen – als Bedingungszeilen, z. B. Priorität **ist gleich** „kritisch“ (siehe
   [Bedingungen](/knowledge/docs/products/portal/user-docs/automatisierung/flows-bauen.md#bedingungen)).
4. Einen Baustein **E-Mail** anhängen: **An**, **Betreff**, **Text**. Betreff und Text lesen Angaben des Ereignisses mit
   `{{ … }}`, z. B. `Kritisches Ticket {{ trigger.data.number }}`.
5. **Testen** (trocken werden E-Mails nicht versendet) und **Veröffentlichen**.

```yaml
schemaVersion: 1
key: kritische-tickets-melden
name: Kritische Tickets melden
triggers:
  - { id: neues_ticket, kind: event, event: desk.item.created, filter: "trigger.data.priority in ['hoch', 'kritisch']" }
nodes:
  info:
    kind: mail
    to: ["person:felix.neumann@example.com"]
    subject: "Kritisches Ticket {{ trigger.data.number }}"
    text: "{{ trigger.data.title ?? '' }}"
edges:
  - neues_ticket -> info
```

Gut zu wissen:

- **Betreff und Text stehen im Flow** – es gibt keine getrennten Nachrichtenvorlagen mehr. Was mehrere Flows gleich
  schreiben sollen, kopieren Sie als YAML von einem Flow in den anderen.
- **Ein Ereignis enthält Nummern, Zustände und Termine**, keine Inhalte wie Beschreibungen, Kommentare oder Texte von
  Bewerbenden. Braucht die Nachricht mehr, liest eine Aktion davor den Datensatz (etwa „Ticket lesen“).
- **Ereignisse zu Datensätzen, die das Service-Konto bzw. die Besitzerin oder der Besitzer nicht sehen darf, starten
  den Flow nicht** – ein vertrauliches Ticket benachrichtigt also nur über einen Flow, der es lesen darf.
- Benachrichtigungen nur für einen **Bereich des Service Desks** oder ein **Entwicklungsprojekt** legen Sie dort an,
  unter **Automationen**: als Sofort-Automation mit E-Mail-Schritt (an Adressen und Kanäle) oder als Flow im
  Hintergrund (siehe [Automationen im Service Desk](/knowledge/docs/products/portal/user-docs/automatisierung/automationen-im-service-desk.md) und
  [Automationen in Entwicklungsprojekten](/knowledge/docs/products/portal/user-docs/automatisierung/automationen-in-entwicklungsprojekten.md)).

## Wen ein Flow erreicht

Im Feld **An** wählen Sie **E-Mail-Adresse**, **Mitarbeitende**, **Gruppe**, **Rolle**, **Vorgesetzte von …**,
**Vorgesetzte der Person aus dem Auslöser**, **Kanal** oder einen **Ausdruck** – die Einzelheiten stehen unter
[Empfängerinnen und Empfänger](/knowledge/docs/products/portal/user-docs/automatisierung/flows-bauen.md#empfaengerinnen-und-empfaenger). Für Benachrichtigungen wichtig:

| Sie möchten | So geht es |
|---|---|
| ein Team informieren | **Gruppe** oder **Rolle** wählen – es zählt, wer beim Senden dazugehört |
| die Führungskraft der betroffenen Person informieren | **Vorgesetzte der Person aus dem Auslöser** mit dem Feld des Ereignisses, z. B. `trigger.data.employeeId` |
| die Personen am Datensatz informieren | **Ausdruck**, z. B. `{{ trigger.data.assignees }}` |
| jemanden außerhalb des Unternehmens informieren | **E-Mail-Adresse** – nur in Mandanten-Flows, höchstens 20 Adressen je Nachricht |
| in einen Teams-Kanal schreiben | **Kanal** und einen Teams-Kanal wählen – alle Mitglieder sehen die Karte |
| ein anderes System benachrichtigen | **Kanal** und einen Webhook-Kanal wählen |

### Teams- und Webhook-Kanäle

Kanäle richten Sie unter **Einstellungen › E-Mail & Kanäle › Kanäle** ein (Teams-Kanäle erscheinen dort, sobald die
Teams-App einem Team oder Gruppenchat hinzugefügt wurde, siehe
[Benachrichtigungen in Teams](/knowledge/docs/products/portal/user-docs/benachrichtigungen-in-teams.md)). Im Flow wählen Sie den Kanal unter **An**; im YAML
steht `channel:ID`.

- Ein **Teams-Kanal** bekommt je Nachricht eine Karte mit Betreff und Text.
- Ein **Webhook-Kanal** bekommt die Nachricht als signiertes JSON: Betreff, Text und der Name des Flows. Angaben des
  Ereignisses, die das empfangende System braucht, schreiben Sie in Betreff oder Text. Das Format beschreibt die
  Entwicklerdokumentation (developers.mbcom.cloud, Leitfaden „Webhooks“).

### Pflichtbenachrichtigung und Versandkanal

Nachrichten aus Flows sind Benachrichtigungen: Jede Person entscheidet unter **Meine Benachrichtigungen** selbst, ob
sie das Thema „Sonstige“ **Sofort**, **Täglich zusammengefasst** oder gar nicht (**Aus**) bekommt und ob
Benachrichtigungen während einer Abwesenheit pausieren.

Soll eine Nachricht **jede** Empfängerin und jeden Empfänger sofort erreichen, schalten Sie am E-Mail-Schritt
**Pflichtbenachrichtigung** ein. Das und der **Versand über E-Mail-Kanal** (ein anderer Kanal als der Standardkanal des
Mandanten) gehen nur in **Mandanten-Flows ohne Bereich oder Projekt**, die Personen mit „Flows verwalten“ pflegen –
nicht in persönlichen Flows, nicht in Flows eines Bereichs oder Projekts und nicht in Sofort-Automationen (siehe
[Versandkanal und Pflichtbenachrichtigung](/knowledge/docs/products/portal/user-docs/automatisierung/flows-bauen.md#versandkanal-und-pflichtbenachrichtigung)).

## Nachvollziehen, was gesendet wurde

- Der **Lauf** des Flows (**Automatisierung › Läufe**) zeigt am E-Mail-Schritt, an wie viele Personen gesendet wurde,
  wie viele davon außerhalb des Unternehmens, wie viele Kanäle und wie viele Einträge niemanden ergaben; eine
  Pflichtbenachrichtigung ist als solche gekennzeichnet.
- Das **Zustellprotokoll** unter **Einstellungen › E-Mail & Kanäle** zeigt jede verschickte Nachricht mit Status und
  Fehlern; fehlgeschlagene lassen sich dort erneut senden.

## Eigene Abonnements bleiben

Was jede Person für sich einstellt, ist unverändert – unter **Einstellungen › Meine Benachrichtigungen**:

- **Themen**: je Thema **Sofort**, **Täglich zusammengefasst** oder **Aus**, dazu die Pause während Abwesenheiten,
- **Benachrichtigungsziele**: E-Mail, eigener Webhook, Teams,
- **Eigene Abonnements**: „Lassen Sie sich über Ereignisse informieren, die Sie selbst interessieren“ – ein Ereignis,
  optionale Bedingungen, Nachricht nur an Sie und nur zu Vorgängen, die Sie sehen dürfen,
- die Push-Mitteilungen.

Ein eigenes Abonnement ist richtig, wenn nur Sie informiert werden möchten und der Standardtext des Ereignisses
genügt. Ein persönlicher Flow kann mehr (eigener Text, Bedingungen über mehrere Schritte, KI-Zusammenfassung), braucht
aber die Berechtigung „Flows erstellen“.

## Früher Regel, jetzt Flow

| Früher (Benachrichtigungsregel) | Jetzt (Flow) |
|---|---|
| Ereignis der Regel | Auslöser **Ereignis** |
| Bedingungen der Regel | **Filter** des Auslösers (Bedingungszeilen oder Ausdruck) |
| Empfänger: Personen, Gruppen, Rollen, Führungskraft, Adressen | Feld **An** des E-Mail-Schritts |
| Kanal der Regel (E-Mail, Teams, Webhook) | E-Mail über den Standardkanal oder **Versand über E-Mail-Kanal**; Teams- und Webhook-Kanäle als **Kanal** unter **An** |
| Vorlage mit Betreff und Text | **Betreff** und **Text** des E-Mail-Schritts |
| Regel als Pflicht markieren | **Pflichtbenachrichtigung** am E-Mail-Schritt |
| Regel testen | **Testen** des Flows (trocken oder live) |
| Regel ein- und ausschalten | Schalter **Eingeschaltet** des Flows |
