测试版自定义网络钩子(BETA)
上次更新时间: 二月 12, 2025
除非另有说明,否则适用于以下任何订阅:
|
如果在工作流中使用网络钩子 从工作流中发送 POST 或 GET 请求,则可以自定义网络钩子来控制发送和接收的数据。
在 POST 请求中,您可以指定发送到任何外部系统(如 CRM)的属性。同样,在 GET 请求中,您可以通过查询参数指定请求的属性。
有关网络钩子的更多信息,请参阅开发人员网络钩子文档。如果你对使用HubSpot的webhooks的具体实现有疑问,请访问HubSpot开发者论坛。
请注意: HubSpot 将重试失败的网络钩子长达三天,从失败后一分钟开始。后续失败的重试间隔将越来越长,两次重试之间的间隔最长为八小时。 在HubSpot 的开发人员文档中了解具体的错误代码异常。
设置网络钩子
创建并自定义网络钩子:
- 在 HubSpot 帐户中,导航到自动化 > 工作流。
- 单击工作流程 名称 。
- 单击+ 图标添加操作。
- 在右侧面板中,选择发送网络钩子。
- 单击方法下拉菜单,然后选择POST 或GET。
- 输入网络钩子 URL。网络钩子 URL 受限于安全协议,必须以 HTTPS 开头。要请求特定信息,可以在Webhook URL中添加查询参数,如
?queryparameter=abc
。如果没有添加查询参数,则将发送普通 POST 或 GET 请求。 - 设置身份验证类型,以验证对 Webhook 的请求:
- 在 Webhook 头中使用请求签名:
- 点击身份验证类型下拉菜单。然后,选择 在标题中包含请求签名。
- 然后,输入你的HubSpot App ID。了解如何验证请求签名。
- 在 Webhook 头中使用请求签名:
-
- 您也可以使用 API 密钥进行身份验证。使用 API 密钥进行身份验证时,所使用的API 密钥名称和API 密钥位置取决于 webhook 的配置方式。出于安全考虑,API 密钥不会显示在任何测试请求中。要使用 API 密钥,请
- 单击验证类型下拉菜单。然后选择 API 密钥。
- 您也可以使用 API 密钥进行身份验证。使用 API 密钥进行身份验证时,所使用的API 密钥名称和API 密钥位置取决于 webhook 的配置方式。出于安全考虑,API 密钥不会显示在任何测试请求中。要使用 API 密钥,请
-
-
- 输入API 密钥名称。
- 单击API 密钥位置下拉菜单。然后,选择 查询参数或请求标题。了解有关在 HubSpot 中使用API 密钥的更多信息。
-
自定义POST请求
如果要设置 POST 请求,你可以选择包含 CRM 记录中的所有属性,或者只发送特定属性:- 要包含所有属性,请在 "自定义请求正文"部分选择 "包含所有属性"。
- 只包含特定属性
- 在 "自定义请求正文"部分下,选择 "选择特定属性"。
- 单击选择属性下拉菜单。然后,单击此工作流程中的[对象]并选择一个属性。
- 要更改 webhook 中的属性名称,请编辑属性名称 文本字段。这只会更新 POST 请求中的属性名称,不会更新 HubSpot 中的属性名称或内部名称。
- 要添加其他属性,请单击 "添加属性"。
- 要删除属性,请点击delete 垃圾桶图标。
自定义 GET 请求
如果要设置 GET 请求,可以使用属性作为查询参数来检索特定数据:- 在查询参数 部分,单击选择属性下拉菜单。然后,单击此工作流中的[对象]并选择一个属性。
- 要更改查询参数中的属性名称,请编辑属性名称 文本字段。这只会更新 GET 请求中的属性名称,不会更新 HubSpot 中的属性名称或内部名称。
- 要添加其他属性,请单击 "添加查询参数"。
- 要删除属性,请单击delete 垃圾桶图标。
- 单击保存。
Workflows
你的反馈对我们至关重要,谢谢。
此表单仅供记载反馈。了解如何获取 HubSpot 帮助。