Integraties
Stuur een webhook of roep een API aan vanuit een automatisering.
Laatst bijgewerkt op
Deze stappen staan in de groep Integraties. Een mislukte levering gaat verder via Mislukt. Bij andere acties lees je Als een stap mislukt.
Webhook versturen
Levert een eigen bericht af bij een van de webhook-endpoints van je organisatie. Dat is handig om een ander systeem op de hoogte te brengen, bijvoorbeeld je kassasysteem of je website.
| Veld | Wat je invult |
|---|---|
| Endpoint | Kies een van je webhook-endpoints. Je herkent ze aan hun adres. Verplicht |
| Naam van de gebeurtenis | De naam die in het bericht meegaat zodat de ontvanger het kan herkennen, bijvoorbeeld automation.invoice_unpaid. Verplicht |
| Payload | De inhoud van het bericht, als JSON. Variabelen worden ingevuld voor het bericht verstuurd wordt. Verplicht |
Endpoints maak en beheer je via het profielmenu onder Ontwikkelaars. Het endpoint moet bestaan en ingeschakeld zijn. Is dat niet zo, dan mislukt de stap en stopt de uitvoering.
Het bericht wordt ondertekend met de eigen sleutel van het endpoint, precies zoals de andere webhooks die het endpoint ontvangt. Tillor probeert het een paar keer opnieuw als je server niet goed antwoordt. Het endpoint hoeft de naam van je gebeurtenis niet te volgen: het bericht komt hoe dan ook aan.
De stap heeft twee uitgangen:
| Uitgang | Wanneer |
|---|---|
| Gelukt | Je server antwoordde met een geslaagde status |
| Mislukt | De levering mislukte na alle pogingen. Het bericht wordt daarna op de achtergrond nog opnieuw geprobeerd, net als een gewone webhook |
Het sjabloon Reserveringen doorsturen naar een ander systeem gebruikt Mislukt om een taak aan te maken zodat iemand het oppakt.
Een payload ziet er bijvoorbeeld zo uit:
{
"reservation": "{reservation.displayId}",
"checkIn": "{reservation.checkIn}",
"adults": {reservation.numberOfAdults},
"customer": {
"firstName": "{reservation.customer.firstName}",
"email": "{reservation.customer.email}"
}
}Zet tekst tussen aanhalingstekens en getallen zonder. Datums gaan in JSON als internationale datum en tijd door, zoals 2026-10-05T08:00:00.000Z. Lees Variabelen en sjablonen voor de details. De technische kant, zoals de opbouw van het bericht, staat bij Ontwikkelaars > Automatiseringen.
API-verzoek
Roept de Tillor API van je eigen organisatie aan, of een ander adres op internet. Hiermee kun je bijna alles doen wat Tillor kan, en gegevens opzoeken om daarna iets mee te doen.
Bij Versturen naar kies je tussen Tillor API en Eigen URL. Bij Methode kies je GET (opvragen), POST (aanmaken), PUT of PATCH (wijzigen) of DELETE (verwijderen).
Tillor API
| Veld | Wat je invult |
|---|---|
| Pad | Het deel van het adres na de API van je organisatie, bijvoorbeeld /tasks of /tasks/{task.id}. Het moet met / beginnen. Verplicht |
| Body | De gegevens die je meestuurt, als JSON. Laat leeg als je niets meestuurt |
Bovenaan het veld staat Kies een API-endpoint. Klik erop en zoek in de lijst, bijvoorbeeld tasks. Als je een endpoint kiest, vult Tillor de methode en het pad in. Is de Body nog leeg, dan krijg je ook een voorbeeld van wat het endpoint verwacht. Vervang de namen tussen accolades in het pad door variabelen uit eerdere stappen. Staan er queryparameters bij, dan zie je dat onder het veld.
De aanroep gebeurt als de Workflow-gebruiker en kan nooit buiten je eigen organisatie komen. Een automatisering kan geen automatiseringen beheren, dus aanroepen die automatiseringen of hun uitvoeringen raken worden geweigerd.
Eigen URL
| Veld | Wat je invult |
|---|---|
| URL | Het adres. Het moet met https:// beginnen. Verplicht |
| Headers | Extra gegevens voor de ontvanger, bijvoorbeeld een sleutel. Klik op Header toevoegen en vul de Naam en de Waarde in |
| Body | De gegevens die je meestuurt, als JSON. Laat leeg als je niets meestuurt |
Hiervoor gelden deze regels:
- Adressen zonder
https://worden geweigerd - Privé- en interne adressen worden geweigerd, ook als een gewone naam ernaar verwijst
- Omleidingen worden niet gevolgd. Antwoordt de server met een omleiding, dan telt dat als Mislukt
- Headers worden versleuteld opgeslagen. Je kunt er dus een sleutel of token in zetten
- Bij GET en DELETE wordt geen body meegestuurd
Uitgangen en antwoord
Het verzoek heeft twee uitgangen: Gelukt (de server antwoordde met een geslaagde status) en Mislukt (de server antwoordde met een foutstatus). Bereikt Tillor de server helemaal niet, bijvoorbeeld door een time-out na 15 seconden of een geweigerd adres, dan stopt de uitvoering met de status Mislukt.
Voor latere stappen zijn er drie variabelen:
| Variabele | Inhoud |
|---|---|
{response.status} | De statuscode, bijvoorbeeld 200 |
{response.body} | Het antwoord als tekst, ingekort tot de eerste 4000 tekens |
{response.data} | Het antwoord als gegevens, zodat je er velden uit kunt halen met {response.data.items.0.id} |
Hoe je dat gebruikt, staat bij Een API-antwoord gebruiken. Een volledig voorbeeld met een zoekopdracht staat bij Nalopen huurcaravan.