如何在 HubSpot 基于联系人的工作流中触发 Webhooks

在工作流中使用网络钩子，可在HubSpot与其他外部工具之间发送或检索信息。网络钩子具有多种用途，其常见应用场景包括：

• 当访客在网站填写特定表单时，将 HubSpot 联系人数据推送至其他系统（如 CRM）。

• 将交易数据发送至外部物流处理系统以生成采购订单。

• 从其他系统检索数据以更新HubSpot记录。

工作流支持发送POST和GET请求。HubSpot将webhook流量与其他工作流流程分开管理，以优化工作流和webhook性能。当webhook响应缓慢或超时时，工作流操作的执行时间可能超出预期。

请注意：HubSpot将在webhook失败后一分钟开始重试，持续最多三天。 后续失败将以递增间隔重试，每次尝试间隔最长为8小时。收到4XX系列响应状态码后，工作流将停止重试。
此规则的例外情况是429速率限制错误：收到429响应后工作流将自动重试，并遵循存在的Retry-After标头（以毫秒为单位记录）。 具体错误代码例外情况请参阅HubSpot 开发者文档。

更多 webhook 相关信息请查阅开发者 webhook 文档。若对 HubSpot webhook 具体实现存在疑问，请访问HubSpot 开发者论坛咨询。

设置 POST 请求

1. 在 HubSpot 帐户中，导航到自动化 > 工作流。
2. 要编辑现有工作流，请点击工作流名称。或创建新工作流。
3. 在工作流编辑器中，点击+ 号图标添加操作。
4. 在左侧面板的"数据操作"部分，选择"发送Webhook"。
    

5. 点击方法下拉菜单并选择POST。
6. 输入Webhook网址。
   • Webhook URL必须采用安全协议，且必须以HTTPS开头。
   • 若需请求特定信息，可在Webhook URL后添加查询参数，例如?queryparameter=abc 。
   • 若未添加查询参数，系统将发送通用POST或GET请求。
7. 设置认证类型以验证发往Webhook的请求。可选择在Webhook头部使用请求签名，或使用API密钥：
   • 在 Webhook 头部使用请求签名：
     • 点击“身份验证类型”下拉菜单，选择 “在头部包含请求签名”。
     • 随后输入您的HubSpot应用ID。了解如何验证请求签名。
   • 使用 API 密钥或通过开发者账户创建的公共应用进行认证：
     • 使用 API 密钥进行身份验证时，API 密钥名称和 API 密钥位置取决于webhook 的配置方式。出于安全考虑，API 密钥不会在任何测试请求中显示。使用 API 密钥的方法：
       • 点击“身份验证类型”下拉菜单， 选择“API密钥”。
       • 输入您的API 密钥名称。
       • 点击API 密钥位置下拉菜单，选择“查询参数”或“请求头”。了解如何在 HubSpot 中使用API 密钥。
     • 若向HubSpot API发起请求：
       • 点击API 密钥下拉菜单并选择密钥值。密钥值必须采用Bearer [YOUR_TOKEN] 格式。
       • 将 API 密钥名称的值设置为Authorization。
       • 将API 密钥位置 的值设置为 请求头。
8. 要包含所有属性，请选择包含所有[对象]属性。
9. 若仅需包含特定属性：
   • 选择“自定义请求正文”。
   • 若需使用HubSpot属性自定义请求正文，请输入键值并选择属性。添加其他属性请点击"添加属性"。
   • 使用静态字段自定义请求正文时，请输入键值对。添加其他属性请点击“添加静态值”。
   • 要删除属性或静态值，请点击删除 垃圾桶图标。
10. 点击保存。

请注意：若需选择多个输出项，响应数据应以JSON对象形式呈现。

设置GET请求

1. 在 HubSpot 帐户中，导航到自动化 > 工作流。
2. 要编辑现有工作流，请点击工作流名称。或创建新工作流。
3. 在工作流编辑器中，点击+ 号图标添加操作。
4. 在左侧面板的"数据操作"部分，选择"发送Webhook"。
    

5. 点击方法下拉菜单并选择GET。
6. 输入Webhook网址。
   • Webhook URL必须采用安全协议，且必须以HTTPS开头。
   • 若需获取特定信息，可在Webhook网址后添加查询参数，例如：?queryparameter=abc 。
   • 若未添加查询参数，系统将发送通用POST或GET请求。
7. 设置认证类型以验证发往Webhook的请求。可选择在Webhook头部使用请求签名，或使用API密钥：
   • 在 Webhook 头部使用请求签名：
     • 点击“身份验证类型”下拉菜单，选择 “在头部包含请求签名”。
     • 随后输入您的HubSpot应用ID。了解如何验证请求签名。
   • 使用 API 密钥或通过开发者账户创建的公共应用进行认证：
     • 使用 API 密钥进行身份验证时， API 密钥名称和位置取决于webhook 的配置方式。出于安全考虑，API 密钥不会在任何测试请求中显示。使用 API 密钥的方法：
       • 点击“身份验证类型”下拉菜单， 选择“API密钥”。
       • 输入您的API 密钥名称。
       • 点击API 密钥位置下拉菜单，选择“查询参数”或“请求头”。了解如何在 HubSpot 中使用API 密钥。
     • 若向HubSpot API发起请求：
       • 点击API 密钥下拉菜单并选择密钥值。密钥值必须采用Bearer [YOUR_TOKEN] 格式。
       • 将 API 密钥名称的值设置为Authorization。
       • 将API 密钥位置 的值设置为 请求头。
8. 若设置GET请求，可使用HubSpot属性或添加静态值作为查询参数： 

9. 若要使用 HubSpot 属性作为查询参数：
   • 在“查询参数”部分 输入键值，然后选择属性。
   • 要添加其他属性，请点击“添加属性”。
   • 要删除属性，请点击删除 图标。
10. 使用静态值作为查询参数：
    • 在“查询参数”部分 ，输入键名，然后输入值。
    • 要添加另一个属性，请点击添加静态值。
    • 要删除属性，请点击删除 图标。
11. 点击保存。

为您的 webhook 设置速率限制

设置速率限制以确定Webhook操作的执行速度。该限制同样会影响工作流中后续的所有操作。

1. 在 HubSpot 帐户中，导航到自动化 > 工作流。
2. 点击工作流名称。
3. 在工作流编辑器中，点击“发送 webhook”操作。
4. 在左侧面板中，点击"配置速率限制"以展开该部分。
5. 点击切换按钮开启速率限制开关。默认情况下此设置处于关闭状态。 
6. 设置速率限制： 
   • 操作执行次数：设置 每时间段内的最大执行次数。 
   • 时间范围：设置速率限制的时间周期。可选择以秒、分钟或 小时为单位设置该时间范围。 

在 HubSpot 内测试 webhook

设置POST或GETWebhook 时，可执行测试查看响应结果。测试过程中，数据虽会与第三方进行传输交互，但 HubSpot 中的现有记录不会受到影响。若使用 API 密钥进行身份验证，测试请求中将不会显示该密钥。

测试完成后，可选择需输出的字段供后续工作流使用。请仅选择每次响应中均可获取的输出字段。若后续操作使用的输出字段在响应中不可用，该操作将失败。

1. 在 HubSpot 帐户中，导航到自动化 > 工作流。
2. 点击工作流名称。
3. 在工作流编辑器中，点击"发送Webhook"操作。
4. 在左侧面板中点击"测试操作"以展开该部分。
5. 若测试 POST 请求，根据您在 webhook 操作中选择的"自定义请求正文"或"包含所有 [object] 属性"选项，测试配置方式将有所不同。
   • 若选择自定义请求正文，请输入测试所需的属性测试值。
   • 若选择 包含所有[对象]属性，请点击[对象]下拉菜单，然后选择要测试的记录。
6. 点击测试。
7. 要查看Webhook详细信息，请选择响应或请求选项卡。在每个选项卡中，您可以点击展开全部以展开所有部分，或点击折叠全部以折叠所有部分。
   • 在响应选项卡中，点击headers: 或 body: 以 展开相应部分。
   • 在请求选项卡中 ，点击httpHeaders: 展开 该部分。
     
     

外部测试您的 webhook

创建包含 webhook 操作的工作流后，可使用虚拟 webhook URL 进行快速测试：

1. 在浏览器中访问https://webhook.site并复制该唯一网址。
2. 在webhook操作的URL字段中粘贴该地址。
3. 工作流启用后，即可手动添加测试联系人。
   
   

4. 外部测试Webhook时：
   • 若触发包含POST请求的Webhook操作，系统将向Webhook发送包含联系人完整信息的JSON响应体，包括表单提交记录、列表成员资格及所有联系人属性值。接收系统可解析该JSON数据并用于自身应用程序。
   • 若触发GET请求类型的webhook操作，系统将发送通用GET请求（除非附加了额外查询参数）。

请注意：历史属性值仅在基于联系人的工作流中返回。其他类型工作流使用的webhook仅返回最新值。

在工作流 webhook 中验证请求签名

当您在“触发 webhook 操作 ”的“身份验证”部分 选择“请求签名”时，HubSpot 会为 webhook 添加 X-HubSpot-Signature 标头，其中包含应用程序密钥、HTTP 方法、URI 及未解析正文的拼接内容的 SHA-256 哈希值。更多详情请参阅开发者文档。

验证接收到的请求是否来自 HubSpot：

• 拥有开发者账户。若尚未注册，请创建开发者账户。
• 拥有应用程序。若尚未创建应用程序，请学习如何创建应用程序。
• 验证签名的哈希值。

通过 webhook 触发工作流

webhook 可用于触发工作流。当第三方应用中的数据发生变更时，即可触发工作流。了解如何通过 webhook 触发工作流。

在数据面板中使用 webhook 数据

连接至您账户的 webhook数据可在数据面板中用于特定操作。

使用已连接 webhook 的数据：

1. 在 HubSpot 帐户中，导航到自动化 > 工作流。
2. 点击您的工作流名称。
3. 点击+ 号图标添加操作。
4. 在左侧面板中选择使用 数据面板 的操作 。
5. 在数据面板中，点击“查看属性或操作输出”下拉菜单 ，选择“Webhook触发器”。随后即可使用关联Webhook的属性。