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}" }

注:

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