Automatizări

Automatizările lasă Tillor să execute singur acțiuni, cum ar fi crearea de sarcini sau apelarea sistemului dumneavoastră. Explicația pentru utilizatori se află la Automatizări. Această pagină descrie ce vede un integrator: mesajul pasului Trimite webhook, Cererea API către un URL propriu sau către API-ul Tillor și cum este construit un flux dacă îl gestionați prin API.

Trimite webhookCopiază linkul către această secțiune

Pasul Trimite webhook livrează un mesaj propriu către unul dintre webhook-urile organizației. Este aceeași livrare ca la evenimentele webhook obișnuite, cu aceeași semnătură.

MesajulCopiază linkul către această secțiune

Pasul face un POST cu Content-Type: application/json și aceste anteturi:

Corpul are același plic ca payload-ul webhook:

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

Nu există spanId. Webhook-ul nu trebuie să fie abonat la o cheie de eveniment: un mesaj dintr-o automatizare este livrat întotdeauna la endpoint-ul ales, cât timp acesta există și este activat.

Cum verificați semnătura se află la Verificarea semnăturii.

Încercări și rezultatCopiază linkul către această secțiune

Tillor face în cadrul pasului până la 5 încercări, cu 1, 2, 4 și 8 secunde de așteptare între ele. O încercare contează ca reușită la un status 2xx. Și o țintă blocată, de exemplu o adresă internă, contează ca încercare eșuată.

• Dacă una dintre încercări reușește, fluxul continuă prin ieșirea Reușit
• Dacă toate cinci eșuează, fluxul continuă prin Eșuat. Mesajul este apoi încercat din nou în fundal conform programului de la Comportamentul livrării și reîncercări. Dacă o încercare ulterioară reușește, aceasta nu mai apare în execuție, deoarece aceasta și-a continuat deja drumul

Dacă webhook-ul nu mai există sau este dezactivat, pasul nu trece prin Eșuat. Execuția se oprește atunci cu statusul Eșuat.

Cerere API către un URL propriuCopiază linkul către această secțiune

Cu Cerere API și Trimite către pe URL personalizat, o automatizare trimite o cerere HTTP către serverul dumneavoastră.

Un răspuns cu status 2xx continuă prin Reușit, orice alt status prin Eșuat. Dacă serverul nu poate fi atins sau depășește timpul limită, execuția se oprește cu statusul Eșuat.

Cerere API către API-ul TillorCopiază linkul către această secțiune

Cu Trimite către pe Tillor API, automatizarea apelează API-ul propriei organizații. Indicați doar o cale, de exemplu /tasks, iar Tillor o plasează după /api/orgs/{orgId}. Referința API se află la OpenAPI.

• Identitate: cererea este executată ca utilizatorul Flux de lucru al organizației. Acesta are toate permisiunile în acea organizație și nicăieri altundeva. Modificările apar deci pe numele Flux de lucru
• Nu este nevoie de cheie: Tillor face apelul singur, fără cheie API și fără a trece prin internet
• Cale: trebuie să înceapă cu un singur /. //, .. și \ nu sunt permise. Un șir de interogare este permis, de exemplu /tasks?terrainId=…&limit=1. Variabilele din cale sunt completate codificate
• Blocat: căile /automations și /automation-runs sunt refuzate, chiar și cu un șir de interogare, litere mari, un / final sau codificare procentuală. O automatizare nu poate gestiona automatizări
• Corp: JSON, pentru POST, PUT și PATCH. La GET și DELETE nu se trimite
• Meniu de alegere: în editor se află Alege un endpoint API, cu operațiunile din specificația OpenAPI. Operațiunile interne nu apar acolo. Dacă alegeți una, Tillor completează metoda, calea și un corp de exemplu
• Eșec: un răspuns 2xx continuă prin Reușit. Un status de eroare, inclusiv un 404 pentru o cale care nu există, trece prin Eșuat

Răspunsul în pașii următoriCopiază linkul către această secțiune

După cerere sunt disponibile aceste variabile:

O a doua cerere API din același flux înlocuiește response. Variabilele funcționează ca la Variabile și șabloane.

Structura unui fluxCopiază linkul către această secțiune

Puteți crea și modifica automatizări și prin API. Operațiunile se află în OpenAPI sub eticheta automations. Citirea cere permisiunea automations:read, crearea și modificarea automations:write (sau toate permisiunile). Utilizatorul Flux de lucru însuși nu le poate apela niciodată. Poate fi mai practic să construiți un flux în editor și să-l citiți ca exemplu.

O automatizare nouă este întotdeauna dezactivată. Activarea prin enabled nu reușește cât timp fluxul are probleme deschise, iar un flux activat nu poate fi salvat cu probleme.

definition constă din pași (nodes), linii (edges) și, opțional, observații (notes). Maximum 100 de pași, 200 de linii și 50 de observații.

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

O observație (notes) este o explicație pe canvas. Nu este niciodată executată și nu are linii. text are maximum 2000 de caractere, width și height sunt în pixeli.

O linie are un sourceHandle: ieșirea pasului din care pornește.

Fiecare acțiune, cu excepția webhookSend și httpRequest, primește o ieșire suplimentară error de îndată ce continueOnError din config este true. Fără această setare, o acțiune eșuată oprește execuția. Cu această setare, fluxul continuă prin error, cu {error.message} și {error.step} ca variabile pentru pașii următori. Ieșirea skipped se folosește când un pas nu a avut nimic de făcut, iar out este atunci ieșirea obișnuită.

La forEach, ieșirea each pornește pentru fiecare element o execuție proprie pentru pașii următori, iar ieșirea done este continuarea obișnuită a fluxului însuși.

O ieșire poate duce către mai mulți pași. Execuția continuă singură cu prima linie și pornește pentru fiecare altă linie o execuție proprie cu aceleași date, care rulează în paralel (ca ieșirea each a lui forEach). Liniile care formează un ciclu sunt refuzate în editor. Un flux are exact un trigger.

Setări pe pasCopiază linkul către această secțiune

Câmpurile de sub config sunt câmpurile din editor. Câmpurile de text acceptă variabile între acolade.

conditions are forma { "match": "all" sau "any", "rules": [...] }. Fiecare regulă este { "id", "field", "operator", "value", "values" }. operator este is, isNot, contains, greaterThan, lessThan, isOneOf, isEmpty sau isNotEmpty. values îl folosiți doar la isOneOf. O listă goală de reguli lasă totul să treacă.

Pornirea unei automatizări cu un webhookCopiază linkul către această secțiune

O automatizare cu trigger webhook pornește la un POST către propria 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"}'

• Adresa completă se află în editor la trigger, sau prin GET /automations/{id}/webhook-url (cu automations:read). Tokenul este secretul; un antet pentru autentificare nu este necesar
• Corpul JSON devine variabila body, șirul de interogare query, iar momentul receivedAt
• Răspuns 200 cu { "accepted": true } de îndată ce execuția a pornit. O adresă greșită, înlocuită sau dezactivată dă 404, un corp de peste 100 KB dă 400
• Multe apeluri la scurt timp unul după altul nu sunt refuzate: fiecare apel valid pornește o execuție. Folosiți Ignoră repetările la trigger dacă același apel poate sosi de două ori, vezi Ignoră repetările

O automatizare nu își poate apela propriul webhook printr-o Cerere API către API-ul Tillor.

Alegerea unei decizii prin APICopiază linkul către această secțiune

Sarcina unui pas Cere o decizie are câte o acțiune pentru fiecare opțiune pe care ați setat-o în pas. Preluați sarcina pentru a vedea actions cu id-ul lor și alegeți una cu POST /tasks/{id}/actions/{actionId}/choose. Dacă opțiunea cere o notă, trimiteți-o ca { "note": "..." }. Alegerea este definitivă: finalizează sarcina și continuă automatizarea pe ieșirea acelei opțiuni. Colegii desemnați (și printr-un grup) și administratorii pot alege. Vezi OpenAPI pentru detalii.

Citiți mai departeCopiază linkul către această secțiune

• Webhook-uri pentru semnătură, reîncercări și lista de evenimente
• API HTTP pentru autentificare și contextul organizației
• Variabile și șabloane pentru explicația destinată utilizatorilor