Verwenden des Webhook-Connectors

Erstellen Sie eine Verbindung

1. Suchen Sie den HTTP Webhook-Connector im Integration Service-Katalog.

2. Wählen Sie Verbindung mit HTTP-Webhook herstellen aus .

3. Auf dem Verbindungsbildschirm müssen Sie die Anwendung angeben, z. B. UiPath Forum.

   

4. Starten Sie in Studio Ihren Workflow über ein Webhook-Ereignis. Wählen Sie Webhook-Ereignis passiert als Trigger für Ihre Automatisierung aus.

Hinweis:

Eine Verbindung ist lediglich eine Referenz, die in Workflows wiederverwendet werden kann. Er ist an dieselbe öffentlich zugängliche URL gebunden. Sie können diese Verbindung in einem Ordner erstellen, sodass andere auch Workflows basierend auf denselben eingehenden Webhook-Ereignissen erstellen können.

Kopieren Sie die verfügbar gemachte URL in Ihre Anbieteranwendung

Sobald eine Verbindung erstellt wurde, zeigt die Ereignisaktivität die Webhook-URL an. Sie müssen diese URL in die Anbieteranwendung kopieren.

Definieren Sie Filter

Anbieteranwendungen senden unterschiedliche Nutzlaststrukturen oder Nutzlasttypen, abhängig vom Ereignis, das behandelt wird. Alle diese können über dieselbe URL gesendet werden, die von der Triggeraktivität offengelegt wird. Sie unterscheiden zwischen Nutzdaten, indem Sie zu Beginn Ihres Prozesses Filter definieren.

Beispiel: Bei einer Nutzlast, die eine event_type für new_post, updated_post, admin_removal im Forum enthält, können Sie bestimmte veröffentlichte Workflows steuern, die ausgelöst werden, oder andere ignorieren. Filtern bietet vollständigen Zugriff sowohl auf den Text als auch auf die Header, die vom Anbieter am Webhook gesendet werden.

Hinweis:

Definieren Sie die Text- und Header-Filter mit Kleinbuchstaben und Anführungszeichen.

Definieren Sie Debugging-Nutzdaten

Dieser Schritt ist optional. Sie können eine perfekte Ausführung während der Entwurfszeit simulieren, indem Sie eine JSON-Beispielnutzlast für Text und/oder Header hinzufügen. Diese Nutzdaten werden als Ausgabe der Aktivität gespeichert und können später als Variablen verwendet werden.

Veröffentlichen

Veröffentlichen Sie Ihren Workflow ausgehend von einem HTTP Webhook-Ereignis, um die öffentlich zugängliche URL zu aktivieren. Sie können dies dann testen, indem Sie Ereignisse in der Anbieteranwendung auslösen oder einen direkten curl -Befehl an die URL senden:

Automation Cloud:

curl -X POST https://cloud.uipath.com/{entity_url} -d "example             curl call"

Automation Cloud – öffentlicher Sektor:

curl -X POST https://govcloud.uipath.us/{entity_url} -d "example            curl call"

Wenn der Integration Service das Ereignis akzeptiert, antwortet er mit den folgenden JSON-Nutzdaten zurück:

{ "webhookEventId": "wr-4ad55717e1.a7bbf1e8-72a1-4371-82d2-d{example}", "correlationId": "384d496c-2f6d-{example}" }

Hinweis:

Diese Nutzlast ist nützlich zum Testen, aber nirgendwo in Ihrem Workflow erforderlich.