Der Webhook-Auslöser ermöglicht es jedem externen System, eine Level-Automatisierung über eine HTTP-Anfrage auszulösen. Wenn Sie diesen Auslöser speichern, generiert Level eine eindeutige URL. Senden Sie eine POST-Anfrage an diese URL und die Automatisierung wird ausgeführt.
Verwenden Sie es, um Level mit Tools zu integrieren, die ausgehende Webhooks unterstützen — PSA-Plattformen, Überwachungssysteme, externe Skripte oder alles, das einen HTTP-Aufruf tätigen kann.
ℹ️ HINWEIS: Das Hinzufügen nicht manueller Auslöser erfordert entweder Admin-Status oder eine Rolle mit der Berechtigung Automatisierungen verwalten. Wenn Sie die Automatisierung sehen, aber keine Auslöser hinzufügen können, überprüfen Sie die Berechtigungen Ihrer Rolle bei Ihrem Admin. Siehe Arbeitsbereich → Berechtigungen für Details.
Webhook-Auslöser
Generieren der Webhook-URL
Die Webhook-URL wird erstellt, wenn Sie den Auslöser speichern — sie existiert vorher nicht. Klicken Sie auf Speichern und Level generiert ein eindeutiges Token, das an diesen Auslöser gebunden ist.
⚠️ WARNUNG: Das Löschen dieses Auslösers löscht auch das eindeutige Token. Jedes externe System, das auf diese URL verweist, funktioniert sofort nicht mehr. Wenn Sie das Token neu generieren müssen, löschen und erstellen Sie den Auslöser neu, aktualisieren Sie dann die URL in Ihrem externen System.
Autorisierungskopf erforderlich
Markieren Sie Autorisierungskopf erforderlich, um tokenbasierte Authentifizierung zum Endpunkt hinzuzufügen. Wenn aktiviert, müssen Anfragen den Autorisierungsschlüssel im Anfrage-Header enthalten — nicht authentifizierte Anfragen werden abgelehnt.
Der cURL-Befehl unter der URL wird automatisch aktualisiert, um den Header -H "Authorization: ..." einzubeziehen, wenn diese Option aktiviert ist. Kopieren Sie den vollständigen cURL-Befehl als Referenz, wenn Sie Ihr externes System konfigurieren.
💡 TIPP: Aktivieren Sie den Autorisierungskopf für jeden Webhook-Endpunkt, der vom öffentlichen Internet erreichbar ist. Dies gewährleistet, dass nur Systeme mit dem Schlüssel die Automatisierung auslösen können.
Parameter-Zuordnung
Ordnen Sie Schlüssel aus der eingehenden JSON-Payload Automatisierungsvariablen zu, damit Ihre Aktionen und Skripte diese Daten verwenden können.
Jede Zuordnungszeile hat zwei Felder:
Parameter-Schlüssel — Ein Schlüsselname aus der eingehenden JSON-Payload (z. B.
device_id,ticket_number)Automatisierungsvariablen — Der Variablenname, auf den in der Automatisierungspipeline abgebildet werden soll
Klicken Sie auf + Neuen Parameter hinzufügen, um so viele Zuordnungen wie nötig hinzuzufügen. Jede erstellt eine benannte Variable, die in nachgelagerten Aktionen und Skripten referenziert werden kann.
💡 TIPP: Ordnen Sie jeden Wert zu, den Ihr externes System in der Webhook-Payload sendet — Ticketnummern, Client-IDs, Geräte-Metadaten, alles — und referenzieren Sie ihn in Skriptaktionen oder Benachrichtigungsmeldungen weiter unten in der Pipeline.
Bedingung
Sie müssen eine Bedingung auswählen, um den Auslöser zu speichern. Wählen Sie Alle Geräte oder begrenzen Sie den Bereich, um bestimmte Geräte anzusprechen, wenn der Webhook ausgelöst wird.
Für die vollständige Bedingungsreferenz siehe Auslöserbedingungen.
Zusätzliche Optionen
Erweitern Sie Zusätzliche Optionen, um einen optionalen Auslösernamen festzulegen und den Auslöser mit dem Schalter Aktiviert ein- oder auszuschalten.
Auslösername — Ersetzt die Standardbezeichnung auf der Auslöserkarte der Pipeline.
Aktiviert — Wenn ausgeschaltet, wird der Auslöser nicht ausgelöst, auch wenn die URL eine gültige Anfrage erhält.
FAQ
Wo finde ich die Webhook-URL, nachdem ich den Auslöser gespeichert habe? Öffnen Sie die Automatisierung im Bearbeitungsmodus und klicken Sie auf die Webhook-Auslöserkarte. Die URL wird im Abschnitt Schrittkonfiguration mit einer Kopieren-Schaltfläche angezeigt.
Welche HTTP-Methode erwartet der Webhook? GET und POST werden beide akzeptiert.
Kann ich dieselbe Webhook-URL verwenden, um die Automatisierung mehrmals auszulösen? Ja. Die URL ist persistent, solange der Auslöser vorhanden ist. Jede gültige Anfrage an diese URL löst die Automatisierung aus, vorausgesetzt, das Gerät befindet sich nicht bereits in einer aktiven Ausführung für diesen Auslöser.
Was passiert, wenn der Webhook ausgelöst wird, während sich ein Gerät bereits in einer aktiven Ausführung befindet? Ein Gerät kann nur in einer aktiven Ausführung pro Auslöser sein. Wenn der Webhook erneut ausgelöst wird, während das Gerät bereits läuft, wird die neue Anfrage für dieses Gerät ignoriert. Wenn sich das Gerät nicht in einer Ausführung befindet, wird es normal ausgelöst.
Welches Format sollte die Webhook-Payload haben? JSON. Senden Sie einen JSON-Body mit den Schlüsseln, die Sie den Automatisierungsvariablen zuordnen möchten.
Wer kann Auslöser für eine Automatisierung hinzufügen oder bearbeiten? Admin-Benutzer können immer Auslöser hinzufügen. Nicht-Admin-Benutzer benötigen die Berechtigung Automatisierungen verwalten in ihrer Rolle sowie Zugriff auf die Automatisierungsgruppe. Wenn eine Automatisierung noch keine Auslöser hat, kann jeder Benutzer mit Gruppenzugriff die erste hinzufügen.