Automatiseringen

Automatiseringen laten Tillor zelf acties uitvoeren, zoals taken aanmaken of je systeem aanroepen. De gebruikersuitleg staat bij Automatiseringen. Deze pagina beschrijft wat een integrator ziet: het bericht van de stap Webhook versturen, het API-verzoek naar een eigen URL of naar de Tillor API, en hoe een flow is opgebouwd als je hem via de API beheert.

Webhook versturenLink naar deze sectie kopiëren

De stap Webhook versturen levert een eigen bericht af bij een van de webhooks van de organisatie. Het is dezelfde bezorging als bij gewone webhook-events, met dezelfde handtekening.

Het berichtLink naar deze sectie kopiëren

De stap doet een POST met Content-Type: application/json en deze headers:

De body heeft dezelfde envelop als de webhook-payload:

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

Er staat geen spanId in. De webhook hoeft niet op een event-key geabonneerd te zijn: een bericht uit een automatisering wordt altijd afgeleverd bij het gekozen endpoint, zolang dat bestaat en ingeschakeld is.

Hoe je de handtekening controleert, staat bij Handtekening verifiëren.

Pogingen en uitkomstLink naar deze sectie kopiëren

Tillor doet binnen de stap tot 5 pogingen, met 1, 2, 4 en 8 seconden wachten ertussen. Een poging telt als geslaagd bij een 2xx-status. Ook een doel dat wordt geblokkeerd, bijvoorbeeld een intern adres, telt als mislukte poging.

• Slaagt een van de pogingen, dan gaat de flow verder via de uitgang Gelukt
• Slagen ze alle vijf niet, dan gaat de flow verder via Mislukt. Het bericht wordt daarna nog op de achtergrond opnieuw geprobeerd volgens het schema bij Leveringsgedrag en retries. Slaagt zo'n latere poging, dan komt dat niet meer terug in de uitvoering, want die is dan al verdergegaan

Bestaat de webhook niet meer of is hij uitgeschakeld, dan loopt de stap niet via Mislukt. De uitvoering stopt dan met de status Mislukt.

API-verzoek naar een eigen URLLink naar deze sectie kopiëren

Met API-verzoek en Versturen naar op Eigen URL stuurt een automatisering een HTTP-verzoek naar jouw server.

Een antwoord met een 2xx-status gaat verder via Gelukt, elke andere status via Mislukt. Is de server niet te bereiken, of overschrijdt hij de time-out, dan stopt de uitvoering met de status Mislukt.

API-verzoek naar de Tillor APILink naar deze sectie kopiëren

Met Versturen naar op Tillor API roept de automatisering de API van de eigen organisatie aan. Je geeft alleen een pad op, bijvoorbeeld /tasks, en Tillor plaatst dat achter /api/orgs/{orgId}. Je API-referentie staat op OpenAPI.

• Identiteit: het verzoek wordt uitgevoerd als de Workflow-gebruiker van de organisatie. Die heeft alle permissies binnen die organisatie en nergens anders. Wijzigingen staan dus op naam van Workflow
• Geen sleutel nodig: Tillor voert de aanroep zelf uit, zonder API-sleutel en zonder via het internet te gaan
• Pad: moet met één / beginnen. //, .. en \ zijn niet toegestaan. Een query-string mag, bijvoorbeeld /tasks?terrainId=…&limit=1. Variabelen in het pad worden gecodeerd ingevuld
• Geblokkeerd: de paden /automations en /automation-runs worden geweigerd, ook met een query-string, hoofdletters, een afsluitende / of procentcodering. Een automatisering kan geen automatiseringen beheren
• Body: JSON, voor POST, PUT en PATCH. Bij GET en DELETE wordt hij niet meegestuurd
• Keuzemenu: in de editor staat Kies een API-endpoint met de operaties uit de OpenAPI-specificatie. Interne operaties staan er niet bij. Kies je er een, dan vult Tillor methode, pad en een voorbeeld-body in
• Mislukken: een 2xx-antwoord gaat verder via Gelukt. Een foutstatus, ook een 404 voor een pad dat niet bestaat, gaat via Mislukt

Het antwoord in latere stappenLink naar deze sectie kopiëren

Na het verzoek zijn deze variabelen beschikbaar:

Een tweede API-verzoek in dezelfde flow vervangt response. De variabelen werken zoals bij Variabelen en sjablonen.

De opbouw van een flowLink naar deze sectie kopiëren

Je kunt automatiseringen ook via de API aanmaken en wijzigen. De operaties staan in OpenAPI onder de tag automations. Lezen vraagt de permissie automations:read, aanmaken en wijzigen automations:write (of alle permissies). De Workflow-gebruiker zelf kan ze nooit aanroepen. Het kan handiger zijn een flow in de editor te bouwen en hem als voorbeeld te lezen.

Een nieuwe automatisering is altijd uitgeschakeld. Inschakelen via enabled lukt niet zolang de flow open problemen heeft, en een ingeschakelde flow kun je niet opslaan met problemen.

De definition bestaat uit stappen (nodes), lijnen (edges) en optioneel opmerkingen (notes). Maximaal 100 stappen, 200 lijnen en 50 opmerkingen.

{
  "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
    }
  ]
}

Een opmerking (notes) is uitleg op het canvas. Ze wordt nooit uitgevoerd en heeft geen lijnen. text is maximaal 2000 tekens, width en height zijn in pixels.

Een lijn heeft een sourceHandle: de uitgang van de stap waar hij vandaan komt.

Elke actie behalve webhookSend en httpRequest krijgt er een extra uitgang error bij zodra continueOnError in de config op true staat. Zonder die instelling stopt een mislukte actie de uitvoering. Met die instelling gaat de flow verder via error, met {error.message} en {error.step} als variabelen voor de stappen erna. De uitgang skipped wordt gebruikt als een stap niets te doen had, en out is dan de gewone uitgang.

Bij forEach start de uitgang each per item een eigen uitvoering voor de stappen erna, en de uitgang done is de gewone vervolgweg van de flow zelf.

Een uitgang leidt naar maximaal één stap, en lijnen die een kring vormen worden geweigerd in de editor. Een flow heeft precies één trigger.

Instellingen per stapLink naar deze sectie kopiëren

De velden onder config zijn de velden uit de editor. Tekstvelden accepteren variabelen tussen accolades.

conditions heeft de vorm { "match": "all" of "any", "rules": [...] }. Elke regel is { "id", "field", "operator", "value", "values" }. operator is is, isNot, contains, greaterThan, lessThan, isOneOf, isEmpty of isNotEmpty. values gebruik je alleen bij isOneOf. Een lege lijst met regels laat alles door.

Een automatisering starten met een webhookLink naar deze sectie kopiëren

Een automatisering met trigger webhook start bij een POST naar haar eigen adres:

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"}'

• Het volledige adres staat in de editor bij de trigger, of via GET /automations/{id}/webhook-url (met automations:read). Het token is het geheim; een header voor authenticatie is niet nodig
• De JSON-body wordt de variabele body, de querystring query, en het tijdstip receivedAt
• Antwoord 200 met { "accepted": true } zodra de uitvoering gestart is. Een verkeerd, vervangen of uitgeschakeld adres geeft 404, een body boven 100 KB geeft 400
• Per automatisering starten hoogstens 120 uitvoeringen per minuut; daarboven worden aanroepen genegeerd

Een automatisering kan haar eigen webhook niet aanroepen via een API-verzoek naar de Tillor API.

Goedkeuringen beslissen via de APILink naar deze sectie kopiëren

De taak van een stap Goedkeuring vragen beslis je met POST /automation-approvals/{taskId} en de body { "decision": "approved" } of { "decision": "rejected" }. Toegewezen collega's en beheerders mogen beslissen. Zie de OpenAPI voor de details.

Meer lezenLink naar deze sectie kopiëren

• Webhooks voor handtekening, retries en de lijst met events
• HTTP API voor authenticatie en de organisatie-context
• Variabelen en sjablonen voor de gebruikersuitleg