Automatisierungen

Automatisierungen lassen Tillor selbst Aktionen ausführen, etwa Aufgaben anlegen oder Ihr System aufrufen. Die Anleitung für Anwender steht unter Automatisierungen. Diese Seite beschreibt, was ein Integrator sieht: die Nachricht des Schritts Webhook senden, die API-Anfrage an eine eigene URL oder an die Tillor API, und wie ein Flow aufgebaut ist, wenn Sie ihn über die API verwalten.

Webhook sendenLink zu diesem Abschnitt kopieren

Der Schritt Webhook senden liefert eine eigene Nachricht an einen der Webhooks der Organisation aus. Es ist dieselbe Zustellung wie bei gewöhnlichen Webhook-Events, mit derselben Signatur.

Die NachrichtLink zu diesem Abschnitt kopieren

Der Schritt sendet einen POST mit Content-Type: application/json und diesen Headern:

Der Body hat denselben Umschlag wie die Webhook-Payload:

{
  "event": "automation.invoice_unpaid",
  "data": {
    "invoice": "2026-0042",
    "amountOutstanding": 125.5
  },
  "timestamp": 1735689600000,
  "traceId": "0b0f7c0e-5d3c-4c1e-9b8a-7f1e2a3b4c5d",
  "triggeredBy": null
}

Es gibt keine spanId. Der Webhook muss auf keinen Event-Key abonniert sein: Eine Nachricht aus einer Automatisierung wird immer am gewählten Endpunkt zugestellt, solange dieser existiert und aktiviert ist.

Wie Sie die Signatur prüfen, steht unter Signatur verifizieren.

Versuche und ErgebnisLink zu diesem Abschnitt kopieren

Tillor macht innerhalb des Schritts bis zu 5 Versuche, mit 1, 2, 4 und 8 Sekunden Wartezeit dazwischen. Ein Versuch gilt als erfolgreich bei einem 2xx-Status. Auch ein blockiertes Ziel, zum Beispiel eine interne Adresse, zählt als fehlgeschlagener Versuch.

• Gelingt einer der Versuche, läuft der Flow über den Ausgang Erfolgreich weiter
• Scheitern alle fünf, läuft der Flow über Fehlgeschlagen weiter. Die Nachricht wird danach im Hintergrund noch einmal versucht, nach dem Schema unter Zustellverhalten und Retries. Gelingt ein solcher späterer Versuch, taucht das nicht mehr in der Ausführung auf, denn diese ist dann bereits weitergelaufen

Existiert der Webhook nicht mehr oder ist er deaktiviert, läuft der Schritt nicht über Fehlgeschlagen. Die Ausführung stoppt dann mit dem Status Fehlgeschlagen.

API-Anfrage an eine eigene URLLink zu diesem Abschnitt kopieren

Mit API-Anfrage und Senden an auf Eigene URL sendet eine Automatisierung eine HTTP-Anfrage an Ihren Server.

Eine Antwort mit einem 2xx-Status läuft über Erfolgreich weiter, jeder andere Status über Fehlgeschlagen. Ist der Server nicht erreichbar oder überschreitet er das Timeout, stoppt die Ausführung mit dem Status Fehlgeschlagen.

API-Anfrage an die Tillor APILink zu diesem Abschnitt kopieren

Mit Senden an auf Tillor API ruft die Automatisierung die API der eigenen Organisation auf. Sie geben nur einen Pfad an, zum Beispiel /tasks, und Tillor setzt diesen hinter /api/orgs/{orgId}. Ihre API-Referenz finden Sie unter OpenAPI.

• Identität: Die Anfrage wird als Workflow-Benutzer der Organisation ausgeführt. Dieser hat alle Berechtigungen innerhalb dieser Organisation und nirgendwo sonst. Änderungen stehen also auf den Namen Workflow
• Kein Schlüssel nötig: Tillor führt den Aufruf selbst aus, ohne API-Schlüssel und ohne über das Internet zu gehen
• Pfad: Muss mit einem einzelnen / beginnen. //, .. und \ sind nicht erlaubt. Ein Query-String ist erlaubt, zum Beispiel /tasks?terrainId=…&limit=1. Variablen im Pfad werden kodiert eingesetzt
• Blockiert: Die Pfade /automations und /automation-runs werden abgelehnt, auch mit Query-String, Großbuchstaben, einem abschließenden / oder Prozent-Kodierung. Eine Automatisierung kann keine Automatisierungen verwalten
• Body: JSON, für POST, PUT und PATCH. Bei GET und DELETE wird er nicht mitgesendet
• Auswahlmenü: Im Editor steht API-Endpunkt auswählen mit den Operationen aus der OpenAPI-Spezifikation. Interne Operationen sind nicht dabei. Wählen Sie eine aus, trägt Tillor Methode, Pfad und einen Beispiel-Body ein
• Fehlschlagen: Eine 2xx-Antwort läuft über Erfolgreich weiter. Ein Fehlerstatus, auch ein 404 für einen nicht vorhandenen Pfad, läuft über Fehlgeschlagen

Die Antwort in späteren SchrittenLink zu diesem Abschnitt kopieren

Nach der Anfrage stehen diese Variablen zur Verfügung:

Eine zweite API-Anfrage im selben Flow ersetzt response. Die Variablen funktionieren wie bei Variablen und Vorlagen.

Der Aufbau eines FlowsLink zu diesem Abschnitt kopieren

Sie können Automatisierungen auch über die API anlegen und ändern. Die Operationen stehen in OpenAPI unter dem Tag automations. Lesen erfordert die Berechtigung automations:read, Anlegen und Ändern automations:write (oder alle Berechtigungen). Der Workflow-Benutzer selbst kann sie nie aufrufen. Es kann praktischer sein, einen Flow im Editor zu bauen und ihn als Beispiel zu lesen.

Eine neue Automatisierung ist immer deaktiviert. Das Aktivieren über enabled gelingt nicht, solange der Flow offene Probleme hat, und einen aktivierten Flow können Sie nicht mit Problemen speichern.

Die definition besteht aus Schritten (nodes), Linien (edges) und optional Anmerkungen (notes). Höchstens 100 Schritte, 200 Linien und 50 Anmerkungen.

{
  "nodes": [
    {
      "id": "trigger",
      "type": "trigger",
      "label": "",
      "position": { "x": 0, "y": 0 },
      "config": { "source": "event", "eventKey": "occupation:ended" }
    },
    {
      "id": "task",
      "type": "taskCreate",
      "label": "",
      "position": { "x": 0, "y": 190 },
      "config": { "title": "Controleer {occupation.terrain.name}", "priority": "HIGH" }
    }
  ],
  "edges": [
    { "id": "trigger:out:task", "source": "trigger", "target": "task", "sourceHandle": "out" }
  ],
  "notes": [
    {
      "id": "note_1",
      "text": "Maakt na elk vertrek een controletaak.",
      "position": { "x": 340, "y": 0 },
      "width": 240,
      "height": 140
    }
  ]
}

Eine Anmerkung (notes) ist eine Erklärung auf der Arbeitsfläche. Sie wird nie ausgeführt und hat keine Linien. text hat höchstens 2000 Zeichen, width und height sind in Pixeln.

Eine Linie hat einen sourceHandle: den Ausgang des Schritts, von dem sie ausgeht.

Jede Aktion außer webhookSend und httpRequest erhält einen zusätzlichen Ausgang error, sobald continueOnError in der config auf true steht. Ohne diese Einstellung stoppt eine fehlgeschlagene Aktion die Ausführung. Mit dieser Einstellung läuft der Flow über error weiter, mit {error.message} und {error.step} als Variablen für die folgenden Schritte. Der Ausgang skipped wird verwendet, wenn ein Schritt nichts zu tun hatte, und out ist dann der gewöhnliche Ausgang.

Bei forEach startet der Ausgang each pro Element eine eigene Ausführung für die folgenden Schritte, und der Ausgang done ist der gewöhnliche Fortsetzungsweg des Flows selbst.

Ein Ausgang darf zu mehreren Schritten führen. Die Ausführung läuft selbst mit der ersten Linie weiter und startet für jede weitere Linie eine eigene Ausführung mit denselben Daten, die parallel läuft (wie der Ausgang each von forEach). Linien, die einen Kreis bilden, werden im Editor abgelehnt. Ein Flow hat genau einen trigger.

Einstellungen pro SchrittLink zu diesem Abschnitt kopieren

Die Felder unter config sind die Felder aus dem Editor. Textfelder akzeptieren Variablen in geschweiften Klammern.

conditions hat die Form { "match": "all" oder "any", "rules": [...] }. Jede Regel ist { "id", "field", "operator", "value", "values" }. operator ist is, isNot, contains, greaterThan, lessThan, isOneOf, isEmpty oder isNotEmpty. values verwenden Sie nur bei isOneOf. Eine leere Liste von Regeln lässt alles durch.

Eine Automatisierung mit einem Webhook startenLink zu diesem Abschnitt kopieren

Eine Automatisierung mit dem Trigger webhook startet bei einem POST an ihre eigene Adresse:

curl -X POST "https://tillor.eu/api/orgs/org_abc123/automation-hooks/aut_xxx/<token>?bron=website" \
  -H "Content-Type: application/json" \
  -d '{"email":"jan@voorbeeld.nl","aankomst":"2026-07-14"}'

• Die vollständige Adresse steht im Editor beim Trigger, oder über GET /automations/{id}/webhook-url (mit automations:read). Das Token ist das Geheimnis; ein Header zur Authentifizierung ist nicht nötig
• Der JSON-Body wird zur Variable body, der Query-String zu query und der Zeitpunkt zu receivedAt
• Antwort 200 mit { "accepted": true }, sobald die Ausführung gestartet ist. Eine falsche, ersetzte oder deaktivierte Adresse ergibt 404, ein Body über 100 KB ergibt 400
• Viele Aufrufe kurz hintereinander werden nicht abgelehnt: Jeder gültige Aufruf startet eine Ausführung. Verwenden Sie Wiederholungen ignorieren beim Trigger, wenn derselbe Aufruf zweimal eintreffen kann, siehe Wiederholungen ignorieren

Eine Automatisierung kann ihren eigenen Webhook nicht über eine API-Anfrage an die Tillor API aufrufen.

Eine Entscheidung über die API treffenLink zu diesem Abschnitt kopieren

Die Aufgabe eines Schritts Um eine Entscheidung bitten hat eine Aktion pro Option, die Sie im Schritt eingestellt haben. Rufen Sie die Aufgabe ab, um die actions mit ihrer id zu sehen, und wählen Sie eine mit POST /tasks/{id}/actions/{actionId}/choose. Verlangt die Option eine Notiz, senden Sie diese als { "note": "..." } mit. Die Wahl ist endgültig: Sie schließt die Aufgabe ab und setzt die Automatisierung über den Ausgang dieser Option fort. Zugewiesene Kollegen (auch über eine Gruppe) und Administratoren dürfen wählen. Details finden Sie in der OpenAPI.

WeiterlesenLink zu diesem Abschnitt kopieren

• Webhooks für Signatur, Retries und die Liste der Events
• HTTP API für Authentifizierung und den Organisationskontext
• Variablen und Vorlagen für die Anleitung für Anwender