Einführung
Der Webhook-Auslöser ermöglicht es jedem externen System, eine Level-Automatisierung per 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 ihn, um Level mit Tools zu integrieren, die ausgehende Webhooks unterstützen – PSA-Plattformen, Überwachungssysteme, externe Skripte oder alles, was HTTP-Anfragen senden kann.
ℹ️ HINWEIS: Das Hinzufügen nicht-manueller Auslöser erfordert entweder Administratorstatus oder eine Rolle mit der Automatisierungen verwalten Berechtigung. Wenn Sie die Automatisierung sehen können, aber keine Auslöser hinzufügen können, prüfen Sie die Berechtigungen Ihrer Rolle bei Ihrem Administrator. Siehe Arbeitsbereich → Berechtigungen für Details.
Webhook-Auslöser
Webhook-URL generieren
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 Sie den Auslöser und erstellen Sie ihn neu, und aktualisieren Sie dann die URL in Ihrem externen System.
Einen Autorisierungs-Header voraussetzen
Aktivieren Sie Autorisierungs-Header voraussetzen 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 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 für die Konfiguration Ihres externen Systems.
💡 TIPP: Aktivieren Sie den Autorisierungs-Header für jeden Webhook-Endpunkt, der über das öffentliche Internet erreichbar ist. So wird sichergestellt, dass nur Systeme mit dem Schlüssel die Automatisierung auslösen können.
Parameterzuordnung
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 wird
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-Nutzlast sendet – Ticketnummern, Client-Kennungen, 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 Auslöser zu speichern. Wählen Sie Alle Geräte oder den Bereich einschränken, um bestimmte Geräte anzusprechen, wenn der Webhook ausgelöst wird.
Die vollständige Bedingungsreferenz finden Sie unter Auslöserbedingungen.
Zusätzliche Optionen
Erweitern Sie Zusätzliche Optionen um einen optionalen Auslösername und den Auslöser mit dem Aktiviert Schalter.
Auslösername — Ersetzt die Standardbezeichnung auf der Pipeline-Auslöserkarte.
Aktiviert — Wenn deaktiviert, wird der Auslöser nicht ausgelöst, auch wenn die URL eine gültige Anfrage erhält.
Häufig gestellte Fragen
Wo finde ich die Webhook-URL, nachdem ich den Auslöser bereits 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.
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 bleibt bestehen, solange der Auslöser 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 Auslöser ist.
Was passiert, wenn der Webhook ausgelöst wird, während sich ein Gerät bereits in einem aktiven Durchlauf befindet? Ein Gerät kann sich jeweils nur in einem aktiven Durchlauf pro Auslöser befinden. Wenn der Webhook erneut ausgelöst wird, während das Gerät bereits einen Durchlauf ausführt, wird die neue Anfrage für dieses Gerät ignoriert. Wenn das Gerät sich nicht in einem Durchlauf befindet, wird er normal ausgelöst.
In welchem Format sollte die Webhook-Nutzlast vorliegen? JSON. Senden Sie einen JSON-Textkörper mit den Schlüsseln, die Sie Automatisierungsvariablen zuordnen möchten.
Wer kann Auslöser für eine Automatisierung hinzufügen oder bearbeiten? Administratoren können immer Auslöser hinzufügen. Nicht-administrative Benutzer benötigen die Automatisierungen verwalten Berechtigung für ihre Rolle sowie Zugriff auf die Gruppe der Automatisierung. Wenn eine Automatisierung noch keine Auslöser hat, kann jeder Benutzer mit Gruppenzugriff den ersten hinzufügen.