Dokumentation › Produkte › ConnectPORTAL › ConnectPORTAL - Benutzerhandbuch › Automatisierung – Flows › Flows bauen
Flow anlegen – leer, aus einer Vorlage oder für einen Bereich oder ein Projekt –, im Builder als Diagramm oder YAML bearbeiten, Auslöser und Bausteine, Empfängerinnen und Empfänger, Bedingungen und Ausdrücke, Testen, Veröffentlichen und Versionen.
Zuletzt geändert am 17.11.2026
Auf dieser Seite
Zielgruppe & Rolle
Rolle: Alle, die Flows bauen | Voraussetzung: Berechtigung „Flows erstellen“; Mandanten-Flows und Live-Tests brauchen „Flows verwalten“. Flows eines Bereichs oder Projekts pflegt, wer den Bereich oder das Projekt verwaltet.
Flow anlegen
Unter Automatisierung › Flows legen Sie mit Flow anlegen einen neuen Flow an:
| Feld | Bedeutung |
|---|---|
| Name | Wie der Flow in Listen und Mails heißt. |
| Schlüssel | Kleinbuchstaben, Ziffern und Bindestriche; leer = aus dem Namen. Unter-Flows rufen den Flow mit dem Schlüssel auf; er ändert sich nicht mehr. |
| Besitz | Persönlich (gehört Ihnen und arbeitet mit Ihren Berechtigungen) oder Mandant (gehört dem Mandanten und arbeitet als Service-Konto). |
| Service-Konto | Nur bei Mandanten-Flows: Der Flow arbeitet mit den Berechtigungen dieses Kontos. |
Der Entwurf beginnt mit einem manuellen Auslöser. Alternativ beginnen Sie mit einer Vorlage (Aus Vorlage, siehe unten) oder beschreiben den Flow mit Mit KI entwerfen in eigenen Worten (siehe Übersicht).
Ein Flow hat die Bereiche Entwurf, Auslöser, Versionen und Läufe.
Aus einer Vorlage
Aus Vorlage öffnet die fertigen Flows für typische Aufgaben, sortiert nach Service Desk, Vertrieb, Personal, Betrieb und Einkauf und Allgemein. Sie wählen eine Vorlage, geben dem Flow einen Namen und füllen die Angaben der Vorlage aus – danach öffnet sich der Entwurf im Builder, wo Sie ihn anpassen, testen und veröffentlichen.
| Vorlage | Was sie tut | Angaben |
|---|---|---|
| Kritische Tickets melden | Fasst jedes neue Ticket mit einer der gewählten Prioritäten per KI zusammen und schickt eine Mail. | Prioritäten, Empfängerinnen und Empfänger |
| SLA-Warnung weitergeben | Mail mit Ticket und Frist, sobald eine Reaktions- oder Lösungszeit zu reißen droht. | Empfängerinnen und Empfänger |
| SLA-Risiken am Morgen | Werktags eine Übersicht der Tickets, die ihre Zeit zu reißen drohen. | Uhrzeit, Empfängerinnen und Empfänger |
| Zustellfehler bei Ticket-Antworten melden | Mail, wenn eine Antwort an Kundschaft nicht zugestellt wurde. | Empfängerinnen und Empfänger |
| Neuen Lead melden | Mail mit Firma, Kontakt, Bewertung und Herkunft bei jedem neuen Lead. | Empfängerinnen und Empfänger |
| Offene Chancen zum Wochenstart | Jeden Montagmorgen eine Übersicht der offenen Verkaufschancen. | Uhrzeit, Empfängerinnen und Empfänger |
| Gewonnene Chance nachbereiten | Mail und eine Aufgabe für die verantwortliche Person, Auftrag und Übergabe vorzubereiten. | Empfängerinnen und Empfänger |
| Neue Mitarbeitende willkommen heißen | Willkommens-Mail an die neue Person und eine Aufgabe mit Checkliste für die Einrichtenden. | Wer richtet ein? |
| Abwesenheitsantrag an Vorgesetzte melden | Mail an die vorgesetzte Person bei jedem neuen Abwesenheitsantrag. | Weitere Empfängerinnen und Empfänger |
| Neue Bewerbung melden | Mail mit Stelle und Bewerbungsnummer. | Empfängerinnen und Empfänger |
| Lagerbestand unter Mindestmenge melden | Mail mit Bestand, Mindestmenge und bereits Bestelltem. | Empfängerinnen und Empfänger |
| Fehlerhafte E-Rechnung melden | Mail mit Rechnungsnummer, Fehlerzahl und den verletzten Regeln. | Empfängerinnen und Empfänger |
| Fehlgeschlagene Texterkennung melden | Mail mit Dokument und Grund. | Empfängerinnen und Empfänger |
| Alarm von außen als Ticket anlegen | Ein System ruft die Adresse des Flows auf, daraus entsteht ein Ticket. | Bereich |
| Antrag genehmigen lassen | Ein Antrag geht als Aufgabe mit Frist und Erinnerung an die Entscheidenden, das Ergebnis kommt per Mail. | Wer entscheidet? |
Gut zu wissen:
- Angaben statt Suchen im Flow: Empfängerinnen und Empfänger, Prioritäten, den Bereich des Service Desks oder die Uhrzeit einer Übersicht wählen Sie beim Anlegen aus Listen Ihres Mandanten. Ohne Auswahl gilt der Vorschlag der Vorlage; bei Empfängerinnen und Empfängern sind das Sie selbst (Ich).
- Eine Vorlage mit dem Hinweis „Nicht verfügbar – ein benötigtes Modul ist für diesen Mandanten nicht erreichbar.“ bleibt in der Liste, lässt sich aber nicht wählen.
- Die Vorlage ist nur der Anfang: Der Flow gehört danach Ihnen bzw. dem Mandanten und ändert sich nicht, wenn die Vorlage später angepasst wird.
Vorlagen für Entwicklungsprojekte und für Bereiche des Service Desks stehen nicht hier, sondern dort, wo sie gelten: als Fertige Automationen in den Einstellungen des Projekts bzw. des Bereichs (siehe Automationen in Entwicklungsprojekten und Automationen im Service Desk).
Flows eines Bereichs oder Projekts
Ein Mandanten-Flow kann zu einem Bereich des Service Desks oder zu einem Entwicklungsprojekt gehören. Solche Flows legen Sie nicht unter Automatisierung › Flows an, sondern in den Automationen des Bereichs oder Projekts – mit Automation hinzufügen und der Ausführung Im Hintergrund, aus einer fertigen Automation oder mit Im Hintergrund ausführen aus einer Sofort-Automation. Der Flow zeigt unter Gehört zu, wohin er gehört; das lässt sich später nicht ändern.
| Flow ohne Zugehörigkeit | Flow eines Bereichs oder Projekts | |
|---|---|---|
| Wo er steht | Automatisierung › Flows | in den Automationen des Bereichs bzw. Projekts, mit dem Kennzeichen Im Hintergrund |
| Handelt mit | eigenen Berechtigungen (persönlich) oder einem Service-Konto (Mandant) | immer einem Service-Konto |
| Wer ihn sieht | siehe Übersicht | wer den Bereich bzw. das Projekt sieht und eine Berechtigung der Automatisierung hat |
| Wer ihn ändert, veröffentlicht, startet und seine Läufe abbricht | Besitzerin oder Besitzer bzw. Personen mit „Flows verwalten“ | wer den Bereich bzw. das Projekt verwaltet und „Flows erstellen“ oder „Flows verwalten“ hat |
| Seine Läufe | unter Automatisierung › Läufe | im Bereich Läufe des Flows (in der Liste: Läufe anzeigen) |
„Verwalten“ heißt im Service Desk: Personen mit „Desk verwalten“ und die Mitglieder des Bereichs mit der Rolle Verwalten; in der Entwicklung: Mitglieder des Projekts mit der Rolle Pflege oder Verwaltung und alle mit „Entwicklungsprojekte verwalten“. Allein mit „Flows verwalten“ lässt sich ein solcher Flow nicht ändern – es entscheidet der Bereich bzw. das Projekt. Wie bei jedem Mandanten-Flow prüft das Veröffentlichen die Berechtigungen des Service-Kontos; ein Live-Test braucht weiterhin „Flows verwalten“.
Hinweis
Antwortet der Service Desk oder die Entwicklung gerade nicht, zeigt das Portal bei einem solchen Flow „Das Modul, zu dem dieser Bereich gehört, antwortet gerade nicht. Bitte versuchen Sie es später noch einmal.“ – in dieser Zeit wird nichts angezeigt oder geändert.
Der Builder
Im Bereich Entwurf bearbeiten Sie den Flow. Unter Ansicht wählen Sie Diagramm, YAML oder Beides nebeneinander – beide zeigen denselben Entwurf, eine Änderung auf der einen Seite erscheint sofort auf der anderen.
- Bausteine (links): Auslöser und Knoten, gruppiert nach Auslöser, Ablauf, Menschen, Nachrichten und KI, dazu die Aktionen der Module. Ein Klick oder Ziehen fügt einen Baustein hinzu; Bausteine suchen findet z. B. „Ticket“.
- Diagramm (Mitte): Knoten verbinden Sie, indem Sie einen Ausgang auf den nächsten Knoten ziehen. Automatisch anordnen und Einpassen räumen auf; Rückgängig und Wiederholen gelten für jede Änderung.
- Eigenschaften (rechts): die Felder des gewählten Knotens oder Auslösers. Die ID eines Knotens (Kleinbuchstaben, Ziffern und Unterstriche) dürfen Sie umbenennen – Verbindungen und Verweise werden angepasst.
Auf kleinen Bildschirmen zeigt der Builder nur das YAML.
Der Entwurf speichert sich selbst („Gespeichert …“ oben). Wurde er zwischenzeitlich anderswo gespeichert, meldet das Portal das und bietet Neu laden an – kopieren Sie vorher, was Sie behalten möchten.
Automatische Prüfung
Während Sie arbeiten, prüft das Portal den Entwurf und listet die Befunde: Fehler und Warnungen, mit Zeile und Spalte im YAML; ein fehlerhafter Knoten ist im Diagramm markiert. Fehler verhindern das Veröffentlichen, Warnungen nicht. Enthält das YAML Syntaxfehler, zeigt das Diagramm den letzten gültigen Stand und ist gesperrt, bis das YAML wieder stimmt.
Auslöser
| Art | Startet den Flow | Einstellungen |
|---|---|---|
| Manuell | von Hand (Manuell starten), über den Assistenten oder als Unter-Flow | Eingabe (JSON) beim Start; welche Felder erwartet werden, beschreibt der Flow unter inputs |
| Ereignis | wenn in einem Modul etwas passiert, z. B. ein Ticket angelegt wird | Ereignis, optional Filter (startet nur, wenn wahr; als Bedingungszeilen oder Ausdruck) und Auch Änderungen durch Automatisierungen |
| Zeitplan | zu festen Zeiten | Zeitplan (Cron), fünf Felder, z. B. 0 7 * * 1 (montags 7 Uhr); Zeitzone, Standard Europe/Berlin; Verpasste Starts: Verpasste auslassen oder Einen nachholen |
| Webhook | wenn ein anderes System eine Anfrage an seine Adresse schickt | Prüfung: Token oder Token und HMAC-Signatur |
Ein Ereignis enthält nur die Felder, die sein Modul dafür beschreibt; Details holt eine Aktion (etwa „Ticket lesen“). Ereignisse zu Datensätzen, die die Besitzerin oder der Besitzer des Flows nicht sehen darf, starten den Flow nicht.
Webhooks
Beim Veröffentlichen eines Flows mit neuem Webhook zeigt das Portal Adresse, Token und – bei HMAC – das Signaturgeheimnis.
Wird nur jetzt angezeigt
Kopieren Sie Adresse, Token und Geheimnis sofort in das sendende System. Nach dem Schließen sind sie nicht mehr abrufbar. Im Bereich Auslöser erzeugt Neue Zugangsdaten neue – die bisherigen gelten dann sofort nicht mehr.
Der Webhook nimmt JSON entgegen (höchstens 1 MiB). Mit HMAC signiert der Absender den Body mit HMAC-SHA256 und sendet
ihn im Kopf X-Flows-Signature als sha256=…. Ein mitgesendeter Idempotency-Key verhindert, dass dieselbe Anfrage
den Flow zweimal startet.
Bausteine
| Baustein | Was er tut | Ausgänge |
|---|---|---|
| Aktion | Ruft eine Aktion eines Moduls auf, z. B. Ticket lesen, Verkaufschancen laden, Wissensseite anlegen | weiter, Fehler |
| Bedingung | Weiter über wahr oder falsch (siehe Bedingungen) | wahr, falsch |
| Verzweigung | Weiter über den ersten passenden Fall | je Fall, sonst |
| Werte setzen | Werte berechnen, Variablen setzen | weiter |
| Warten | Eine Dauer (z. B. 2h, 3d) oder bis zu einem Zeitpunkt warten |
weiter |
| Aufgabe für Menschen | Freigabe oder Formular an Personen, mit Frist und Eskalation (siehe Läufe und Aufgaben) | freigegeben, abgelehnt bzw. ausgefüllt; Frist abgelaufen |
| Parallel | Zweige gleichzeitig starten | je Zweig |
| Zusammenführen | Auf die Zweige eines Parallel-Knotens warten – Alle, Der erste oder eine Anzahl | weiter |
| Für jedes Element | Den Rumpf einmal je Element einer Liste ausführen, auf Wunsch mehrere gleichzeitig | je Element, fertig |
| Unter-Flow | Einen anderen Flow (über seinen Schlüssel) ausführen und auf ihn warten | weiter, Fehler |
| Nachricht an Personen, Gruppen, Rollen, Vorgesetzte, Adressen und Kanäle (Betreff höchstens 200, Text höchstens 4000 Zeichen; siehe Empfängerinnen und Empfänger) | weiter, Fehler | |
| KI-Schritt | Einordnen (in vorgegebene Klassen), Auslesen (Felder aus Text), Zusammenfassen, Text schreiben; Modellstufe von Schnell bis Stark | weiter, Fehler |
| Ende | Den Lauf beenden, mit Ergebnis (Erfolgreich oder Fehlgeschlagen) und Meldung | – |
Gut zu wissen:
- Fehler: Knoten mit Wirkung haben unter Zeitlimit und Wiederholung ein Zeitlimit (Standard 30 Sekunden) und auf Wunsch Wiederholungen bei vorübergehenden Fehlern. Hängt am Ausgang Fehler ein Knoten, geht der Lauf dort weiter; sonst schlägt er fehl.
- Unter-Flows: Ein persönlicher Flow ruft nur Ihre eigenen persönlichen Flows auf, ein Mandanten-Flow nur Mandanten-Flows; höchstens fünf Ebenen tief. Ein Flow eines Bereichs oder Projekts ruft Mandanten-Flows ohne Zugehörigkeit und die Flows desselben Bereichs bzw. Projekts auf – umgekehrt ruft ein Mandanten-Flow ohne Zugehörigkeit keinen Flow eines Bereichs oder Projekts auf.
- Ein Flow hat keine Rückwärtskanten – Wiederholungen bauen Sie mit Für jedes Element.
Empfängerinnen und Empfänger
Im Feld An einer E-Mail und im Feld Zuständig einer Aufgabe für Menschen wählen Sie aus, wen der Flow erreicht. Die Auswahl zeigt Namen statt Kennungen; im YAML steht die Schreibweise der rechten Spalte.
| Auswahl | Erreicht | Im YAML |
|---|---|---|
| E-Mail-Adresse | eine Adresse – in Mandanten-Flows auch außerhalb des Unternehmens | person:E-Mail-Adresse oder die Adresse allein |
| Mitarbeitende | eine Person aus der Personalverwaltung | employee:ID |
| Gruppe | alle Mitglieder einer Gruppe | group:ID |
| Rolle | alle Personen mit einer Rolle | role:ID |
| Vorgesetzte von … | die direkte Führungskraft einer bestimmten Person | manager:E-Mail-Adresse oder ID |
| Vorgesetzte der Person aus dem Auslöser | die Führungskraft der Person, die ein Ausdruck ergibt – etwa ein Feld des Auslösers | z. B. manager:{{ trigger.data.employeeId }} |
| Kanal (nur E-Mail) | einen Teams- oder Webhook-Kanal aus Einstellungen › E-Mail & Kanäle › Kanäle | channel:ID |
| Ausdruck | was der Ausdruck ergibt – eine dieser Angaben oder eine Liste davon | {{ … }} |
Wer eine Liste nicht lesen darf (Mitarbeitende, Rollen), trägt die ID ein; das Portal weist darauf hin.
Was dabei gilt:
- Wer erreicht wird: Gruppen, Rollen und Vorgesetzte löst der Flow beim Senden über die Personalverwaltung auf – es zählt, wer in diesem Moment dazugehört und aktiv ist. Eine Angabe, die niemanden ergibt (jemand hat das Unternehmen verlassen, eine leere Gruppe), steht im Lauf als „Eintrag ohne Empfänger“; die übrigen bekommen die Nachricht.
- Adressen außerhalb des Unternehmens erreicht nur ein Mandanten-Flow (auch der eines Bereichs oder Projekts), höchstens 20 je Nachricht. Ein persönlicher Flow schreibt nur an Mitarbeitende – der Builder zeigt dazu „Ein persönlicher Flow schreibt nur an Mitarbeitende – Adressen außerhalb des Unternehmens werden übersprungen.“ Zuständige einer Aufgabe sind in jedem Flow Mitarbeitende.
- Wie viele: höchstens 50 Einträge je Nachricht; eine Gruppe oder Rolle zählt als ein Eintrag. Ergeben sie mehr als 50 Personen, verteilt der Flow sie auf mehrere Nachrichten; mehr als 500 Personen sind ein Fehler des Schritts.
- Kanäle: Ein Teams-Kanal bekommt eine Karte, ein Webhook-Kanal die Nachricht als JSON – je Kanal eine, unabhängig von den Personen.
- Im Lauf steht bei einer Nachricht, wie viele Personen erreicht wurden, wie viele davon außerhalb des Unternehmens, wie viele Kanäle und wie viele Einträge ohne Empfänger.
Versandkanal und Pflichtbenachrichtigung
Zwei Einstellungen der E-Mail gibt es nur in Mandanten-Flows ohne Bereich oder Projekt, also in Flows, die Personen mit „Flows verwalten“ pflegen:
| Feld | Wirkung |
|---|---|
| Versand über E-Mail-Kanal | Die Nachricht geht über den gewählten E-Mail-Kanal statt über den Standardkanal des Mandanten. |
| Pflichtbenachrichtigung | Empfängerinnen und Empfänger können diese Nachricht nicht abbestellen: Sie kommt sofort, auch wenn jemand das Thema ausgeschaltet hat, Nachrichten täglich zusammenfasst oder Benachrichtigungen während einer Abwesenheit pausiert. |
Ohne Pflichtbenachrichtigung gelten für Nachrichten aus Flows die persönlichen Einstellungen unter Meine Benachrichtigungen (Thema „Sonstige“). In persönlichen Flows, in Flows eines Bereichs oder Projekts und in Sofort-Automationen stehen beide Einstellungen nicht zur Verfügung. Ist eine davon dort gesetzt – etwa im eingefügten YAML –, meldet die Prüfung den Fehler am Feld, und der Flow lässt sich nicht veröffentlichen.
Bedingungen
Den Filter eines Ereignis- oder Webhook-Auslösers und die Bedingung eines Bedingungs-Bausteins erfassen Sie als Bedingungszeilen: je Zeile ein Wert (aus der Liste der lesbaren Werte oder als Pfad), ein Vergleich und ein Vergleichswert. Mit Bedingung fügen Sie eine Zeile hinzu; unter Verknüpfung wählen Sie Alle treffen zu (und) oder Mindestens eine (oder).
| Vergleich | Für |
|---|---|
| ist gleich, ist ungleich | Texte, Zahlen, wahr/falsch |
| größer als, mindestens, kleiner als, höchstens | Zahlen und Zeitpunkte |
| enthält, beginnt mit, endet mit | Texte |
| ist leer, ist nicht leer | Felder, die fehlen können |
| enthält den Eintrag, hat Einträge, hat keine Einträge | Listen, z. B. Labels |
Als Ausdruck bearbeiten zeigt dieselbe Bedingung als Ausdruck, Als Bedingungen bearbeiten wechselt zurück. Was nicht in Zeilen passt – „und“ und „oder“ gemischt, Klammern, Funktionen –, bleibt ein Ausdruck („Dieser Ausdruck passt nicht in Zeilen …“).
Ausdrücke
Felder lesen Daten aus dem Lauf mit {{ … }}, z. B. Kritisches Ticket {{ trigger.data.number }}. Bedingungen,
Filter und Listen sind reine Ausdrücke ohne Klammern, z. B. trigger.data.betrag < 500. Viele Felder der
Eigenschaften lassen sich wahlweise als Ausdruck schreiben.
| Name | Inhalt |
|---|---|
trigger.data |
Die Daten des Auslösers: Felder des Ereignisses, die Eingabe eines manuellen Starts oder der Body des Webhooks |
nodes.<id>.output |
Die Ausgabe eines vorherigen Knotens, z. B. nodes.ticket.output.title |
vars |
Variablen aus Werte setzen |
item, loop |
Das aktuelle Element in Für jedes Element |
Ein Ausdruck, der sich nicht auswerten lässt, ist ein Fehler des Knotens – er wird nie stillschweigend „falsch“. Mit
?? geben Sie einen Ersatzwert an: {{ trigger.data.title ?? '' }}.
YAML
Jeder Flow ist ein YAML-Dokument; der Builder schreibt es, Sie können es aber auch direkt bearbeiten, kopieren oder in einen anderen Flow einfügen. Ein Beispiel:
schemaVersion: 1
key: offene-chancen-montag
name: Offene Chancen zum Wochenstart
triggers:
- { id: montags, kind: schedule, cron: "0 8 * * 1", timezone: Europe/Berlin }
nodes:
offene:
kind: action
name: Offene Chancen laden
action: crm.opportunity.list
params: { phase: open, limit: 200 }
gibt_es_chancen:
kind: if
condition: "len(nodes.offene.output.items) > 0"
uebersicht:
kind: mail
to: ["person:felix.neumann@example.com"]
subject: "{{ len(nodes.offene.output.items) }} offene Verkaufschancen"
text: "Guten Morgen, im CRM sind {{ len(nodes.offene.output.items) }} Verkaufschancen offen."
edges:
- montags -> offene
- offene -> gibt_es_chancen
- gibt_es_chancen.true -> uebersicht
edges verbinden Knoten (von -> nach, bei mehreren Ausgängen von.ausgang -> nach). Die Positionen im Diagramm
stehen im Block layout:; er ändert am Verhalten nichts.
Testen
Testen führt den gespeicherten Entwurf aus, ohne ihn zu veröffentlichen. Unter Startet als wählen Sie den Auslöser, unter Daten (trigger.data, JSON) die Startdaten – Beispieldaten einsetzen füllt sie aus dem Schema des Ereignisses oder den Eingaben des Flows.
- Trocken testen (Standard): Lesende Aktionen und KI-Schritte laufen wirklich; schreibende Aktionen werden nur simuliert, E-Mails werden nicht versendet, Aufgaben bekommen nur Sie. Testläufe werden nicht abgerechnet.
- Live testen (nur mit „Flows verwalten“): Schreibende Aktionen ändern echte Daten, E-Mails gehen raus und Aufgaben werden den Zuständigen gestellt.
Der Testlauf erscheint über dem Diagramm: Jeder Knoten zeigt seinen Zustand; Lauf öffnen zeigt die Einzelheiten. In der Liste der Läufe ist er als Testlauf (trocken) bzw. Testlauf (live) markiert.
Veröffentlichen
Veröffentlichen speichert den Entwurf als nächste Version, schaltet den Flow ein und macht seine Auslöser aktiv. Vorher zeigt das Portal die Benötigten Berechtigungen (je Zeile genügt eine); optional halten Sie eine Notiz zur Version fest. Veröffentlichen geht nur, wenn der Entwurf keine Fehler hat und sich von der veröffentlichten Version unterscheidet.
- Laufende Läufe bleiben bei der Version, mit der sie gestartet sind; neue Läufe nehmen die neue.
- Der Schalter Eingeschaltet hält einen Flow an, ohne ihn zu ändern; ein pausierter Flow startet erst nach Wieder einschalten.
- Archivieren entfernt die Auslöser; laufende Läufe laufen weiter. Archivierte Flows stehen unter Archiviert.
Versionen
Im Bereich Versionen stehen alle veröffentlichten Versionen mit Notiz, Person und Zeitpunkt; Aktuell markiert die laufende. Eine Version lässt sich ansehen und mit In den Entwurf übernehmen als neuer Entwurf zurückholen – veröffentlicht wird erst, wenn Sie veröffentlichen.
Hat das geholfen?
https://app.mbcom.cloud/knowledge/docs/products/portal/user-docs/automatisierung/flows-bauen