Workiva 支援中心

Webhook 是自動發送內容（或稱「有效負載」）到唯一 URL 的訊息。使用 HTTP Webhook 觸發事件，您可以在 webhook URL 收到HTTP POST 請求並帶有 JSON 有效負載時自動啟動連鎖。然後，您可以使用連鎖的指令將 JSON 負載作為資料輸出，例如插入試算表。

 

要求

• 使用此觸發事件前，必須先設定HTTP Request 連接器 。
   

使用觸發事件啟動連鎖

當您將觸發事件新增至鏈中時，它會自動產生 webhook URL 以接收 JSON 有效負載。

1. 移至Chain Builder ，並選擇您想使用的連鎖。
2. 從左側功能表搜尋Trigger Event play_for_work ，然後將HTTP Webhook play_for_work 指令拖曳到畫布上Start 的位置。
   
3. 選取HTTP Webhook 節點，然後按編輯 建立 。
4. 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別事件。
   
5. 在Trigger Event Details 下 ，选择HTTP Request 连接器和 CloudRunner 与事件一起使用。

6. 輸入用於保護 webhook URL 的承載令牌。

   注意： 將承載令牌視為密碼。建立一個難以猜測的標記，並將其安全地儲存。

7. 按一下「儲存」(Save)。

使用 HTTP POST 請求呼叫 webhook

對於啟動鏈的觸發事件，HTTP POST 請求必須包括：

• webhook URL
• 內容類型；例如，application/json; charset=UTF-8
• URL 的傳送者標記
• 一個 JSON 物件，即使是空的 ({})

例如：

curl --location --request POST 'webhookUrl' \ --header 'Authorization：Bearer bearerToken' \ --header 'Content-Type: application/json' \ --data-raw '{}' curl --location --request POST 'webhookUrl