请注意::本文仅为方便您阅读而提供。本文由翻译软件自动翻译,可能未经校对。本文的英文版应被视为官方版本,您可在此找到最新信息。您可以在此处访问。
设置“收到 Webhook 时”的工作流触发器
上次更新时间: 2026年8月3日
设置入组触发器,以便在收到来自外部第三方应用程序的 Webhook 时,自动将记录纳入工作流。了解有关设置工作流入组的更多信息。
了解限制和要求
-
只有当您的 HubSpot 账户中存在具有相应唯一属性值的现有记录时,工作流才会触发。
- Webhook 触发器仅支持内容类型为application/json的传入数据。
设置“收到 Webhook 时”工作流触发器
要通过 Webhook 触发工作流:
- 在你的 HubSpot 帐户中,单击更多,然后导航到自动化 > 工作流。如果你的帐户中未显示更多,请直接导航到自动化 > 工作流。
- 点击现有工作流的名称,或创建一个新工作流。
- 如果您要从头开始创建工作流:
- 在左侧面板中,点击展开“自定义事件和外部事件”部分 。
- 点击“收到来自外部应用的 Webhook”。
- 如果您正在编辑现有工作流:
- 在工作流编辑器中,点击“为 [对象] 触发注册”卡片 。
- 如果已有工作流触发器,请在左侧面板中点击“更改起始触发器”。这将清除所有当前的注册触发器。
- 在对话框中,点击“确认”。
-
- 在左侧面板的“高级选项”下,点击“收到 Webhook 时”。
- 要添加新的 Webhook,请点击“+添加 Webhook”。您最多可以创建100 个唯一的 Webhook 事件。

- 输入Webhook 事件名称,然后点击“下一步”。
- 复制 Webhook URL,并将其粘贴到您要集成的应用的Webhook 设置页面中。在您的应用中,使用该 Webhook URL 发送一个测试事件。

- 在“查看测试事件”部分,检查 Webhook 事件并根据需要进行更新。然后,点击“下一步”。
- 为 Webhook 属性映射数据:
- 根据 需要编辑HubSpot 属性标签 。
- 点击“数据类型”下拉 菜单,为每个属性标签选择数据类型。
- 您可以使用字符串、枚举、数字和布尔值。
- 不支持日期时间属性,应将其映射为字符串值。之后,您可以使用自定义代码操作,通过 `
strtotime` 将其转换为日期时间对象,然后使用 `unixtimestamp` 获取时间戳。
- 要删除属性标签,请单击“删除”图标。
- 点击“下一步”。
- 通过从第三方 webhook 中选择一个与您的 HubSpot 自定义属性完全匹配的属性,来匹配您的注册属性。然后,点击“下一步”。
- 只有当所选的第三方 Webhook 属性在传入的 Webhook 数据中具有非空值时,工作流才会被触发。
- 该自定义属性必须勾选了“要求属性值唯一”复选框。或者,创建一个要求值唯一的新属性。
- 点击“继续”以触发设置。
- 若要将 Webhook 用作注册触发器,请在左侧面板中单击 Webhook 的名称。然后,单击“保存”。
Workflows
你的反馈对我们至关重要,谢谢。
此表单仅供记载反馈。了解如何获取 HubSpot 帮助。
