Webhook コネクタを使用する

コネクションを作成する

1. HTTP Webhook コネクタは、Integration Service カタログで確認できます。

2. [ HTTP Webhook に接続] を選択します。

3. コネクション画面では、アプリケーション (例: UiPath フォーラム) を指定する必要があります。

   

4. 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"

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

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

注:

このペイロードはテストには便利ですが、ワークフロー内のどこにも必要ありません。