Webhook コネクタを使用する

コネクションを作成する

HTTP Webhook コネクタは、Integration Service カタログで確認できます。
[ HTTP Webhook に接続] を選択します。
コネクション画面では、アプリケーション (例: UiPath フォーラム) を指定する必要があります。
Studio で、Webhook イベントからワークフローを開始します。オートメーションのトリガーとして [ Webhook イベントの発生時] を選択します。

注:

コネクションは、ワークフロー間で再利用できる単なる参照です。これは、同じ一般向け URL に関連付けられています。

このコネクションをフォルダー内に作成すると、他のユーザーも同じ受信 Webhook イベントに基づいてワークフローを構築できます。

公開された URL をベンダーアプリケーションにコピーします

コネクションが作成されると、イベントアクティビティに Webhook URL が表示されます。この URL をベンダーアプリケーションにコピーする必要があります。

フィルターを定義する

ベンダーアプリケーションは、対処されるイベントに応じて、異なるペイロード構造またはペイロードタイプを送信します。これらはすべて、トリガーアクティビティが公開するのと同じ URL を介して送信できます。ペイロードを区別するには、プロセスの開始時にフィルターを定義します。

たとえば、フォーラムのnew_post, updated_post, admin_removalのevent_typeを含むペイロードの場合、特定の公開済みワークフローをトリガーしたり、他のワークフローを無視したりできます。フィルター処理により、ベンダーが Webhook で送信する本文とヘッダーの両方にフルアクセスできます。

メモ：本文フィルターとヘッダーフィルターを小文字と引用符を使用して定義します。

デバッグペイロードの定義

この手順は任意です。本文やヘッダーのサンプル JSON ペイロードを追加することで、設計時に完璧な実行をシミュレートできます。このペイロードはアクティビティの出力として保存され、後で変数として使用できます。

公開

HTTP Webhook イベントからワークフローをパブリッシュして、一般公開 URL をアクティブ化します。次に、ベンダーアプリケーションでイベントをトリガーするか、URLに直接 curl コマンドを送信して、これをテストできます。

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

Integration Service がイベントを受け入れると、次の JSON ペイロードで応答を返します。

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