OrchIQ Dokumentation — Benutzerhandbuch & Node-Referenz

🚀

Wir befinden uns in der Beta-Phase

Während der Beta sind alle Features kostenlos verfügbar. Der Free-Plan hat temporär die Limits des Flow-Plans: 5 Workflows · 1.000 Ausführungen/Monat. Kostenpflichtige Pläne (Flow, Pipeline, Orchestra) werden nach der Beta-Phase freigeschaltet.

🚀 Schnellstart

In wenigen Minuten zum ersten laufenden Workflow:

Account anlegen
Registriere dich unter /register. Nach der E-Mail-Bestätigung bist du direkt im Dashboard.
Credentials hinterlegen (optional)
Gehe zu Credentials in der Seitenleiste und füge API-Keys oder OAuth-Tokens für externe Dienste hinzu.
Neuen Workflow erstellen
Klicke auf Neuer Workflow, vergib einen Namen und öffne den visuellen Editor.
Nodes hinzufügen
Ziehe Nodes aus der Node-Palette auf die Canvas. Verbinde Ausgänge mit Eingängen durch Kanten.
Workflow testen & ausführen
Klicke auf Ausführen. Im Execution-Panel siehst du den Live-Status jedes Nodes in Echtzeit.
Veröffentlichen
Sobald alles funktioniert, veröffentliche den Workflow. Nur veröffentlichte Workflows können über Webhooks oder Cron ausgelöst werden.

Tipp Nutze den Trigger-Node mit vordefinierten Testdaten, um Workflows während der Entwicklung schnell manuell zu starten.

📖 Konzepte

🗺️

Workflow

Ein gerichteter azyklischer Graph (DAG) aus Nodes und Kanten. Hat Status Draft oder Published.

🔲

Node

Eine Verarbeitungseinheit mit Eingängen, Ausgängen und einer Konfiguration. Jeder Node hat einen eindeutigen Typ.

➡️

Kante (Edge)

Verbindet den Ausgang eines Nodes mit dem Eingang eines anderen. Bestimmt den Datenfluss.

📦

Execution

Ein einzelner Lauf eines Workflows. Enthält Status, Start-/Endzeit, Eingabedaten und Node-Ergebnisse.

🔑

Credential

Verschlüsselt gespeicherter API-Key, OAuth-Token oder Passwort. Wird in Nodes per ID referenziert.

💾

Variable

Daten, die zwischen Nodes fließen. Jeder Node schreibt sein Ergebnis in den gemeinsamen Execution-Context.

Ausführungsmodell

OrchIQ baut aus dem Workflow einen DAG und ermittelt topologische Wellen. Alle Nodes einer Welle werden parallel ausgeführt. Erst wenn alle Nodes einer Welle abgeschlossen sind, startet die nächste.

DAG-Executor Nodes, die nicht voneinander abhängen, laufen automatisch parallel. Du musst keine Parallelität manuell konfigurieren.

Datenpfade

Node-Ausgaben sind über Punktnotation zugänglich: nodeName.outputField. In Feldern mit Variablen-Support kannst du ${nodeName.field} verwenden.

Beispiel: Ein HTTP-Node namens fetch gibt ${fetch.body.items} zurück, das ein Loop-Node iterieren kann.

⚙️ Workflows erstellen

Editor-Oberfläche

Canvas — Ziehe Nodes, pan mit Mausrad/Trackpad, zoom mit Ctrl+Scroll
Node-Palette — Linke Seitenleiste, alle verfügbaren Node-Typen nach Kategorie
Node-Konfiguration — Klicke auf einen Node, um seine Einstellungen rechts zu öffnen
Mini-Map — Rechts unten für große Workflows

Nodes verbinden

Ziehe vom orangen Ausgangs-Handle eines Nodes auf den Eingangs-Handle eines anderen. Eine Kante wird erstellt. Kanten können auch gelöscht werden (Klick → Entf).

Bedingungen (Branches)

Der Condition-Node hat zwei Ausgänge: true und false. Verbinde jeden Ausgang mit einem anderen Zweig des Workflows.

Versionierung

Jeder gespeicherte Stand wird als Version angelegt. Im Versions-Panel kannst du ältere Stände einsehen und wiederherstellen (Rollback).

Achtung Nur als Published markierte Workflows reagieren auf eingehende Webhooks oder geplante Trigger. Drafts können nur manuell gestartet werden.

📊 Ausführen & Monitoring

Execution-Dashboard

Unter Ausführungen findest du alle vergangenen und laufenden Executions mit Status, Dauer und Zeitstempel.

Echtzeit-Status

Während eine Execution läuft, werden Node-Statusänderungen (pending → running → success/failed) per Socket.IO live übertragen und im Editor direkt auf den Nodes angezeigt.

Node-Ergebnisse

Klicke in der Execution-Detailansicht auf einen beliebigen Node, um dessen Eingaben, Ausgaben und Logs zu sehen.

Fehlerbehandlung & Retry

Schlägt ein Node fehl, stoppt die Execution standardmäßig und markiert alle nachfolgenden Nodes als übersprungen.
Mit dem Error Handler-Node kannst du Fehler abfangen und gezielt darauf reagieren.
Executions können manuell erneut ausgelöst werden (gleiche Eingabedaten).

Leerer Output (NO_OUTPUT)

Standardmäßig erwartet OrchIQ, dass jeder Node einen nicht-leeren Output zurückgibt. Gibt ein Node null oder ein leeres Objekt zurück, schlägt die Execution mit Fehlercode NO_OUTPUT fehl.

Ausgenommen sind Nodes, die konstruktionsbedingt keinen Ausgabewert haben: condition, loop, trigger, webhook, timer, email-trigger, error-handler.

allowEmptyOutput Wenn ein Node absichtlich keinen Wert zurückgeben soll (z. B. ein Logging-Node oder ein Webhook-Respond am Ende), aktiviere in den Node-Einstellungen das Feld Allow empty output. Die nachfolgenden Nodes erhalten dann ein leeres Objekt als Eingabe und die Execution läuft normal weiter.

🔑 Credentials

Credentials werden verschlüsselt in der Datenbank gespeichert und nie in Klartext im Frontend angezeigt. Jeder Credential-Eintrag hat einen Typ (z. B. API Key, OAuth2, SMTP) und einen Namen.

Credential-Typen

Typ	Verwendung
`api_key`	OpenAI, Anthropic, generische REST-APIs
`bearer-token`	HTTP-APIs mit Bearer-Token-Authentifizierung
`basic-auth`	HTTP-APIs mit Basic Auth (User + Passwort)
`http-header`	Beliebige HTTP-Header (z. B. `X-API-Key`)
`oauth2`	Gmail, Google Calendar, Google Drive, Google Sheets, Google Docs, Outlook
`smtp`	SMTP-Mailserver (Host, Port, User, Passwort)
`imap`	IMAP-Postfach (Host, Port, User, Passwort)
`aws`	AWS S3 (Access Key ID + Secret)
`ssh`	SSH (Host, User, Passwort oder Private Key)
`ollama`	Lokale Ollama-Instanz (URL)
`postgres`	PostgreSQL-Verbindung (Host, Port, Datenbank, Benutzername, Passwort)
`mongodb`	MongoDB-Verbindung (Host, Port, Datenbank, Benutzername, Passwort, Auth-DB)
`mysql`	MySQL / MariaDB-Verbindung (Host, Port, Datenbank, Benutzername, Passwort)
`redis`	Redis-Verbindung (URL, Passwort, DB-Index)
`qdrant`	Qdrant Vektordatenbank (API-Key)

💾 Variablen & Datenpfade

Der Execution-Context ist ein JSON-Objekt. Jeder Node schreibt sein Ergebnis unter seinem Node-Namen (lowercase, Leerzeichen durch _ ersetzt).

Zugriff auf Ausgaben

Syntax in Konfigurationsfeldern: ${nodeId.path.to.value}

Beispiel	Bedeutung
`${trigger.data.email}`	Feld email aus den Trigger-Eingabedaten
`${http_fetch.body.items[0].id}`	Erstes Element der Items-Liste aus HTTP-Response
`${ai_agent.result}`	Text-Ausgabe des AI-Agent-Nodes
`${loop.item}`	Aktuelles Element im Loop (Branch `loop`)
`${loop.results}`	Array aller Iterations-Ergebnisse (Branch `done`)

Map Variables

Mit dem Map Variables-Node kannst du Werte umbenennen, kombinieren oder neu strukturieren, ohne JavaScript schreiben zu müssen.

Globale Variablen

Über den "Vars"-Button im Editor-Header definierst du Workflow-weite Variablen, die in jedem Node verfügbar sind.

Feld	Beschreibung
Name	Bezeichner der Variable, z. B. `apiBaseUrl`
Standardwert	Optionaler Default-Wert (JSON oder String). Typ wird automatisch erkannt.
Beschreibung	Optionale Dokumentation für das Team

Referenzierung: ${variableName} in jedem Konfigurationsfeld. Autocomplete zeigt verfügbare Variablen beim Tippen.

Überschreiben: Beim manuellen Ausführen können Variablen per JSON überschrieben werden — z. B. für Staging- vs. Produktions-URLs.

System-Variablen stehen automatisch zur Verfügung:
${currentDate}, ${currentTime}, ${currentTimestamp}, ${currentISODate}, ${currentYear}, ${currentMonth}, ${currentDay}, ${currentDayOfWeek}

📋 Data Storage

Data Storage ermöglicht das Anlegen und Verwalten strukturierter Datentabellen direkt im System. Verfügbar ab dem Pipeline-Plan.

Anwendungsfälle

Serverlisten: Hostnamen, IPs und SSH-Credentials als Referenz — per Loop durchiterieren und remote Befehle ausführen
Kontaktlisten: E-Mail-Adressen und Namen für Benachrichtigungs-Workflows
Konfigurationen: Umgebungsspezifische Einstellungen für verschiedene Workflows

Spaltentypen

string — Text
number — Zahlenwert
boolean — Ja/Nein
credential — Referenz auf ein Credential (nur die ID, nie das Secret)

Credential-Referenzen

Spalten vom Typ credential speichern nur die Credential-ID. Bei der Workflow-Ausführung wird die ID als normales Feld ausgegeben. Die Ziel-Node (z.B. SSH) empfängt die ID per ${item.sshCredential} in ihrer credentialId-Config — der Executor löst die Credential-ID auf und entschlüsselt intern. Passwörter und Keys erscheinen nie in Outputs oder Logs.

Gelöschte Credentials: Wird ein referenziertes Credential gelöscht, schlägt die Ziel-Node mit dem Fehler „Credential nicht gefunden" fehl. Es findet kein Cascade-Delete statt.

Workflow-Nodes

Drei Nodes stehen für die Nutzung in Workflows bereit:

Data Storage: Lesen — Einträge laden, optional filtern und limitieren
Data Storage: Schreiben — Einträge erstellen oder per Upsert aktualisieren
Data Storage: Löschen — Einträge nach Feld-Abgleich oder alle entfernen

Details zu Konfiguration und Output: siehe Node-Referenz.

🔗 Git-Integration

Synchronisiere Workflow-Definitionen mit GitHub oder GitLab — für Backup, Versionskontrolle und Team-Kollaboration.

Einrichtung

Öffne den Git-Dialog im Workflow-Editor (Git-Icon im Header). Dort konfigurierst du:

Feld	Beschreibung
Git-Credential	Auswahl oder Neuanlage eines Credentials mit Repository-URL und Access Token (GitHub PAT oder GitLab Token)
Branch	Ziel-Branch (Standard: `main`). Verfügbare Branches können per Klick geladen werden.
Dateipfad	Pfad zur JSON-Datei im Repository, z. B. `workflows/mein-workflow.json`

Funktionen

Aktion	Beschreibung
Push	Aktuelle Workflow-Definition als JSON committen und auf den gewählten Branch pushen. Optionale Commit-Message.
Pull	Workflow-Definition aus dem Repository laden. Erstellt automatisch eine neue Draft-Version — veröffentlichte Versionen werden nicht überschrieben.
Branches laden	Verfügbare Branches vom Repository abrufen und im Dropdown anzeigen.

Unterstützte Anbieter: GitHub (github.com) und GitLab (gitlab.com oder Self-Hosted). Der Anbieter wird automatisch aus der Repository-URL erkannt.

🔐 Zwei-Faktor-Authentifizierung (2FA)

Schütze dein Konto mit einem zusätzlichen Sicherheitsfaktor. OrchIQ unterstützt TOTP-basierte 2FA mit jeder gängigen Authenticator-App (Google Authenticator, Authy, 1Password, Bitwarden etc.).

2FA aktivieren

Öffne Profil → Sicherheit
Klicke „2FA aktivieren"
Scanne den angezeigten QR-Code mit deiner Authenticator-App (oder gib den manuellen Key ein)
Gib den 6-stelligen Bestätigungscode aus der App ein
Speichere die angezeigten Backup-Codes sicher ab — jeder Code ist nur einmal verwendbar

Login mit 2FA

Nach der Aktivierung wird bei jedem Login nach Email und Passwort ein zweiter Schritt angezeigt: Gib den aktuellen 6-stelligen Code aus deiner Authenticator-App ein. Alternativ kannst du einen deiner Backup-Codes verwenden.

Backup-Codes

Bei der Einrichtung erhältst du 10 einmalige Backup-Codes. Diese dienen als Fallback, falls du keinen Zugriff auf deine Authenticator-App hast. Jeder Code kann nur einmal verwendet werden.

Wichtig: Bewahre deine Backup-Codes an einem sicheren Ort auf. Ohne Authenticator-App und ohne Backup-Codes ist kein Login möglich.

2FA deaktivieren

Unter Profil → Sicherheit → „2FA deaktivieren" kannst du die Zwei-Faktor-Authentifizierung mit deinem Passwort wieder abschalten.

🔌 Node-Referenz

Vollständige Beschreibung aller 57+ Node-Typen mit Einstellungen, Eingaben und Ausgaben.

🤖

KI & Intelligenz

OpenAI, Anthropic Claude, Ollama — Completions, Chat, Tool-Calling

🤖

AI Agent

Typ: ai-agent

Sendet einen Prompt an ein KI-Modell und gibt das Ergebnis zurück. Unterstützt strukturierte JSON-Ausgabe (inkl. JSON-Schema für OpenAI, Anthropic und Ollama v0.5+), Temperature-Kontrolle und verschiedene Anbieter. Tool-Calling und Credentials werden im „Tools"-Tab konfiguriert.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`provider`	select	Ja	`openai` · `anthropic` · `openrouter` · `ollama` · `generic`
`credentialId`	credential	Ja	Provider-spezifischer API-Key (nicht bei ollama). Über OpenRouter stehen 200+ Modelle verschiedener Anbieter zur Verfügung.
`model`	string	Ja	Modellname, z. B. `gpt-4o`, `claude-sonnet-4-6`, `meta-llama/llama-3-70b-instruct`
`ollamaUrl`	string	Opt	Ollama-Basis-URL, z. B. `http://localhost:11434`
`systemMessage`	textarea	Opt	System-Prompt; setzt Verhalten und Kontext
`prompt`	textarea	Ja	User-Prompt; unterstützt Variablen `${nodeId.field}`
`outputFormat`	select	Opt	`text` (Standard) · `json` · `json_schema`
`outputSchema`	textarea	Opt	JSON-Schema für `json_schema`-Ausgabe. Bei Ollama (v0.5+) wird das Schema direkt übergeben und erzwingt strukturierte Ausgabe auf Modell-Ebene.
`temperature`	number	Opt	0–2, Standard 0.7
`maxTokens`	number	Opt	Maximale Ausgabe-Tokens
`timeout`	number	Opt	Timeout in ms (Standard 30000)
`topP`	number	Opt	Nucleus sampling 0–1
`frequencyPenalty`	number	Opt	-2 bis 2 (nur OpenAI)
`presencePenalty`	number	Opt	-2 bis 2 (nur OpenAI)
`stopSequences`	string	Opt	Kommagetrennte Stop-Sequenzen
`genericUrl`	string	Opt	Endpunkt für `generic`-Provider

Outputresultusagemodel

💬

AI Chat

Typ: ai-chat

Multi-Turn-Chat mit Verlauf. Ideal für gesprächsbasierte Flows, Agenten mit Tool-Calling und interaktive KI-Assistenten. Speichert Konversationsverlauf pro Session-ID. Konfiguration und Tools werden in separaten Tabs angezeigt.

Feld	Typ	Pfl.	Beschreibung
`provider`	select	Ja	`openai` · `anthropic` · `openrouter` · `ollama`
`credentialId`	credential	Ja	Provider-spezifischer API-Key
`model`	string	Ja	Modellname
`sessionId`	string	Ja	Eindeutige Session-ID für Verlaufs-Tracking
`userMessage`	textarea	Ja	Aktuelle User-Nachricht
`systemMessage`	textarea	Opt	System-Prompt (nur erste Nachricht)
`tools`	json	Opt	Tool-Definitionen für Function-Calling — konfigurierbar im „Tools"-Tab des Node-Dialogs. Unterstützt HTTP, PostgreSQL, MongoDB, Redis, Qdrant. Pro Tool kann eine Credential ausgewählt werden.
`maxHistoryMessages`	number	Opt	Max. Nachrichten im Verlauf (Standard 20)
`maxIterations`	number	Opt	Max. Tool-Call-Iterationen (Standard 10)
`temperature`	number	Opt	0–2
`maxTokens`	number	Opt	Maximale Ausgabe-Tokens
`outputFormat`	select	Opt	`text` (Standard) · `json` · `json_schema`
`outputSchema`	textarea	Opt	JSON-Schema für `json_schema`-Ausgabe. Bei Ollama (v0.5+) wird das Schema direkt als `format`-Feld übergeben und strukturiert die Ausgabe auf Modell-Ebene.
`clearHistory`	boolean	Opt	Verlauf vor dieser Ausführung löschen

OutputresponsetoolCallsusage

⚡

Trigger & Webhooks

Startpunkte für Workflow-Ausführungen — manuell, HTTP, E-Mail, Timer/Cron, Chat Widget

▶️

Trigger

Typ: trigger

Startpunkt jedes Workflows. Definiert initiale Testdaten für manuelle Ausführungen. Muss der erste Node sein.

Feld	Typ	Pfl.	Beschreibung
`data`	json	Opt	Initiale Testdaten (JSON-Objekt) für manuelle Ausführungen

Outputdata

🔗

Webhook

Typ: webhook

Empfängt eingehende HTTP-Requests und startet den Workflow. Die generierte URL wird nach dem Speichern angezeigt.

Feld	Typ	Pfl.	Beschreibung
`path`	string	Ja	URL-Pfad, z. B. `/my-hook`
`method`	select	Ja	`GET` · `POST` · `PUT` · `DELETE`
`token`	string	Opt	Bearer-Token zur Absicherung der Webhook-URL

Outputbodyheadersquerymethod

↩️

Respond to Webhook

Typ: respond-to-webhook

Sendet eine HTTP-Antwort an den ursprünglichen Webhook-Aufrufer. Muss nach einem Webhook-Node verwendet werden.

Feld	Typ	Pfl.	Beschreibung
`statusCode`	number	Ja	HTTP-Statuscode, z. B. `200`, `201`, `400`
`body`	json	Opt	Antwort-Body (JSON-Objekt)
`headers`	json	Opt	Zusätzliche Response-Header

📧

Email Trigger

Typ: email-trigger

Überwacht ein IMAP-Postfach per Polling und startet den Workflow bei neuen E-Mails.

Feld	Typ	Pfl.	Beschreibung
`host`	string	Ja	IMAP-Server-Hostname
`port`	number	Ja	Standard: 993 (SSL) oder 143
`secure`	boolean	Opt	TLS verwenden (Standard: true)
`credentialId`	credential	Ja	IMAP-Credentials (User + Passwort)
`mailbox`	string	Opt	Postfach-Ordner (Standard: INBOX)
`pollInterval`	number	Opt	Polling-Intervall in Sekunden (Standard: 60)
`onlyUnseen`	boolean	Opt	Nur ungelesene E-Mails abrufen
`markAsRead`	boolean	Opt	E-Mails nach Abruf als gelesen markieren
`maxEmails`	number	Opt	Max. E-Mails pro Durchlauf (Standard: 10)
`includeAttachmentContent`	boolean	Opt	Anhänge als Base64 einschließen

Outputemailscount

⏰

Timer / Cron

Typ: timer

Startet einen Workflow automatisch nach einem festen Intervall oder einem Cron-Zeitplan. Läuft nur wenn der Workflow veröffentlicht ist. Verteiltes Locking verhindert Doppelausführungen in Multi-Instance-Setups.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`scheduleType`	select	Ja	`interval` (jede N Sekunden/Minuten/Stunden/Tage) · `cron` (5-Feld-Cron-Ausdruck)
`intervalValue`	number	Opt	Intervall-Wert (Standard: 5) — nur für `interval`
`intervalUnit`	select	Opt	`seconds` · `minutes` · `hours` · `days` (Standard: `minutes`)
`cronExpression`	string	Opt	5-Feld-Cron-Ausdruck, z. B. `0 9 * * 1-5` (werktags 09:00 Uhr) — nur für `cron`

Voreingestellte Cron-Ausdrücke Im Editor stehen Schnellauswahl-Chips bereit: Jede Minute, Jede Stunde, Täglich Mitternacht, Jeden Montag, Ersten des Monats, Jeden Werktag.

Achtung Der Timer-Node muss der erste (und einzige Startnode) des Workflows sein. Der Node erscheint im Canvas mit der konfigurierten Zeitangabe als Untertitel. Nur veröffentlichte Workflows werden durch den Timer ausgelöst.

OutputscheduledAttriggerType

✈️

Telegram Trigger

Typ: telegram-trigger

Startet einen Workflow bei eingehenden Telegram-Updates via Bot-Webhook. Unterstützt alle Bot API 7.x Update-Typen (Nachrichten, Callbacks, Polls, Payments, Membership u. v. m.). Der Webhook wird beim Aktivieren des Workflows automatisch bei Telegram registriert.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Telegram Bot Token Credential (Bot Token + optionale Base URL)
`allowedUpdates`	json	Opt	JSON-Array mit Update-Typen, z. B. `["message","callback_query"]`. Leeres Array = alle Typen empfangen.

Update-Typen message, edited_message, channel_post, callback_query, inline_query, poll, poll_answer, my_chat_member, chat_member, chat_join_request, chat_boost, shipping_query, pre_checkout_query und weitere.

Output update updateType updateId payload chatId userId text messageId data

💬

Chat Widget

Typ: chat-widget

Erzeugt ein einbettbares Chat-Widget, das per <script>-Tag auf externen Websites eingebunden wird. Eingehende Nachrichten starten den Workflow. Antworten werden per Respond to Chat-Node zurückgesendet. Zwei Anzeigemodi: Bubble (Floating-Button) oder Inline (in einem Container-Div). Das Widget nutzt Shadow DOM für vollständige Style-Isolation.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`displayMode`	select	Opt	`bubble` (Standard) oder `inline`
`title`	string	Opt	Titel im Chat-Header (Standard: "Chat")
`subtitle`	string	Opt	Untertitel im Chat-Header
`welcomeMessage`	string	Opt	Erste Nachricht die beim Öffnen angezeigt wird
`placeholderText`	string	Opt	Platzhalter im Eingabefeld
`responseTimeout`	number	Opt	Maximale Wartezeit auf Antwort in Sekunden (Standard: 30, Max: 300)
`allowedOrigins`	textarea	Opt	Erlaubte Domains, eine pro Zeile. Wildcards möglich: `https://*.example.com`. Leer = nur Preview-URL funktioniert.

Design

Feld	Typ	Beschreibung
`primaryColor`	color	Haupt-Akzentfarbe (Standard: #6366f1)
`backgroundColor`	color	Hintergrundfarbe des Chat-Fensters
`textColor`	color	Textfarbe
`logoUrl`	string	URL zu einem Logo-Bild im Header
`position`	select	`bottom-right` (Standard) oder `bottom-left` — nur bei Bubble-Modus
`bubbleSize`	number	Größe des Bubble-Buttons in Pixeln (Standard: 60)
`borderRadius`	number	Eckenradius des Chat-Fensters (Standard: 16)
`customCss`	textarea	Eigenes CSS das innerhalb des Shadow DOM injiziert wird

Einbettung

Script-Tag: <script src="https://app.orchiq.io/chat-widget/{widgetId}/widget.js"></script>
Preview-URL: https://app.orchiq.io/chat-widget/{widgetId}/preview — lädt den Chat direkt inline zum Testen.

Sicherheit

Domain-Whitelisting: Wenn allowedOrigins konfiguriert ist, werden CORS-Header und Origin-Prüfung aktiv. Requests von nicht erlaubten Domains werden mit 403 abgelehnt. Die Preview-URL funktioniert immer. Wildcard-Subdomains werden unterstützt (https://*.example.com).

Output message sessionId widgetId timestamp metadata

💬

Respond to Chat

Typ: respond-to-chat

Sendet eine Antwort an das Chat Widget zurück. Muss nach einem Chat Widget-Trigger verwendet werden. Die Antwort wird im Chat-Fenster des Nutzers als Bot-Nachricht angezeigt.

Feld	Typ	Pfl.	Beschreibung
`responseText`	textarea	Ja	Antworttext der im Chat angezeigt wird. Unterstützt Variablen-Interpolation.
`responseData`	json	Opt	Zusätzliche strukturierte Daten die mit der Antwort mitgesendet werden (z. B. Buttons, Links).

Typischer Workflow: Chat Widget → AI Agent (verarbeitet Nachricht) → Respond to Chat (sendet KI-Antwort zurück)

🌐

HTTP & API

REST-Anfragen, Datei-Downloads

🌐

HTTP Request

Typ: http-request

Führt einen HTTP POST-Request aus. Für GET-Requests verwende URL-Parameter im Pfad oder den File-Download-Node.

Feld	Typ	Pfl.	Beschreibung
`url`	string	Ja	Ziel-URL (Variablen unterstützt)
`headers`	json	Opt	Request-Header als JSON-Objekt
`body`	json	Opt	Request-Body als JSON-Objekt
`timeout`	number	Opt	Timeout in ms (Standard: 30000)
`throwOnError`	boolean	Opt	Fehler bei HTTP 4xx/5xx werfen (Standard: true)

OutputbodystatusCodeheaders

⬇️

File Download

Typ: file-download

Lädt eine Datei von einer URL herunter und gibt den Inhalt als Base64 oder Text zurück.

Feld	Typ	Pfl.	Beschreibung
`url`	string	Ja	Download-URL
`outputFormat`	select	Opt	`base64` (Standard) · `text`
`timeout`	number	Opt	Timeout in ms (Standard: 30000)

OutputcontentmimeTypesize

📧

E-Mail

Gmail, SMTP, Outlook, IMAP

📤

Gmail Send

Typ: gmail-send

Sendet eine E-Mail über die Gmail API (OAuth2). HTML-Inhalte werden unterstützt.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Gmail OAuth2-Credential
`to`	string	Ja	Empfänger-E-Mail(s), kommagetrennt
`subject`	string	Ja	Betreff
`body`	textarea	Ja	E-Mail-Text (HTML erlaubt)
`cc`	string	Opt	CC-Empfänger, kommagetrennt
`bcc`	string	Opt	BCC-Empfänger, kommagetrennt

OutputmessageIdthreadId

📥

Gmail List

Typ: gmail-list

Listet E-Mails aus Gmail mit optionalem Suchfilter (Gmail-Suchoperatoren werden unterstützt).

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Gmail OAuth2-Credential
`query`	string	Opt	Gmail-Suchanfrage, z. B. `from:boss@example.com is:unread`
`maxResults`	number	Opt	Max. Ergebnisse (Standard: 10)

Outputmessagescount

✉️

SMTP Send

Typ: smtp-send

Sendet E-Mails über einen beliebigen SMTP-Server. Kompatibel mit Mailgun, SendGrid, Postfix usw.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	SMTP-Credential (Host, Port, User, Passwort)
`to`	string	Ja	Empfänger, kommagetrennt
`subject`	string	Ja	Betreff
`from`	string	Opt	Absender-Adresse (überschreibt Credential-Default)
`body`	textarea	Ja	E-Mail-Inhalt
`isHtml`	boolean	Opt	Body als HTML senden
`cc`	string	Opt	CC
`bcc`	string	Opt	BCC

OutputmessageIdaccepted

📨

Outlook Send

Typ: outlook-send

Sendet E-Mails über Microsoft 365 / Outlook via Microsoft Graph API (OAuth2).

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Microsoft OAuth2-Credential
`to`	string	Ja	Empfänger, kommagetrennt
`subject`	string	Ja	Betreff
`body`	textarea	Ja	E-Mail-Inhalt
`isHtml`	boolean	Opt	HTML-Modus
`cc`	string	Opt	CC
`bcc`	string	Opt	BCC

OutputmessageId

📫

IMAP

Typ: imap

Führt IMAP-Operationen auf einzelnen E-Mails durch (lesen, verschieben, löschen, flaggen).

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	IMAP-Credentials
`host`	string	Ja	IMAP-Hostname
`port`	number	Ja	Port (Standard: 993)
`secure`	boolean	Opt	TLS
`operation`	select	Ja	`markRead` · `markUnread` · `move` · `copy` · `delete` · `flag` · `unflag`
`emailUid`	string	Ja	UID der Ziel-E-Mail
`mailbox`	string	Opt	Quell-Postfach (Standard: INBOX)

Outputsuccess

☁️

Cloud & Storage

Amazon S3, Nextcloud — Upload, Download, Listen, Ordner-Management

⬆️

S3 Upload

Typ: s3-upload

Lädt Daten in einen Amazon S3-Bucket. Inhalt kann Base64 oder Text sein.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	AWS-Credential (Access Key + Secret)
`bucket`	string	Ja	S3-Bucket-Name
`key`	string	Ja	S3-Objektpfad / Dateiname
`content`	string	Ja	Dateiinhalt (Base64 oder Text)
`mimeType`	string	Opt	Content-Type, z. B. `application/pdf`
`isBase64`	boolean	Opt	Content ist Base64-kodiert

Outputurlkeybucket

⬇️

S3 Download

Typ: s3-download

Lädt ein Objekt aus S3 herunter.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	AWS-Credential
`bucket`	string	Ja	Bucket-Name
`key`	string	Ja	Objekt-Key
`outputFormat`	select	Opt	`base64` (Standard) · `text`

OutputcontentcontentTypesize

📋

S3 List

Typ: s3-list

Listet Objekte in einem S3-Bucket, optional gefiltert nach Präfix.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	AWS-Credential
`bucket`	string	Ja	Bucket-Name
`prefix`	string	Opt	Pfad-Präfix für Filterung
`maxKeys`	number	Opt	Max. Ergebnisse (Standard: 100)

Outputobjectscount

☁️

Nextcloud Upload

Typ: nextcloud-upload

Lädt eine Datei in eine Nextcloud-Instanz hoch (WebDAV).

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Nextcloud-Credential (URL, User, Passwort)
`remotePath`	string	Ja	Zielpfad auf Nextcloud, z. B. `/Dokumente/bericht.pdf`
`content`	string	Ja	Dateiinhalt als Base64 oder Text
`isBase64`	boolean	Opt	Inhalt ist Base64-kodiert
`mimeType`	string	Opt	Content-Type der Datei

Outputpathurlsize

⬇️

Nextcloud Download

Typ: nextcloud-download

Lädt eine Datei von Nextcloud herunter.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Nextcloud-Credential
`remotePath`	string	Ja	Pfad zur Datei auf Nextcloud
`outputFormat`	select	Opt	`base64` (Standard) · `text`

OutputcontentmimeTypesize

📂

Nextcloud List

Typ: nextcloud-list

Listet Dateien und Ordner in einem Nextcloud-Verzeichnis.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Nextcloud-Credential
`remotePath`	string	Ja	Ordnerpfad, z. B. `/Dokumente`

Outputfilescount

📁

Nextcloud Ordner erstellen

Typ: nextcloud-create-folder

Erstellt einen neuen Ordner auf Nextcloud (inkl. verschachtelter Pfade).

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Nextcloud-Credential
`remotePath`	string	Ja	Neuer Ordnerpfad, z. B. `/Archiv/2026`

Outputpathcreated

🗑️

Nextcloud Delete

Typ: nextcloud-delete

Löscht eine Datei oder einen Ordner auf Nextcloud.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Nextcloud-Credential
`remotePath`	string	Ja	Pfad zur Datei/Ordner

Outputdeletedpath

↔️

Nextcloud Move / Umbenennen

Typ: nextcloud-move

Verschiebt oder benennt eine Datei/Ordner auf Nextcloud um.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Nextcloud-Credential
`fromPath`	string	Ja	Quellpfad
`toPath`	string	Ja	Zielpfad (inkl. neuem Dateiname)

OutputfromPathtoPath

🔵

Google

Google Calendar, Drive, Sheets, Docs — via OAuth2

📅

Google Calendar Create

Typ: google-calendar-create

Erstellt einen neuen Termin in Google Calendar.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Google OAuth2-Credential
`calendarId`	string	Opt	Kalender-ID (Standard: `primary`)
`summary`	string	Ja	Termin-Titel
`start`	string	Ja	Startzeit (ISO 8601)
`end`	string	Ja	Endzeit (ISO 8601)
`description`	textarea	Opt	Beschreibung
`location`	string	Opt	Ort
`attendees`	string	Opt	E-Mail-Adressen der Teilnehmer, kommagetrennt

OutputeventIdhtmlLink

📆

Google Calendar List

Typ: google-calendar-list

Listet Termine aus Google Calendar in einem Zeitfenster.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Google OAuth2-Credential
`calendarId`	string	Opt	Kalender-ID (Standard: `primary`)
`timeMin`	string	Opt	Frühestes Datum (ISO 8601)
`timeMax`	string	Opt	Spätestes Datum (ISO 8601)
`maxResults`	number	Opt	Max. Ergebnisse (Standard: 10)

Outputeventscount

📤

Google Drive Upload

Typ: google-drive-upload

Lädt eine Datei auf Google Drive hoch.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Google OAuth2-Credential
`fileName`	string	Ja	Dateiname auf Drive
`content`	string	Ja	Dateiinhalt (Base64 oder Text)
`mimeType`	string	Opt	Content-Type
`folderId`	string	Opt	Ziel-Ordner-ID auf Drive

OutputfileIdwebViewLink

⬇️

Google Drive Download

Typ: google-drive-download

Lädt eine Datei von Google Drive herunter.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Google OAuth2-Credential
`fileId`	string	Ja	Google Drive Datei-ID
`outputFormat`	select	Opt	`base64` (Standard) · `text`

OutputcontentmimeTypename

📂

Google Drive List

Typ: google-drive-list

Listet Dateien auf Google Drive, optional gefiltert nach Ordner oder Query.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Google OAuth2-Credential
`query`	string	Opt	Drive-Suchanfrage (Drive API Query-Syntax)
`folderId`	string	Opt	Ordner-ID zur Filterung
`maxResults`	number	Opt	Max. Ergebnisse (Standard: 20)

Outputfilescount

📊

Google Sheets Read

Typ: google-sheets-read

Liest Daten aus einem Google Sheets-Tabellenblatt.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Google OAuth2-Credential
`spreadsheetId`	string	Ja	Spreadsheet-ID aus der Google Sheets URL
`range`	string	Ja	Bereich, z. B. `Sheet1!A1:D10` oder `A:Z`
`majorDimension`	select	Opt	`ROWS` (Standard) · `COLUMNS`

OutputvaluesrowCountcolumnCount

✏️

Google Sheets Write

Typ: google-sheets-write

Schreibt oder aktualisiert Daten in einem Google Sheets-Tabellenblatt.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Google OAuth2-Credential
`spreadsheetId`	string	Ja	Spreadsheet-ID
`range`	string	Ja	Zielbereich, z. B. `Sheet1!A1`
`values`	json	Ja	2D-Array der zu schreibenden Werte, z. B. `[["Name","Wert"],["Test",42]]`
`valueInputOption`	select	Opt	`RAW` · `USER_ENTERED` (Standard, interpretiert Formeln)

OutputupdatedRangeupdatedRowsupdatedCells

📄

Google Docs Create

Typ: google-docs-create

Erstellt ein neues Google Docs-Dokument mit optionalem Textinhalt.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Google OAuth2-Credential
`title`	string	Ja	Dokumenttitel
`content`	textarea	Opt	Initialer Textinhalt (wird als Nur-Text eingefügt)

OutputdocumentIdtitleurl

📃

Google Docs Get

Typ: google-docs-get

Liest den Inhalt eines bestehenden Google Docs-Dokuments.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Google OAuth2-Credential
`documentId`	string	Ja	Dokument-ID aus der Google Docs URL

Outputtitlebodytext

🖥️

Server

Remote-Befehle via SSH ausführen

⌨️

SSH Exec

Typ: ssh-exec

Verbindet sich per SSH mit einem Remote-Server und führt einen Shell-Befehl aus.

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	SSH-Credential (Host, User, Passwort/Key)
`command`	textarea	Ja	Auszuführender Shell-Befehl
`timeout`	number	Opt	Timeout in ms (Standard: 30000)

OutputstdoutstderrexitCode

🔀

Logik & Steuerung

Bedingungen, Schleifen, Timing, Fehlerbehandlung

🔀

Condition

Typ: condition

Verzweigt den Workflow basierend auf einer Bedingung. Hat zwei Ausgänge: true und false.

Feld	Typ	Pfl.	Beschreibung
`type`	select	Ja	`simple` (Vergleich) · `expression` (JavaScript)
`leftOperand`	string	Opt	Linker Wert für `simple`-Modus (Variablen unterstützt)
`operator`	select	Opt	`==` · `!=` · `>` · `<` · `>=` · `<=` · `contains` · `startsWith`
`rightOperand`	string	Opt	Rechter Vergleichswert
`expression`	textarea	Opt	JavaScript-Ausdruck für `expression`-Modus, muss boolean zurückgeben

Outputtruefalseresult

🔁

Loop

Typ: loop

Iteriert über ein Array und führt den nachfolgenden Teilgraph für jedes Element aus. Hat zwei Output-Handles: loop wird pro Iteration ausgeführt, done einmal am Ende mit den gesammelten Ergebnissen.

Feld	Typ	Pfl.	Beschreibung
`inputPath`	string	Opt	Datenpfad zum Array, z. B. `items` oder `data.users`. Bei leerem Wert wird der gesamte Input verwendet bzw. das erste Array-Feld automatisch erkannt.

Output loopitemindextotalisFirstisLast

Output doneresultscountcompleted

Ergebnis-Sammelung Standardmäßig enthält results den Output der letzten Node des Loop-Branches pro Iteration. Wer einzelne Felder oder berechnete Werte sammeln möchte, platziert eine Loop-End-Node am Ende des Loop-Branches — deren gesammeltes Array überschreibt dann results am done-Output.

🏁

Loop End

Typ: loop-end

Sammelt pro Iteration einen Wert aus ihrem Eingang. Wird automatisch der umgebenden Loop-Node zugeordnet — das resultierende Array ersetzt deren results am done-Branch.

Feld	Typ	Pfl.	Beschreibung
`mapping`	json	Opt	JSON-Objekt `Ziel → Quelle`. Quellen können `${input.feld}`, `${variable}`, ein "String-Literal" oder ein fester Wert sein. Leer lassen, um pro Iteration den gesamten Input zu sammeln.

Outputcollectedcount

Beispiel Mapping {"id": "${input.user.id}", "name": "${input.user.firstName} ${input.user.lastName}"} erzeugt pro Iteration ein Objekt mit den Feldern id und name. Verschachtelte Ziele wie "user.email" bauen automatisch eine Objekt-Struktur.

Platzierung Die Loop-End-Node gehört in den loop-Branch der Loop — sie muss nicht mit dem done-Handle verbunden werden. Die Zuordnung erfolgt automatisch über die Graph-Struktur.

⬇️

Merge

Typ: merge

Kombiniert die Ausgaben mehrerer paralleler Zweige zu einem Objekt.

Feld	Typ	Pfl.	Beschreibung
`mode`	select	Ja	`merge` · `deep-merge` · `pick` · `assign-key`
`inputCount`	number	Ja	Anzahl der Eingänge (2–10)
`keys`	string	Opt	Kommagetrennte Keys für `pick`-Modus
`assignKey`	string	Opt	Schlüsselname für `assign-key`-Modus

Outputmerged

⏱️

Delay

Typ: delay

Pausiert die Ausführung für eine definierte Zeit oder wartet auf einen externen Webhook-Trigger.

Feld	Typ	Pfl.	Beschreibung
`mode`	select	Ja	`delay` (Zeit-Pause) · `webhook` (auf externen Call warten)
`delayMs`	number	Opt	Wartezeit in Millisekunden (für `delay`-Modus)
`webhookTimeout`	number	Opt	Max. Wartezeit für Webhook in ms

Outputelapsed

🚦

Concurrency Limiter

Typ: concurrency-limiter

Begrenzt die gleichzeitige Ausführung paralleler Zweige. Nützlich für Rate-Limiting externer APIs.

Feld	Typ	Pfl.	Beschreibung
`maxConcurrent`	number	Ja	Max. gleichzeitige Ausführungen
`checkIntervalMs`	number	Opt	Prüfintervall in ms (Standard: 500)
`timeoutMs`	number	Opt	Max. Wartezeit in ms bevor Fehler

OutputacquiredwaitTime

🛡️

Error Handler

Typ: error-handler

Fängt Fehler aus einem vorherigen Node ab und leitet den Workflow in einen Fehlerbehandlungs-Zweig um. Keine Konfigurationsfelder notwendig.

Verwendung Verbinde einen fehlerproduzierenden Node mit dem Error-Handler-Node. Nachfolgende Nodes im Fehler-Zweig erhalten die Fehlerdaten als Eingabe.

OutputnodeIdnodeTypemessagecodestack

⚙️

Datentransformation

JavaScript, Variablen-Mapping, PDF, Markdown

JS

JavaScript

Typ: javascript

Führt beliebigen JavaScript-Code in einer sicheren VM2-Sandbox aus. Ideal für komplexe Transformationen, die kein vordefinierter Node abdeckt.

Feld	Typ	Pfl.	Beschreibung
`code`	code	Ja	JavaScript-Code. `return` definiert die Ausgabe. Zugriff auf Kontext über `input`-Objekt.

Sandbox Der Code läuft isoliert in VM2. Kein Dateisystem-Zugriff, kein require() für native Module. Nur pure JavaScript-Logik und der übergebene input-Kontext.

Outputresult

🗂️

Map Variables

Typ: map-variables

Mappt und umbenennt Ausgabe-Felder ohne Code. Definiert als JSON-Objekt mit Ziel-Schlüssel → Quell-Pfad.

Feld	Typ	Pfl.	Beschreibung
`mappings`	json	Ja	JSON-Objekt: `{"zielKey": "${quellNode.feld}"}`

Output[gemappte Felder]

📄

PDF Extract

Typ: pdf-extract

Extrahiert Text aus einem PDF-Dokument (Base64-kodiert).

Feld	Typ	Pfl.	Beschreibung
`content`	string	Ja	PDF-Inhalt als Base64-String (z. B. aus S3 Download oder File Download)

OutputtextpagespageCount

📝

PDF Create

Typ: pdf-create

Erstellt ein neues PDF aus einfachem Text.

Feld	Typ	Pfl.	Beschreibung
`text`	textarea	Ja	Textinhalt des PDFs
`fontSize`	number	Opt	Schriftgröße in Punkt (Standard: 12)
`font`	select	Opt	`Helvetica` · `Times-Roman` · `Courier`

OutputcontentmimeType

📝

Markdown Convert

Typ: markdown-convert

Konvertiert zwischen Markdown und HTML in beide Richtungen.

Feld	Typ	Pfl.	Beschreibung
`direction`	select	Ja	`md-to-html` · `html-to-md`
`input`	textarea	Ja	Eingabetext (Markdown oder HTML)

Outputoutput

✈️

Messaging

Telegram Bot API — Nachrichten, Medien, Chat-Verwaltung

✈️

Typ: telegram

Sendet Nachrichten, verwaltet Chats und verarbeitet Dateien über die Telegram Bot API. Unterstützt alle gängigen Bot-API-Operationen in den Bereichen Nachrichten, Dateien, Chats und Callbacks.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Telegram Bot Token Credential
`resource`	select	Ja	`message` · `file` · `chat` · `callback`
`operation`	select	Ja	Abhängig von `resource` — siehe Tabelle unten

Operationen nach Resource

Resource	Operationen
`message`	`sendMessage`, `editMessageText`, `deleteMessage`, `forwardMessage`, `sendPoll`, `sendLocation`
`file`	`sendDocument`, `sendPhoto`, `sendAudio`, `sendVideo`, `getFile`
`chat`	`getChat`, `getChatMember`, `getChatMemberCount`, `banChatMember`, `unbanChatMember`, `leaveChat`, `setChatTitle`, `pinChatMessage`
`callback`	`answerCallbackQuery`

Beispiel: Nachricht senden Resource: message, Operation: sendMessage. Weitere Felder: chatId (Ziel-Chat), text (Nachrichteninhalt), parseMode (HTML oder Markdown), disableNotification.

Outputresultok

◈

GraphQL

Typ: graphql-query

Führt GraphQL-Queries und -Mutations gegen beliebige GraphQL-Endpunkte aus. Unterstützt Variablen, Operation Names und optionale Credential-basierte Authentifizierung (Bearer, API Key, Basic Auth, HTTP Header).

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`endpoint`	string	Ja	URL des GraphQL-Endpunkts — Variablen-Syntax unterstützt
`query`	code	Ja	GraphQL-Query oder -Mutation (z. B. `query { user { id name } }`)
`variables`	json	Opt	Variablen als JSON-Objekt, die an die Query übergeben werden
`operationName`	string	Opt	Name der Operation bei mehreren Definitionen im Query-Dokument
`credentialId`	credential	Opt	Optionale Authentifizierung — kompatibel mit `bearer-token`, `api-key`, `basic-auth`, `http-header`

Hinweis: Wenn der Server Fehler im errors-Feld zurückgibt und data leer ist, wird die Node-Ausführung als fehlgeschlagen gewertet.

OutputdataerrorshasErrors

🐘

PostgreSQL

Typ: postgres-query

Führt SQL-Queries direkt gegen eine PostgreSQL-Datenbank aus. Unterstützt SELECT sowie DML-Statements (INSERT, UPDATE, DELETE) mit parametrisierten Platzhaltern ($1, $2, …).

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	PostgreSQL-Credential (Host, Port, Datenbank, Benutzername, Passwort)
`query`	textarea	Ja	SQL-Statement — Platzhalter `$1`, `$2` für Parameter verwenden
`params`	json	Opt	Parameter als JSON-Array, z. B. `["alice", 30]` — werden in der Reihenfolge als `$1`, `$2` eingesetzt

Sicherheit: Nur parametrisierte Queries verwenden — niemals Werte direkt in den Query-String einbauen.

OutputrowsrowCount

🍃

MongoDB

Typ: mongodb-query

Führt MongoDB-Operationen auf einer Collection aus. Unterstützt Lesen, Schreiben, Aktualisieren, Löschen und Aggregation-Pipelines.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	MongoDB-Credential (Host, Port, Datenbank, Benutzername, Passwort, Auth-DB)
`database`	string	Ja	Name der Zieldatenbank
`collection`	string	Ja	Name der Collection
`operation`	select	Ja	`find` · `findOne` · `insertOne` · `updateOne` · `deleteOne` · `aggregate`
`filter`	json	Opt	MongoDB-Filter-Dokument (für find, findOne, updateOne, deleteOne)
`document`	json	Opt	Einfüge- oder Update-Dokument
`pipeline`	json	Opt	Aggregation-Pipeline als Array (nur für `aggregate`)
`limit`	number	Opt	Maximale Anzahl zurückgegebener Dokumente (nur für `find`)

Outputdocumentsresultcount

🐬

MySQL / MariaDB

Typ: mysql-query

Führt SQL-Queries direkt gegen eine MySQL- oder MariaDB-Datenbank aus. Unterstützt SELECT sowie DML-Statements mit parametrisierten ?-Platzhaltern.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	MySQL-Credential (Host, Port, Datenbank, Benutzername, Passwort)
`query`	textarea	Ja	SQL-Statement — `?`-Platzhalter für Parameter verwenden
`params`	json	Opt	Parameter als JSON-Array, z. B. `["alice", 30]` — werden in der Reihenfolge der `?`-Platzhalter eingesetzt

Sicherheit: Nur parametrisierte Queries verwenden — niemals Werte direkt in den Query-String einbauen.

OutputrowsrowCount

📡

Redis

Redis Pub/Sub — Trigger, Publish

📡

Redis Trigger

Typ: redis-trigger

Startet einen Workflow bei eingehenden Redis Pub/Sub-Nachrichten. Abonniert einen oder mehrere Channels und löst den Workflow aus, sobald eine Nachricht empfangen wird. Unterstützt Pattern-Subscribe (PSUBSCRIBE) für Wildcard-Channels.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Redis Credential (URL, Passwort, DB)
`channels`	string	Ja	Kommagetrennte Liste von Channels, z. B. `my-channel, events:*`
`messageFormat`	select	Opt	Nachrichtenformat: `text` (Standard) oder `json`. Bei JSON werden eingehende Nachrichten automatisch als Objekt geparst.
`usePatternSubscribe`	boolean	Opt	PSUBSCRIBE verwenden — erlaubt Wildcards wie `events:*`

Nachrichtenformat: Bei json wird die empfangene Nachricht automatisch geparst — message enthält dann ein JSON-Objekt. Bei text bleibt message ein String. rawMessage enthält immer den originalen String.

Output channel message rawMessage pattern

📡

Redis Publish

Typ: redis-publish

Publiziert eine Nachricht auf einem Redis Pub/Sub-Channel. Alle Subscriber, die den Channel abonniert haben, erhalten die Nachricht in Echtzeit.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`credentialId`	credential	Ja	Redis Credential (URL, Passwort, DB)
`channel`	string	Ja	Ziel-Channel, z. B. `my-channel`
`messageFormat`	select	Opt	Nachrichtenformat: `text` (Standard) oder `json`. Bei JSON wird die Nachricht vor dem Senden validiert.
`message`	textarea	Ja	Nachricht. Bei Text: Freitext mit Variablen (`${node.output}`). Bei JSON: gültiges JSON-Objekt (Monospace-Editor mit Validierung).

Cross-Workflow-Kommunikation: Kombiniere Redis Publish mit einem Redis Trigger in einem anderen Workflow, um Workflows über Redis-Channels miteinander zu verknüpfen.

Output channel message receivers

📋 Daten

Data Storage ermöglicht es, strukturierte Datentabellen direkt im System anzulegen — z.B. Serverlisten, Kontaktlisten oder Konfigurationen. Entries können Credential-Referenzen enthalten (nur IDs, nie Klartext). Ab dem Pipeline-Plan verfügbar.

📋

Data Storage: Lesen

Typ: data-storage-read

Liest Einträge aus einem Data Storage. Optional mit Filtern und Limit. Credential-Referenzen werden als IDs in die Ausgabe-Daten gemergt — nie als Klartext-Secrets.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`dataStorageId`	select	Ja	Der Data Storage, aus dem gelesen wird
`filters`	json	Opt	Filter-Array: `[{field, operator, value}]` — Operatoren: `equals`, `not_equals`, `contains`, `starts_with`, `gt`, `lt`, `in`
`limit`	number	Opt	Maximale Anzahl zurückgegebener Einträge

Credential-Referenzen: Entry-Felder vom Typ „Credential" enthalten nur die Credential-ID. Verwende ${item.feldname} in einer nachfolgenden Node (z.B. SSH), um die Credential-ID dynamisch zuzuweisen.

Outputentriescount

📝

Data Storage: Schreiben

Typ: data-storage-write

Erstellt oder aktualisiert Einträge in einem Data Storage. Unterstützt create (immer neu) und upsert (anhand eines Match-Feldes aktualisieren oder erstellen).

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`dataStorageId`	select	Ja	Ziel-Data-Storage
`operation`	select	Ja	`create` oder `upsert`
`matchField`	string	Opt	Feld für Upsert-Abgleich (z.B. `hostname`)
`data`	json	Ja	JSON-Objekt mit den Daten — `${variable}`-Syntax unterstützt

Outputentrycreated

🗑

Data Storage: Löschen

Typ: data-storage-delete

Löscht Einträge aus einem Data Storage anhand eines Feld-Abgleichs oder alle Einträge auf einmal.

Einstellungen

Feld	Typ	Pfl.	Beschreibung
`dataStorageId`	select	Ja	Ziel-Data-Storage
`matchField`	string	Opt	Feld für den Abgleich (z.B. `hostname`)
`matchValue`	string	Opt	Wert für den Abgleich — `${variable}`-Syntax unterstützt
`deleteAll`	boolean	Opt	Alle Einträge löschen (Vorsicht!)

OutputdeletedCount