HTTP-Webhook

Set up an HTTP Webhook, as a trigger or a wait step, with its fields and the request data it outputs.

HTTP-Webhook verbindet einen Workflow mit jeder App, die einen Webhook senden kann, eine Anfrage, die die App an eine Webadresse sendet, wenn etwas passiert. Der Knoten gibt Ihnen diese Adresse. Sie fügen es in die andere App ein und jede Anforderung, die es sendet, erreicht den Workflow.

Der Knoten wird an zwei Stellen angezeigt und funktioniert an beiden Stellen gleich:

• Als Trigger in der Liste Trigger ändern : Jede Anforderung startet eine neue Ausführung.
• Als Warteschritt in „Knoten hinzufügen“ > „Auf Ereignis warten“: Die Ausführung hält am Knoten an, bis eine Anforderung eintrifft, und wird dann fortgesetzt.

Richten Sie es ein

1. Fügen Sie den Knoten als Trigger oder als Warteschritt hinzu.
2. In Connection, select an HTTP Webhook connection, or create one. Connection describes its fields.
3. Kopieren Sie die Webhook-URL aus dem Feld oben im Bereich und fügen Sie sie in die Webhook-Einstellungen der anderen App ein.
4. Fügen Sie optional einen Filter hinzu, damit nur übereinstimmende Anforderungen gezählt werden:
   1. Wählen Sie Bedingung hinzufügen oder Gruppe hinzufügen aus.
   2. Wählen Sie Alle (UND) oder Beliebige (OR) aus.
5. Stellen Sie den Workflow bereit. Anforderungen erreichen ihn erst nach der Bereitstellung.

Felder

Feld	Erforderlich	Beschreibung
Webhook-URL	–	Die Adresse, die in die andere App eingefügt werden soll. Jeder Knoten hat seinen eigenen.
Verbindung (Connection)	Ja	Die HTTP Webhook-Verbindung, die die Anforderungen empfängt. Schema aktualisieren (Refresh Schema) lädt die Form der eingehenden Daten neu.
Filter	Nein	Bedingungen, die eine Anforderung erfüllen muss. Nicht übereinstimmende Anforderungen werden ignoriert.
Eingabeargumente	Nein	Nur Trigger. Werte, die andere Knoten unter $vars.<node ID>.output lesen.

Verbindung (Connection)

An HTTP Webhook connection receives the requests of one app. The webhook URL is created with the connection, so the node shows it only after the connection exists. Create a connection describes how to create a connection from the node. On the Connect to HTTP Webhook page, fill in these fields:

Feld	Was eingegeben werden soll
Folder in which connection is stored	The folder that holds the connection.
What application is this webhook for?	A name for the app that sends the requests, such as Stripe-prod. It also becomes the connection identifier.
Authentifizierungstyp	None, or Header Based Authentication to accept only requests that carry a header and value that you choose. Set the same header in the other app.
Herausforderungsort	No challenge, or where the app sends its verification challenge: Header, Body, or Query parameter.

With Header Based Authentication, a request without the matching header is rejected with the HTTP status 401.

Some apps, such as Slack, WhatsApp, and Stripe, check the webhook URL before they send events. They send a challenge, a value that the URL must return. If the app does this, select where the challenge arrives in Challenge location, then fill in the fields that appear, as the webhook documentation of the app describes. WhatsApp, for example, sends the challenge in the hub.challenge query parameter, and expects it back as plain text.

Ausgabe

The node's output is the request that the other app sent. Until the first request arrives, the node doesn't know its shape, so send one test request before you reference its fields in later nodes.

Nächste Schritte

• Trigger: Die anderen Möglichkeiten zum Starten eines Workflows.
• Verzögerung: Pausieren Sie stattdessen eine Ausführung für eine bestimmte Zeit.
• Bereitstellen eines Workflows: Machen Sie den Webhook live.
• Community: Stellen Sie Fragen und teilen Sie Workflows mit anderen Buildern im UiPath Forum.