Workiva サポートセンター

Webhookは、コンテンツ、つまり「ペイロード」を一意のURLに送信する自動化メッセージである。HTTP Webhook トリガーイベントを使用すると、Webhook URL が JSON ペイロードを持つHTTP POST リクエストを受信したときに、自動的にチェーンを開始することができます。JSONペイロードは、スプレッドシートに挿入するなど、チェーンのコマンドでデータ出力として使用できる。

 

要件

• このトリガーイベントを使用する前に、HTTP Request コネクター を設定する必要がある。
   

トリガーイベントでチェーンを開始する。

トリガーイベントをチェーンに追加すると、JSONペイロードを受信するためのWebhook URLが自動的に生成されます。

1. チェーンビルダー に移動し、作業したいチェーンを選択する。
2. 左側のメニューからTrigger Event play_for_work を検索し、HTTP Webhook play_for_work コマンドをキャンバスのStart の位置にドラッグします。
   
3. HTTP Webhook ノードを選択し、編集 作成 をクリックします。
4. [基本情報]で、イベントの識別に役立つ一意の名前と説明を入力します。
   
5. Trigger Event Details で、HTTP Request コネクターとイベントで使用する CloudRunner を選択します。

6. Webhook URL を保護するために使用するベアラートークンを入力します。

   メモ： ベアラートークンをパスワードと考える。推測されにくいトークンを作成し、安全に保存する。

7. [保存]をクリックします。

HTTP POSTリクエストでWebhookを呼び出す。

トリガーイベントがチェーンを開始するためには、HTTP POSTリクエストが含まれなければなりません：

• ウェブフックのURL
• コンテンツタイプ。例えば、application/json; charset=UTF-8
• URLのベアラートークン
• 空でもJSONオブジェクト ({})

例：

curl --location --request POST 'webhookUrl'  \ --header 'Authorization：ヘッダー 'Authorization: BearerToken' ￭ヘッダー 'Content-Type: application/json' ￭ --data-raw '{}'