跳到内容

自定义网络钩子(BETA)

上次更新时间: 二月 12, 2025

除非另有说明,否则适用于以下任何订阅

Operations Hub   Professional , Enterprise

如果在工作流中使用网络钩子 从工作流中发送 POST 或 GET 请求,则可以自定义网络钩子来控制发送和接收的数据。

在 POST 请求中,您可以指定发送到任何外部系统(如 CRM)的属性。同样,在 GET 请求中,您可以通过查询参数指定请求的属性。

有关网络钩子的更多信息,请参阅开发人员网络钩子文档。如果你对使用HubSpot的webhooks的具体实现有疑问,请访问HubSpot开发者论坛

请注意: HubSpot 将重试失败的网络钩子长达三天,从失败后一分钟开始。后续失败的重试间隔将越来越长,两次重试之间的间隔最长为八小时。 HubSpot 的开发人员文档中了解具体的错误代码异常。

设置网络钩子

创建并自定义网络钩子:

  • 在 HubSpot 帐户中,导航到自动化 > 工作流
  • 单击工作流程 名称
  • 单击+ 图标添加操作。
  • 在右侧面板中,选择发送网络钩子
  • 单击方法下拉菜单,然后选择POSTGET
  • 输入网络钩子 URL。网络钩子 URL 受限于安全协议,必须以 HTTPS 开头。要请求特定信息,可以在Webhook URL中添加查询参数,如?queryparameter=abc 如果没有添加查询参数,则将发送普通 POST 或 GET 请求。
  • 设置身份验证类型,以验证对 Webhook 的请求:
    • 在 Webhook 头中使用请求签名:
      • 点击身份验证类型下拉菜单。然后,选择 在标题中包含请求签名
      • 然后,输入你的HubSpot App ID。了解如何验证请求签名
    • 您也可以使用 API 密钥进行身份验证。使用 API 密钥进行身份验证时,所使用的API 密钥名称API 密钥位置取决于 webhook 的配置方式。出于安全考虑,API 密钥不会显示在任何测试请求中。要使用 API 密钥,请
      • 单击验证类型下拉菜单。然后选择 API 密钥
      • 输入API 密钥名称
      • 单击API 密钥位置下拉菜单。然后,选择 查询参数请求标题。了解有关在 HubSpot 中使用API 密钥的更多信息。

自定义POST请求

如果要设置 POST 请求,你可以选择包含 CRM 记录中的所有属性,或者只发送特定属性:
  • 要包含所有属性,请在 "自定义请求正文"部分选择 "包含所有属性"。
  • 只包含特定属性
    • 在 "自定义请求正文"部分下,选择 "选择特定属性"。
    • 单击选择属性下拉菜单。然后,单击此工作流程中的[对象]并选择一个属性
    • 要更改 webhook 中的属性名称,请编辑属性名称 文本字段。这只会更新 POST 请求中的属性名称,不会更新 HubSpot 中的属性名称或内部名称。
    • 要添加其他属性,请单击 "添加属性"。
    • 要删除属性,请点击delete 垃圾桶图标


自定义 GET 请求

如果要设置 GET 请求,可以使用属性作为查询参数来检索特定数据:
  • 查询参数 部分,单击选择属性下拉菜单。然后,单击此工作流中的[对象]并选择一个属性
  • 要更改查询参数中的属性名称,请编辑属性名称 文本字段。这只会更新 GET 请求中的属性名称,不会更新 HubSpot 中的属性名称或内部名称。
  • 要添加其他属性,请单击 "添加查询参数"。
  • 要删除属性,请单击delete 垃圾桶图标
  • 单击保存


这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助