Über den HTTP Webhook-Connector

Mithilfe von Webhooks können Anwendungen externe Systeme in Echtzeit benachrichtigen, wodurch die Notwendigkeit häufiger Abfragen reduziert und API-Aufrufe minimiert werden. Anstatt regelmäßig nach Aktualisierungen zu suchen, erhält das System ereignisbasierte Rückrufe nur dann, wenn relevante Änderungen auftreten.

Mit dem UiPath HTTP Webhook-Connector können Sie Workflows direkt aus Anbieteranwendungen auslösen. Sie können sofortige Trigger für Ereignisse für jede Drittanbieteranwendung erstellen, die ausgehende Webhook-Benachrichtigungen unterstützt, auch wenn sie nicht Teil des Connector-Katalogs ist.

Sie können auch Ereignisdatenfilter anwenden, um die genauen Bedingungen anzugeben, unter denen ein Webhook-Ereignis einen Workflow auslösen soll.

Wie es funktioniert

Der HTTP Webhook- Trigger generiert eine dynamische öffentliche Rückruf-URL. Kopieren und konfigurieren Sie diese URL in den Webhook-Einstellungen der Anbieteranwendung erst, nachdem Ihr Trigger im Orchestrator erstellt wurde.

Wenn ein Ereignis im Anbietersystem auftritt:

1. Der Anbieter sendet die Ereignisnutzlast an die konfigurierte URL.
2. Integration Service empfängt die Nutzlast und wertet sie anhand Ihrer konfigurierten Ereignisdatenfilter aus.
3. Wenn eine Übereinstimmung gefunden wird, löst der Integration Service die Workflowausführung über den Orchestrator aus.

Webhook-Nutzdaten werden auf die gleiche Weise wie alle anderen Triggerereignisse verarbeitet.

Weitere Informationen finden Sie unter Verwenden des Webhook-Connectors.

Wenn der Anbieter einen Handshake erfordert, konfigurieren Sie die Herausforderungsverifizierung. Weitere Informationen finden Sie unter Verifizierung der Webhook-Herausforderung.

Ratenlimits

Von Webhook ausgelöste Ereignisse unterliegen den folgenden Einschränkungen:

• 500 Ereignisse pro Minute und Mandant
• 100 Ereignisse pro Minute und Verbindung

Einschränkungen

• Das Debuggen von Entwurfszeit-Triggern ist derzeit nicht verfügbar.
• Nur Anfragen im JSON-Format werden unterstützt.

Häufig gestellte Fragen

Ich habe die Webhook-URL in die Benutzeroberfläche des Anbieters eingefügt. Warum wird die Verifizierung immer noch nicht bestanden?

Die Verifizierung ist erst erfolgreich, nachdem der Trigger im Orchestrator erstellt wurde und Sie die Herausforderung richtig konfiguriert haben. Beachten Sie, dass UiPath keine Herausforderungsverifizierung auf unserer Seite durchführt – die Validierung erfolgt vollständig auf Seiten des Anbieters, um Vertrauen zum Ziel herzustellen.

Ich habe die Herausforderung falsch konfiguriert. Warum wird meine Verbindung trotzdem erfolgreich erstellt?

UiPath validiert derzeit nicht den Herausforderungs-/Verifizierungsschritt des Anbieters. Diese Validierung wird vollständig vom Anbieter durchgeführt. Infolgedessen kann die Verbindung in UiPath aktiv erscheinen, auch wenn die Herausforderungsüberprüfung des Anbieters tatsächlich fehlgeschlagen ist.

Wie verwende ich die Antwort eines in Orchestrator erstellten Webhooks?

Verwenden Sie die Aktivität Get Trigger Event Output in Ihrem Workflow und übergeben Sie UiPathEventObjectId (data type=Text) als Eingabeargument. Diese Aktivität gibt sowohl den Textkörper als auch die vom Webhook empfangenen Header zurück.

Die Webhook-Antwort ist eine JSON-Zeichenfolge. Wie verwende ich Teile davon in meinem Workflow?

Verwenden Sie die Aktivität Deserialize JSON, um die Zeichenfolge in ein JObjekt zu konvertieren, nach dem Sie einfach auf einzelne Felder zugreifen können.