Einführung
Der Webhook-Trigger ermöglicht es jedem externen System, eine Level-Automatisierung per HTTP-Anfrage auszulösen. Wenn Sie diesen Trigger speichern, generiert Level eine eindeutige URL. Senden Sie eine POST-Anfrage an diese URL und die Automatisierung wird ausgeführt.
Verwenden Sie ihn, um Level mit Tools zu integrieren, die ausgehende Webhooks unterstützen – PSA-Plattformen, Überwachungssysteme, externe Skripte oder alles, was einen HTTP-Aufruf durchführen kann.
ℹ️ HINWEIS: Das Hinzufügen nicht-manueller Trigger erfordert entweder Administratorstatus oder eine Rolle mit der Automatisierungen verwalten Berechtigung. Wenn Sie die Automatisierung sehen können, aber keine Trigger hinzufügen können, überprüfen Sie die Berechtigungen Ihrer Rolle mit Ihrem Administrator. Siehe Arbeitsbereich → Berechtigungen für Details.
Webhook-Trigger
Webhook-URL generieren
Die Webhook-URL wird erstellt, wenn Sie den Trigger speichern – sie existiert davor nicht. Klicken Sie auf Speichern und Level generiert ein eindeutiges Token, das an diesen Trigger gebunden ist.
⚠️ WARNUNG: Das Löschen dieses Triggers löscht auch das eindeutige Token. Jedes externe System, das auf diese URL verweist, hört sofort auf zu funktionieren. Wenn Sie das Token neu generieren müssen, löschen Sie den Trigger und erstellen Sie ihn neu, dann aktualisieren Sie die URL in Ihrem externen System.
Einen Autorisierungs-Header anfordern
Aktivieren Sie Einen Autorisierungs-Header anfordern um token-basierte Authentifizierung zum Endpunkt hinzuzufügen. Wenn aktiviert, müssen Anfragen den Autorisierungsschlüssel im Anfrage-Header enthalten – nicht authentifizierte Anfragen werden abgelehnt.
Verwenden Sie einen schreibfähigen API-Schlüssel mit Lesen und Schreiben Zugriff von derselben Level-Organisation wie der Webhook-Trigger. Ein schreibgeschützter Schlüssel wird mit HTTP 403 abgelehnt: This API key does not have write permissions.
Wenn Sie keinen schreibfähigen Schlüssel haben, erstellen Sie einen oder bearbeiten Sie einen vorhandenen Schlüssel unter Einstellungen → API-Schlüssel. Siehe Einstellungen für API-Schlüssel.
Der cURL-Befehl unterhalb der URL wird automatisch aktualisiert, um den -H "Authorization: ..." Header, wenn diese Option aktiviert ist. Kopieren Sie den vollständigen cURL-Befehl als Referenz bei der Konfiguration Ihres externen Systems.
💡 TIPP: Aktivieren Sie den Autorisierungs-Header für jeden Webhook-Endpunkt, der über das öffentliche Internet erreichbar ist. Dadurch wird sichergestellt, dass nur Systeme mit dem Schlüssel die Automatisierung auslösen können.
Parameter-Zuordnung
Ordnen Sie Schlüssel aus der eingehenden JSON-Nutzlast Automatisierungsvariablen zu, damit Ihre Aktionen und Skripte diese Daten verwenden können.
Jede Zuordnungszeile hat zwei Felder:
Parameterschlüssel — Ein Schlüsselname aus der eingehenden JSON-Nutzlast (z. B.
device_id,ticket_number)Automatisierungsvariablen — Der Variablenname, dem in der Automatisierungspipeline zugeordnet werden soll
Klicken Sie auf + Neuen Parameter hinzufügen um so viele Zuordnungen wie nötig hinzuzufügen. Jede erstellt eine benannte Variable, auf die in nachgelagerten Aktionen und Skripten verwiesen werden kann.
💡 TIPP: Ordnen Sie jeden Wert zu, den Ihr externes System in der Webhook-Nutzlast sendet – Ticketnummern, Client-Identifikatoren, Gerätemetadaten, alles – und referenzieren Sie ihn in Skriptaktionen oder Benachrichtigungsnachrichten weiter unten in der Pipeline.
Bedingung
Sie müssen eine Bedingung auswählen, um den Trigger zu speichern. Wählen Sie Alle Geräte oder schränken Sie den Bereich ein, um bestimmte Geräte anzusprechen, wenn der Webhook ausgelöst wird.
Die vollständige Bedingungsreferenz finden Sie unter Trigger-Bedingungen.
Zusätzliche Optionen
Erweitern Sie Zusätzliche Optionen um einen optionalen Triggername und schalten Sie den Trigger mit dem Aktiviert Schalter.
Triggername — Ersetzt die Standardbezeichnung auf der Pipeline-Triggerkarte.
Aktiviert — Wenn deaktiviert, wird der Trigger nicht ausgelöst, auch wenn die URL eine gültige Anfrage empfängt.
Häufig gestellte Fragen
Wo finde ich die Webhook-URL, nachdem ich den Trigger bereits gespeichert habe? Öffnen Sie die Pipeline, wählen Sie den gespeicherten Webhook-Trigger aus und klicken Sie auf Trigger bearbeiten. Klicken Sie im Konfigurationsformular auf Kopieren neben der Webhook-URL.
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 dauerhaft, solange der Trigger existiert. Jede gültige Anfrage an diese URL löst die Automatisierung aus, sofern das Gerät nicht bereits in einem aktiven Durchlauf für diesen Trigger ist.
Was passiert, wenn der Webhook ausgelöst wird, während ein Gerät bereits in einem aktiven Durchlauf ist? Ein Gerät kann jeweils nur in einem aktiven Durchlauf pro Trigger sein. Wenn der Webhook erneut ausgelöst wird, während dieses Gerät bereits läuft, wird die neue Anfrage für dieses Gerät ignoriert. Wenn das Gerät sich gerade nicht in einem Durchlauf befindet, wird er normal ausgelöst.
In welchem Format sollte die Webhook-Nutzlast vorliegen? JSON. Senden Sie einen JSON-Body mit den Schlüsseln, die Sie Automatisierungsvariablen zuordnen möchten.
Wer kann Trigger für eine Automatisierung hinzufügen oder bearbeiten? Administratoren können immer Trigger hinzufügen. Nicht-Administrator-Benutzer benötigen die Automatisierungen verwalten Berechtigung für ihre Rolle sowie Zugriff auf die Gruppe der Automatisierung. Wenn eine Automatisierung noch keine Trigger hat, kann jeder Benutzer mit Gruppenzugriff den ersten hinzufügen.