Integrationen
Sende einen Webhook oder rufe eine API aus einer Automatisierung auf.
Zuletzt aktualisiert am
Diese Schritte stehen in der Gruppe Integrationen. Eine fehlgeschlagene Zustellung läuft über Fehlgeschlagen weiter. Bei anderen Aktionen liest du Wenn ein Schritt fehlschlägt.
Webhook senden
Liefert eine eigene Nachricht an einen der Webhook-Endpunkte deiner Organisation. Das ist praktisch, um ein anderes System zu informieren, zum Beispiel dein Kassensystem oder deine Website.
| Feld | Was du einträgst |
|---|---|
| Endpunkt | Wähle einen deiner Webhook-Endpunkte. Du erkennst sie an ihrer Adresse. Pflichtfeld |
| Ereignisname | Der Name, der mit der Nachricht mitgeht, damit der Empfänger sie erkennen kann, zum Beispiel automation.invoice_unpaid. Pflichtfeld |
| Payload | Der Inhalt der Nachricht, als JSON. Variablen werden eingetragen, bevor die Nachricht gesendet wird. Pflichtfeld |
Endpunkte erstellst und verwaltest du über das Profilmenü unter Entwickler. Der Endpunkt muss existieren und eingeschaltet sein. Ist das nicht so, schlägt der Schritt fehl und die Ausführung stoppt.
Die Nachricht wird mit dem eigenen Schlüssel des Endpunkts signiert, genau wie die anderen Webhooks, die der Endpunkt empfängt. Tillor versucht es mehrmals erneut, wenn dein Server nicht richtig antwortet. Der Endpunkt muss dem Namen deines Ereignisses nicht folgen: Die Nachricht kommt in jedem Fall an.
Der Schritt hat zwei Ausgänge:
| Ausgang | Wann |
|---|---|
| Erfolgreich | Dein Server antwortete mit einem erfolgreichen Status |
| Fehlgeschlagen | Die Zustellung schlug nach allen Versuchen fehl. Die Nachricht wird danach im Hintergrund noch einmal versucht, genau wie ein normaler Webhook |
Die Vorlage Reservierungen an ein anderes System senden nutzt Fehlgeschlagen, um eine Aufgabe anzulegen, damit sich jemand darum kümmert.
Ein Payload sieht zum Beispiel so aus:
{
"reservation": "{reservation.displayId}",
"checkIn": "{reservation.checkIn}",
"adults": {reservation.numberOfAdults},
"customer": {
"firstName": "{reservation.customer.firstName}",
"email": "{reservation.customer.email}"
}
}Setze Text in Anführungszeichen und Zahlen ohne. Daten werden in JSON als internationales Datum mit Uhrzeit übergeben, etwa 2026-10-05T08:00:00.000Z. Lies Variablen und Vorlagen für die Details. Die technische Seite, etwa der Aufbau der Nachricht, steht unter Entwickler > Automatisierungen.
API-Anfrage
Ruft die Tillor-API deiner eigenen Organisation auf, oder eine andere Adresse im Internet. Damit kannst du fast alles tun, was Tillor kann, und Daten nachschlagen, um danach etwas damit zu tun.
Bei Senden an wählst du zwischen Tillor API und Eigene URL. Bei Methode wählst du GET (abrufen), POST (anlegen), PUT oder PATCH (ändern) oder DELETE (löschen).
Tillor API
| Feld | Was du einträgst |
|---|---|
| Pfad | Der Teil der Adresse nach der API deiner Organisation, zum Beispiel /tasks oder /tasks/{task.id}. Er muss mit / beginnen. Pflichtfeld |
| Body | Die Daten, die du mitsendest, als JSON. Leer lassen, wenn du nichts mitsendest |
Oben im Feld steht API-Endpunkt auswählen. Klicke darauf und suche in der Liste, zum Beispiel nach tasks. Wenn du einen Endpunkt wählst, trägt Tillor die Methode und den Pfad ein. Ist der Body noch leer, bekommst du außerdem ein Beispiel dafür, was der Endpunkt erwartet. Ersetze die Namen in geschweiften Klammern im Pfad durch Variablen aus früheren Schritten. Stehen Query-Parameter dabei, siehst du das unter dem Feld.
Der Aufruf erfolgt als Workflow-Benutzer und kann nie außerhalb deiner eigenen Organisation landen. Eine Automatisierung kann keine Automatisierungen verwalten, daher werden Aufrufe, die Automatisierungen oder ihre Ausführungen betreffen, abgelehnt.
Eigene URL
| Feld | Was du einträgst |
|---|---|
| URL | Die Adresse. Sie muss mit https:// beginnen. Pflichtfeld |
| Header | Zusätzliche Angaben für den Empfänger, zum Beispiel ein Schlüssel. Klicke auf Header hinzufügen und fülle den Name und den Wert aus |
| Body | Die Daten, die du mitsendest, als JSON. Leer lassen, wenn du nichts mitsendest |
Dafür gelten diese Regeln:
- Adressen ohne
https://werden abgelehnt - Private und interne Adressen werden abgelehnt, auch wenn ein gewöhnlicher Name darauf verweist
- Weiterleitungen werden nicht verfolgt. Antwortet der Server mit einer Weiterleitung, zählt das als Fehlgeschlagen
- Header werden verschlüsselt gespeichert. Du kannst also einen Schlüssel oder Token hineinschreiben
- Bei GET und DELETE wird kein Body mitgesendet
Ausgänge und Antwort
Die Anfrage hat zwei Ausgänge: Erfolgreich (der Server antwortete mit einem erfolgreichen Status) und Fehlgeschlagen (der Server antwortete mit einem Fehlerstatus). Erreicht Tillor den Server gar nicht, zum Beispiel durch ein Timeout nach 15 Sekunden oder eine abgelehnte Adresse, stoppt die Ausführung mit dem Status Fehlgeschlagen.
Für spätere Schritte gibt es drei Variablen:
| Variable | Inhalt |
|---|---|
{response.status} | Der Statuscode, zum Beispiel 200 |
{response.body} | Die Antwort als Text, gekürzt auf die ersten 4000 Zeichen |
{response.data} | Die Antwort als Daten, sodass du mit {response.data.items.0.id} Felder daraus holen kannst |
Wie du das nutzt, steht unter Eine API-Antwort verwenden. Ein vollständiges Beispiel mit einer Suchanfrage steht unter Mietwohnwagen nach Abreise prüfen.