HTTP Webhook

Set up an HTTP Webhook, as a trigger or a wait step, with its fields and the request data it outputs.

HTTP Webhook は、Webhook を送信できる任意のアプリにワークフローを接続します。Webhook は、何かが発生したときにアプリが Web アドレスに送信する要求です。ノードはそのアドレスを提供します。それを他のアプリに貼り付けると、そのアプリが送信する各要求がワークフローに到達します。

ノードは 2 つの場所に表示され、両方の場所で同じように機能します。

• トリガーとして、[ トリガーを変更 ] リストで、次の手順を実行します。 要求ごとに新しい実行が開始されます。
• 待機手順として、[ノードを追加] > [イベントを待機] で、要求が到着するまでノードで実行を一時停止し、その後続行します。

設定する

1. ノードをトリガーまたは待機ステップとして追加します。
2. In Connection, select an HTTP Webhook connection, or create one. Connection describes its fields.
3. パネル上部のボックスから Webhook URL をコピーし、他のアプリの Webhook 設定に貼り付けます。
4. 必要に応じてフィルター を追加して、一致する要求のみがカウントされるようにします。
   1. [ 条件を追加] または [ グループを追加] を選択します。
   2. [ すべて] (AND) または [ 任意] (OR) を選択します。
5. ワークフローをデプロイします。要求はデプロイ後にのみ UiPath に到達します。

フィールド

フィールド	Required	説明
Webhook URL	—	他のアプリに貼り付けるアドレスです。各ノードには独自のノードがあります。
コネクション	はい	要求を受信する HTTP Webhook 接続です。[スキーマを更新] は、受信データの形状を再読み込みします。
フィルター	いいえ	要求が一致する必要がある条件。一致しない要求は無視されます。
入力引数	いいえ	トリガーのみ。他のノードが $vars.<node ID>.outputで読み取る値。

コネクション

An HTTP Webhook connection receives the requests of one app. The webhook URL is created with the connection, so the node shows it only after the connection exists. Create a connection describes how to create a connection from the node. On the Connect to HTTP Webhook page, fill in these fields:

フィールド	エントリーする内容
Folder in which connection is stored	The folder that holds the connection.
What application is this webhook for?	A name for the app that sends the requests, such as Stripe-prod. It also becomes the connection identifier.
認証の種類	None, or Header Based Authentication to accept only requests that carry a header and value that you choose. Set the same header in the other app.
チャレンジの場所	No challenge, or where the app sends its verification challenge: Header, Body, or Query parameter.

With Header Based Authentication, a request without the matching header is rejected with the HTTP status 401.

Some apps, such as Slack, WhatsApp, and Stripe, check the webhook URL before they send events. They send a challenge, a value that the URL must return. If the app does this, select where the challenge arrives in Challenge location, then fill in the fields that appear, as the webhook documentation of the app describes. WhatsApp, for example, sends the challenge in the hub.challenge query parameter, and expects it back as plain text.

出力

The node's output is the request that the other app sent. Until the first request arrives, the node doesn't know its shape, so send one test request before you reference its fields in later nodes.

次のステップ

• トリガー: ワークフローを開始するその他の方法。
• 待機: 代わりに、設定した時間実行を一時停止します。
• ワークフローをデプロイする: Webhook を稼働中に設定します。
• コミュニティ: UiPath フォーラムで質問したり、他のビルダーとワークフローを共有したりできます。