Über den HTTP Webhook-Connector

Konfigurieren Sie den HTTP Webhook-Connector in Integration Service so, dass er ereignisgesteuerte Rückrufe in Echtzeit von externen Anwendungen ohne Abfrage erhält.

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-Nutzlasten werden auf die gleiche Weise wie alle anderen Triggerereignisse verarbeitet. Der Connector unterstützt auch die optionale headerbasierte Authentifizierung, bei der sich der Anbieter bei jeder Webhook-Bereitstellung mit einem konfigurierten Header-Wert bei UiPath authentifizieren kann.

Weitere Informationen finden Sie unter Verwenden des Webhook-Connectors.

Informationen zum Erstellen einer Verbindung und zum Konfigurieren der Herausforderungsüberprüfung, falls vom Anbieter benötigt, finden Sie unter HTTP Webhook-Authentifizierung.

Sicherheit

Der HTTP Webhook-Connector bietet zwei sich ergänzende Sicherheitsmechanismen, die beide zum Zeitpunkt der Erstellung der Verbindung konfiguriert werden:

Mechanismus	Was es tut	Einsatzbereich
Verifizierung herausfordern	Lassen Sie den Anbieter bestätigen, dass Ihre UiPath Webhook-URL gültig ist, bevor Ereignisse gesendet werden.	Wenn der Anbieter einen Handshake erfordert (Slack, Meta usw.).
Header-basierte Authentifizierung	Validiert jede eingehende Webhook-Anforderung mithilfe eines gemeinsamen Geheimnisses in einem HTTP-Header (z. B. X-API-Key). Anforderungen, die nicht den konfigurierten Header-Wert enthalten, werden mit HTTP 401 abgelehnt.	Wenn Sie verhindern möchten, dass unbefugte Anrufer an Ihre Webhook-URL posten, und Ihr Anbieter Ihnen die Konfiguration eines benutzerdefinierten Headers für ausgehende Webhook-Zustellungen ermöglicht.

Weitere Informationen zur Einrichtung finden Sie unter HTTP Webhook-Authentifizierung.

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.
• Die maximal unterstützte Größe der Webhook-Nutzlast beträgt 14 MB. Anforderungen, die diesen Grenzwert überschreiten, werden abgelehnt und es wird kein Triggerereignis versendet.

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.

Kann ich vom Anbieter eine Authentifizierung erwarten, wenn Webhook-Ereignisse an UiPath gesendet werden?

Ja. Aktivieren Sie die Header-basierte Authentifizierung beim Erstellen oder Bearbeiten der Verbindung und konfigurieren Sie dann den passenden Header in den Webhook-Einstellungen des Anbieters. Anweisungen zur Einrichtung finden Sie unter HTTP Webhook-Authentifizierung.

Mein Anbieter verwendet sein eigenes Signaturschema (z. B. X-Hub-Signature-256). Kann ich weiterhin die Header-basierte Authentifizierung verwenden?

Nein. Die Header-basierte Authentifizierung verwendet einen statischen, vorab freigegebenen Header-Wert. Signaturbasierte Anbieter berechnen bei jeder Anforderung einen neuen MHAC mithilfe der Nutzlast und eines gemeinsamen Geheimnisses – UiPath validiert derzeit keine anbieterspezifischen Signaturen. Für diese Anbieter sind die verfügbaren Sicherheitsmechanismen das URL-Geheimnis und der Handshake zur Herausforderungsverifizierung des Anbieters.