Introduction
Der Webhook-Trigger ermöglicht es jedem externen System, eine Level-Automatisierung über eine HTTP-Anforderung auszulösen. Wenn Sie diesen Trigger speichern, generiert Level eine eindeutige URL. Senden Sie eine POST-Anforderung 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, das HTTP-Aufrufe durchführen kann.
ℹ️ NOTE: Das Hinzufügen von nicht-manuellen Triggern erfordert entweder Admin-Status oder eine Rolle mit der Manage automations 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. SieheWorkspace → Berechtigungen for details.
Webhook Trigger
Generating the Webhook URL
Die Webhook-URL wird beim Speichern des Triggers erstellt — sie existiert nicht davor. Klicken Sie auf Save und Level generiert ein eindeutiges Token, das an diesen Trigger gebunden ist.
⚠️ WARNING:Das Löschen dieses Triggers löscht auch das eindeutige Token. Jedes externe System, das auf diese URL zeigt, wird sofort deaktiviert. Wenn Sie das Token neu generieren müssen, löschen und erstellen Sie den Trigger neu, und aktualisieren Sie dann die URL in Ihrem externen System.
Requiring an Authorization Header
Check Require an authorization header um tokenbasierte Authentifizierung zum Endpunkt hinzuzufügen. Wenn aktiviert, müssen Anforderungen den Authentifizierungsschlüssel im Anforderungs-Header enthalten — nicht authentifizierte Anforderungen werden abgelehnt.
Der cURL-Befehl unterhalb der URL wird automatisch aktualisiert, um den -H "Authorization: ..."Header zu enthalten, wenn diese Option aktiviert ist. Kopieren Sie den vollständigen cURL-Befehl als Referenz bei der Konfiguration Ihres externen Systems.
💡 TIP:Aktivieren Sie den Authentifizierungs-Header für jeden Webhook-Endpunkt, der vom öffentlichen Internet aus erreichbar ist. Es stellt sicher, dass nur Systeme mit dem Schlüssel die Automatisierung auslösen können.
Parameter Mapping
Ordnen Sie Schlüssel aus der eingehenden JSON-Payload zu Automatisierungsvariablen zu, damit Ihre Aktionen und Skripte diese Daten verwenden können.
Each mapping row has two fields:
Parameter key — Ein Schlüsselname aus der eingehenden JSON-Payload (z. B.
device_id,ticket_number)Automation variables — Der Variablenname, dem in der Automatisierungs-Pipeline zugeordnet werden soll
Click + Add new parameter um so viele Zuordnungen wie nötig hinzuzufügen. Jede erstellt eine benannte Variable, auf die in nachgelagerten Aktionen und Skripten verwiesen werden kann.
💡 TIP:Ordnen Sie jeden Wert, den Ihr externes System in der Webhook-Payload sendet — Ticketnummern, Client-Identifizierer, Geräte-Metadaten, alles — zu und referenzieren Sie ihn in Skriptaktionen oder Benachrichtigungsmeldungen weiter unten in der Pipeline.
Condition
Sie müssen eine Bedingung auswählen, um den Trigger zu speichern. Wählen Sie All devices oder grenzen Sie den Bereich ein, um bei Auslösung des Webhooks auf bestimmte Geräte zu zielen.
For the full condition reference, see Trigger Conditions .
Additional Options
Expand Additional options to set an optional Trigger name und schalten Sie den Trigger mit demEnabled switch.
Trigger name — Ersetzt das Standardlabel auf der Pipeline-Trigger-Karte.
Enabled— Wenn deaktiviert, wird der Trigger nicht ausgelöst, auch wenn die URL eine gültige Anforderung erhält.
FAQ
Wo finde ich die Webhook-URL, nachdem ich den Trigger bereits gespeichert habe? Öffnen Sie die Automatisierung im Bearbeitungsmodus und klicken Sie auf die Webhook-Trigger-Karte. Die URL wird im Abschnitt Schrittekonfiguration mit einemCopy button.
Welche HTTP-Methode erwartet der Webhook? GET and POST are both accepted.
Kann ich die gleiche Webhook-URL verwenden, um die Automatisierung mehrmals auszulösen? Ja. Die URL ist persistent, solange der Trigger existiert. Jede gültige Anforderung an diese URL löst die Automatisierung aus, sofern das Gerät nicht bereits in einem aktiven Durchlauf für diesen Trigger vorhanden 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 pro Trigger nur in einem aktiven Durchlauf befinden. Wenn der Webhook erneut ausgelöst wird, während dieses Gerät bereits läuft, wird die neue Anforderung für dieses Gerät ignoriert. Wenn sich das Gerät nicht in einem Durchlauf befindet, wird es normal ausgelöst.
In welchem Format sollte die Webhook-Payload sein? 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? Admin-Benutzer können jederzeit Trigger hinzufügen. Nicht-Admin-Benutzer benötigen die Manage automations Berechtigung auf ihrer Rolle und Zugriff auf die Gruppe der Automatisierung. Wenn eine Automatisierung noch keine Trigger hat, kann jeder Benutzer mit Gruppenzugriff den ersten hinzufügen.