Webhook

Last update: Mon Nov 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

webhook是由事件觸發的HTTP呼叫。您可以使用Webhook來啟動即時觸發程式模組。任何連線至網際網路並允許HTTP請求的應用程式都可以將Webhook傳送至Adobe Workfront Fusion。

存取需求

展開以檢視本文中功能的存取需求。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront套件	任何Adobe Workfront Workflow套件和任何Adobe Workfront自動化與整合套件 Workfront Ultimate Workfront Prime和Select套件，以及額外購買的Workfront Fusion。
Adobe Workfront授權	標準工作或更高
Adobe Workfront Fusion授權	作業型：無Workfront Fusion授權需求以聯結器為基礎（舊版）：用於工作自動化和整合的Workfront Fusion
產品	如果您的組織有Select或Prime Workfront套件，但不包含Workfront Automation和Integration，則您的組織必須購買Adobe Workfront Fusion。

如需此表格中資訊的詳細資訊，請參閱檔案中的存取需求。

如需Adobe Workfront Fusion授權的相關資訊，請參閱Adobe Workfront Fusion授權。

在Workfront Fusion中使用webhook

NOTE

若要呼叫第三方webhook （傳出webhook），請使用其中一個HTTP模組。如需詳細資訊，請參閱HTTP模組。

若要使用webhook將應用程式連線至Workfront Fusion：

將Webhook > 自訂Webhook即時觸發模組新增至您的情境。
按一下Webhook欄位旁的新增，然後輸入新webhook的名稱。
（選擇性）按一下進階設定。
在 IP限制 欄位中，輸入模組可以接受資料的IP位址清單（以逗號分隔）。
如果您要驗證傳入的資料，請在 資料結構 欄位中，選取或新增您要使用的資料結構。

如需資料結構的詳細資訊，請參閱資料結構。
在認證欄位中，您可以輸入要用於授權的認證。若要輸入認證，請按一下新增並輸入認證資訊。
視需要啟用其他設定。
按一下儲存

建立webhook之後，會顯示唯一的URL。這是webhook傳送資料的地址。 Workfront Fusion會驗證傳送到此位址的資料，然後傳遞它以用於案例中的處理。

NOTE

建立webhook後，您可以一次用於多個情境。

設定webhook的資料結構 configure-the-webhook-s-data-structure

為了識別傳入裝載的資料結構，Workfront Fusion會剖析您傳送至顯示位址的範例資料。您可以變更服務或應用程式，讓該服務或應用程式呼叫webhook，以提供範例資料。例如，您可以移除檔案。

或者，您可以透過HTTP > 提出要求模組傳送範例資料：

使用HTTP > 提出要求模組建立新情境

使用下列值設定模組：

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
URL	輸入webhook的URL。您可以在用來設定webhook的Webhooks模組中找到此URL。
方法	POST
主體型別	Raw
內容型別	JSON (application/json)
要求內容	webhook中需要原始JSON

新畫面設定

在單獨的瀏覽器標籤或視窗中開啟具有Webhooks模組的情境。
在webhooks模組中，按一下重新決定資料結構。

您不需要從webhooks模組取消連結其他模組。
切換至具有HTTP模組的情境並執行它。
切換回使用Webhooks模組的情境。

「已成功判定」訊息表示模組已成功判定資料結構。
按一下確定以儲存資料結構。

webhook的專案現在可以在對應面板中使用，以便與案例中的後續模組一起使用。

webhook佇列

如果webhook收到資料，而且沒有作用中案例需要該資料，則資料會儲存在佇列中。啟用情境後，它會依序處理佇列中等待的所有組合。

IMPORTANT

Webhook佇列在使用相同webhook的情境之間共用。如果其中一個案例已停用，所有傳入資料都會保留在佇列中。

支援的傳入資料格式

Workfront Fusion支援3種傳入資料格式：查詢字串、表單資料和JSON。

Workfront Fusion會根據選取的資料結構驗證所有傳入的資料。然後，根據情境的設定，資料會儲存在佇列中以供處理，或立即處理。

如果資料的任何部分未通過驗證，Workfront Fusion會傳回400 HTTP狀態代碼，並在HTTP回應內文中指定傳入資料未通過驗證檢查的原因。如果傳入資料的驗證成功，Workfront Fusion會傳回"200 Accepted"狀態。

查詢字串
表單資料
JSON

查詢字串

GET https://app.workfrontfusion.com/wh/<yourunique32characterslongstring>?name=<yourname>&job=automate

表單資料

POST https://app.workfrontfusion.com/wh/<yourunique32characterslongstring>

Content-Type: application/x-www-form-urlencoded

name=<yourname>&job=automate

多部分表單資料

POST https://app.workfrontfusion.com/wh/<yourunique32characterslongstring>


Content-Type: multipart/form-data; boundary=---generatedboundary

---generatedboundary

Content-Disposition: form-data; name="file"; filename="file.txt"


Content-Type: text/plain


Content of file.txt


---generatedboundary

Content-Disposition: form-data; name="name"

Workfront Fusion

---generatedboundary

若要接收以multipart/form-data編碼的檔案，您必須使用collection型別欄位來設定資料結構，該欄位包含巢狀欄位name、mime和data。欄位name是text型別，包含上傳檔案的名稱。 mime是text型別，並包含MIME格式的檔案。欄位data是buffer型別，包含正在傳輸之檔案的二進位資料。

如需MIME格式的詳細資訊，請參閱MIME模組。

JSON

POST https://app.workfrontfusion.com/wh/<yourunique32characterslongstring>

Content-Type: application/json

{"name": "Workfront Fusion", "job": "automate"}

TIP

如果您想要存取原始JSON，請在設定webhook時啟用JSON傳遞。

按一下**[新增]**以新增新的webhook。
按一下顯示進階設定。
按一下JSON傳遞。

Webhook標題

若要存取webhook的標頭，請在設定webhook時啟用Get要求標頭。

按一下**[新增]**以新增新的webhook。
按一下顯示進階設定。
按一下取得要求標題。

您可以使用map()和get()函式的組合來擷取特定的標頭值。

INFO

範例：

下列範例顯示從authorization陣列中擷取Headers[]標頭值的公式。此公式會用於比較擷取值與指定文字的篩選中，以便只傳遞符合的Webhook。

如需有關使用指定索引鍵取得陣列元素的進一步資訊，請參閱對應陣列文章中的使用指定索引鍵對應陣列元素。

回應Webhook

webhook呼叫的預設回應是文字「已接受」。回應會傳回至應用程式，該應用程式會在執行自訂Webhook模組期間呼叫webhook。

測試對webhook的回應
HTML回應範例
重新導向範例

測試對webhook的回應

在您的情境中加入 自訂Webhook 模組。
將新的webhook新增至模組。
將webhook URL複製到剪貼簿。
執行情境。

自訂Webhook模組上的閃電圖示會變更為旋轉的點。這顯示模組現在正等候webhook呼叫。
開啟新的瀏覽器視窗，將複製的URL貼到網址列，然後按Enter。

已觸發自訂Webhook模組，瀏覽器將顯示新頁面。

如果要自訂webhook的回應，請採用模組Webhook回應。

模組的設定包含兩個欄位：狀態和內文。

Status欄位包含HTTP回應狀態代碼，例如，2xx代表Success （例如，200代表OK）、3xx代表Redirection （例如，307代表Temporary Redirect）、4xx代表Client errors （例如，400代表Bad Request）等等。

Body欄位包含webhook呼叫將接受的任何內容。可以是簡單文字、HTML、XML、JSON等。

note tip
TIP
我們建議將`Content-Type`標頭設定為對應的MIME型別： `text/plain` （純文字）、`text/html` (HTML)、`application/json` (JSON)、`application/xml` (XML)等等。如需MIME型別的詳細資訊，請參閱MIME模組。