Webhook

Der Webhook-Trigger empfängt JSON und andere Daten im Text einer HTTP-POST-, PUT- oder DELETE-Anforderungsnachricht.

Damit der Webhook einen Anforderungstext im JSON-Format empfängt, müssen Sie das Nachrichtenschema so konfigurieren, dass es mit den erwarteten Daten übereinstimmt (siehe Ausgabeattribute unten).

Der Webhook-Trigger hat zwei Ausgabeports. Der Erfolgsport (✔) kann eine Nachricht senden, wenn der Trigger erfolgreich initiiert wurde. Der Fehlerport (X) kann eine Nachricht senden, wenn die Auslösung des Triggers fehlschlägt.

Parameter

• Webhook-URL: Die URL des Webhooks. Dieser Parameter wird automatisch generiert, wenn Sie den Workflow speichern. Nach der Generierung können Sie zum Kopieren auf das Zwischenablagesymbol klicken.
• Erfordert Authentifizierung: Wenn diese Option aktiviert ist, kann der Benutzer, der auf dieWebhook-URL muss Webhooks habenErlaubnis auf dem Webhook-Trigger.

Ausgabeattribute

Siehe auch

• Arbeiten mit Ausgabeattributen in Automatisierungs-Workflows.

Konfigurieren des Webhook-Schemas

Damit der Webhook einen Anforderungstext im JSON-Format empfängt, müssen Sie das Nachrichtenschema wie folgt so konfigurieren, dass es den erwarteten Daten entspricht:

1. Unter demAusgabeattribute aufParameter aus JSON importieren.
2. Geben Sie im Dialogfeld „Parameter aus JSON importieren“ ein gültiges JSON-Schema ein und klicken Sie aufParse.
NotizDer Parser analysiert nur Schlüssel der obersten Ebene. Um auf den Inhalt verschachtelter Arrays und Objekte zuzugreifen,workspace, verwenden Sie JSON-Manipulationstransformatoren.

Die importierten Parameter erscheinen unter "Webhook-Attribute", mit dem PräfixWebhookübergeordnete Eigenschaft.

Andere Attribute

Attribut	Beschreibung
Zeit	Ereigniszeit
Quelle	Ereignistyp
Fehlertyp	(Nur Fehlerport) Fehlertyp: Ungültige Nachricht: Beim Konfigurieren dieser Komponente ist ein Fehler aufgetreten, z. B. fehlende oder fehlerhafte Werte. DeadLetter: Beim Herstellen einer Verbindung mit einer externen Ressource ist ein Fehler aufgetreten. Beispiele hierfür können Verbindungsprobleme, ungültige Anmeldeinformationen oder allgemeine Ausnahmen bei externen Ressourcen sein.
Fehlermeldung	(Nur Fehlerport) Fehlermeldung
Nachricht	(Nur Erfolgsport) Nachrichteninhalt
webhook.headers	(Nur Erfolgsport) Die Header in der HTTP-Anforderung in Form einer JSON-Zeichenfolge.
webhook.method	(Nur Erfolgsport) Die HTTP-Anforderungsmethode, die den Webhook ausgelöst hat: POST, PUT oder DELETE.

Arbeiten mit Nicht-JSON-Daten

Zusätzlich zu Daten im JSON-Format können Webhook-Trigger Text, XML und andere Daten empfangen. In der folgenden Tabelle wird erläutert, wie Nicht-JSON-Daten zur Ausgabe von Attributen formatiert werden.

Inhaltstyp	Nachrichtencodierung
Text/*	Bleibt im Text zumNachrichtAttribut.
application/xml	Formatiert als Text zumNachrichtAttribut.
Anwendung/x-www-form-urlencoded	Formatiert als Text in dieNachrichtAttribut.
application/* oder andere	Base64 zumNachrichtAttribut.