Integrations-Hub
Überblick
Der Hub bewegt Daten über Systemgrenzen: hinaus zu fremden Diensten, herein von dort. Gebaut wird das als Flow — eine Kette aus Bausteinen, durch die Datensätze laufen.
Zwei Dinge, die den Hub von der Automation unterscheiden: Er arbeitet an der Grenze zu FREMDEN Systemen, und er verarbeitet Listen von Datensätzen, nicht einzelne Ereignisse. Die Regeln innerhalb des Systems bleiben Sache der Automation — es gibt bewusst nur eine Regel-Engine.
Ein Baustein ohne ankommende Datensätze läuft nicht. Das ist keine Störung, sondern die Regel: Ein Flow ohne Daten hat nichts zu tun.
Kernaufgaben
Einen Flow bauen. Im Editor ziehen Sie Bausteine zusammen und verbinden ihre Ausgänge. Werte werden über Formeln der Form {{= … }} gebildet — Code gibt es hier nicht.
Zuordnungen pflegen. Eine Zuordnung übersetzt Felder zwischen zwei Systemen. Eine Zuordnungstabelle übersetzt Werte (etwa fremde Statusnamen in eigene).
Aus einer Vorlage starten. Vorlagen bringen fertige Flows für gängige Aufgaben mit.
Läufe nachvollziehen. Das Lauf-Journal zeigt jeden Durchlauf mit den Daten je Baustein. Ein gescheiterter Lauf lässt sich wiederanlaufen lassen, statt alles neu zu starten.
Aus dem Speicher lesen. Der Speicher hält Werte zwischen Läufen — etwa den Stand des letzten Abrufs, damit ein Flow dort weitermacht, wo er aufgehört hat.
Felder im Detail
Ein Flow verbindet Systemgrenzen: Er holt Datensätze von außen, formt sie um und schreibt sie herein — oder umgekehrt. Regeln im Inneren des Systems gehören dagegen in die Automation; zwei Regel-Maschinen nebeneinander wären eine zu viel.
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Kennung flowKey | ja | Text, max. 100 Zeichen | Die technische Kennung des Flows. Nicht mehr ändern, sobald er läuft. |
Name name | ja | Text, max. 160 Zeichen | Wie der Flow in der Liste heißt. |
Beschreibung description | nein | Text | Was er tut. Der Absatz, der in einem Jahr die Frage beantwortet, ob man ihn abschalten darf. |
Auslöser triggerType | ja | Ereignis, Zeitplan, Webhook, manuell | Wann er läuft. Webhook heißt: Ein Fremdsystem ruft an. |
Auslöser-Einstellung triggerConfig | nein | je nach Art | Welches Ereignis, welcher Zeitplan. Die Zeitmechanik kommt aus der Automation — hier wird sie nur benannt. |
Webhook-Geheimnis webhookSecret | bei Webhook | Text | Womit ein eingehender Aufruf sich ausweist. Ohne Geheimnis lässt sich ein Flow gar nicht erst einschalten — ein offener Webhook wäre eine Tür ohne Schloss. |
Signaturverfahren webhookScheme | nein | Text, max. 40 Zeichen | Wie die Signatur gebildet wird. |
Warteschlange queueName | nein | Text, max. 60 Zeichen | In welcher Warteschlange der Flow läuft. Eine eigene Warteschlange verhindert, dass ein großer Import den Mailversand aufhält. |
Ausführender Nutzer runAsUserUlid | ja | bestehendes Konto | In wessen Namen geschrieben wird. Jeder schreibende Baustein läuft über diese Identität — der Flow kann nichts, was dieses Konto nicht darf, und im Protokoll steht es. |
Marke brandId | nein | eine Ihrer Marken | Für welche Marke der Flow arbeitet. |
Variablen variables | nein | Zuordnung von Bezeichnung zu Wert | Werte, die im ganzen Flow gelten — Adressen, Kennungen, Schwellen. Geheimnisse gehören hier hinein, nicht in einzelne Bausteine. |
Bausteine nodes / Verbindungen edges | ja | Liste | Der Flow selbst: was geschieht und in welcher Reihenfolge. Ein Baustein ohne ankommende Datensätze läuft nicht — leer heißt nicht „einmal ohne Daten", sondern gar nicht. |
Baustein node / nach after | — | einzelner Baustein und Vorgänger | Fügt beim Bearbeiten einen Baustein an einer Stelle ein. |
Testdaten testPayload | nein | Struktur | Beispieldaten für den Probelauf. Der Probelauf zeigt je Baustein, was hereinkam und was herauskam — die einzige brauchbare Art, einen Flow zu entwickeln. |
Nutzdaten payload | — | Struktur | Die Daten eines konkreten Laufs. |
Paket bundle | — | Struktur | Ein exportierter Flow zum Ein- und Ausspielen. Geheimnisse werden dabei nicht mitgegeben; sie werden am Ziel neu gesetzt. |
Einstellungen & Rechte
- Lesen:
connect.flow.view· Lauf-Journal inkl. Daten je Baustein:connect.run.view - Bauen und ändern:
connect.flow.manage - Starten, testen, wiederanlaufen:
connect.flow.execute
Modul-Flag: module.connect. Jeder schreibende Baustein läuft über die interne API im Namen eines Nutzers — ein Flow kann damit nie mehr als der Mensch, in dessen Namen er läuft.
FAQ & Fehlerbilder
Der Flow läuft, aber nichts passiert. Prüfen Sie, ob am ersten Baustein überhaupt Datensätze ankommen. Ohne ankommende Daten bleibt die Kette stehen.
Der Probelauf funktioniert, der echte nicht. Der Probelauf arbeitet mit Beispieldaten. Prüfen Sie die echten Werte im Lauf-Journal.
Ein Feld kommt leer an. Meist fehlt die Zuordnung, oder das fremde System liefert einen anderen Feldnamen als erwartet.