Webhook

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

主题：

webhook是由事件触发的HTTP调用。您可以使用Webhook激活即时触发器模块。任何连接到Internet并允许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
产品	如果贵组织具有不包含Workfront Automation and Integration的Select或Prime Workfront包，则贵组织必须购买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表示成功（例如，200表示正常），3xx表示重定向（例如，307表示临时重定向），4xx表示客户端错误（例如，400表示错误请求）等等。

Body字段包含webhook调用将接受的任何内容。它可以是简单文本、HTML、XML、JSON等。

note tip
TIP
我们建议将`Content-Type`标头设置为相应的MIME类型：纯文本为`text/plain`，HTML为`text/html`，JSON为`application/json`，XML为`application/xml`，依此类推。有关MIME类型的详细信息，请参阅MIME模块。