Workiva支持中心

Webhook 是一种自动消息传递方式，它会将内容（或“有效载荷”）发送到唯一的 URL。使用 HTTP Webhook 触发事件，当 webhook URL 收到带有 JSON 有效负载的 HTTP POST 请求时，您可以自动启动一个链。然后，您可以将 JSON 有效负载用作链的命令的数据输出，例如插入到电子表格中。

 

要求

• 必须先设置 HTTP 请求连接器 才能使用此触发事件。
   

从触发事件开始链式调用

当您将触发事件添加到链中时，它会自动生成用于接收 JSON 有效负载的 webhook URL。

1. 前往 链构建器，然后选择您要使用的链。
2. 从左侧菜单中搜索 触发事件 play_for_work ，然后将 HTTP Webhookplay_for_work 命令拖到画布上的 开始 位置。
   
3. 选择 HTTP Webhook节点，然后单击 编辑创建。
4. 在 基本信息下，输入一个唯一的名称和描述，以帮助识别该事件。
   
5. 在 触发事件详细信息下，选择 HTTP 请求 连接器和要与事件一起使用的 CloudRunner。

6. 输入用于保护 webhook URL 的 bearer token。

   注： 可以将 bearer token 视为密码。创建一个难以猜测的令牌，并安全地保存它。

7. 点击 保存。

使用 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 '{}'