手动管理 CRM 联系人不仅拖慢工作流程，还容易出错。通过该组件，您可以智能地扩展和维护 HubSpot 联系人列表，根据您现有工具、对话和其他来源的数据自动更新联系人。

什么是 HubSpot 更新联系人组件

Update Contact in HubSpot 组件可让您在所有工作流程中自动更新 HubSpot 联系人。无论您是通过聊天机器人、文档还是第三方应用收集线索，该工具都能为您节省时间，并保持数据同步。

该组件的主要优势

• 自动保持 CRM 数据最新： 无需再在 HubSpot 里东翻西找手动编辑。该组件可基于工具、聊天、日历或文档中的实时数据，立即更新现有联系人。
• 从任何地方更新： 无论数据在 Google 表格、来自聊天机器人，还是抓取自网站，您都可以直接将其输入 HubSpot。该组件几乎可以连接任何数据源，省去复制粘贴和切换应用的麻烦。
• 比 HubSpot 原生更智能、更快、更灵活： HubSpot 原生工具无法实现多渠道自动化。有了 FlowHunt，您的 AI Agent 可通过搜索逻辑找到正确联系人，获取其 ID，并仅更新所需字段，无需您亲自操作。
• 非常适合实时线索丰富和数据清洗： 随着对话推进，您可以丰富联系人信息，或批量清理过时的 CRM 数据。

组件设置

关联类别（可选）
此设置定义了两个 HubSpot 对象之间的关系。HubSpot 预设字段为默认。若需自定义关联，请切换为用户或集成自定义。该项为开发者可选设置。了解更多请见这里。

关联类型 ID（可选）
通过 ID 指定具体关系。详细信息请参见此HubSpot 指南。为开发者自定义场景的可选设置。

映射 ID
您要关联的对象 ID（如公司 ID）。开发者可选设置。如无需要可留空。

工具说明
提供更多信息，帮助代理理解如何使用该工具。

工具名称
添加一个名称，供代理在详细输出中引用该组件。此名称仅便于您管理。

详细模式
选择代理是否要在 FlowHunt 聊天界面展示其思考过程。适合调试时使用。

输入句柄

• 联系人：
  连接您想要更新的联系人信息，例如一个 Google 表格。这里最多可连接 20 个不同组件，包括 AI Agent、数据组件、文档检索器、消息应用集成等。

• 联系人 ID：
  该句柄用于指定要更新的联系人 ID。
  组件正常工作必须提供此 ID。
  您可以在源数据中直接提供 ID，手动输入，或连接可直接或通过 AI agent 提供 ID 的组件。

输出句柄

• 工具：
  将组件连接至 AI Agent。这是主要输出句柄，使代理能够利用此组件创建新的联系人记录。

• 联系人更新后：
  连接其他组件，以指定联系人更新后的后续操作。例如，设置 Slack 通知、自动更新 Google 表格、或将数据传递做进一步处理。

如何使用 HubSpot 更新联系人组件

只要有联系人数据出现的流程，都可以用到该组件。从聊天对话到内部文档，您都能创建联系人并进一步处理。

常见用例包括：

• 基于聊天机器人、Facebook Messenger、邮件或 WhatsApp 的信息进行更新
• 从 Google Workspace 文档和表格更新
• 从 Google 日历更新
• 从其他文档及 FlowHunt 知识库更新
• 爬取网站以获取新联系人信息
• 使用 API 连接第三方应用，如 Zapier

注意：建议结合 HubSpot 创建联系人组件一同使用，避免错过任何新客户。

流程搭建

下面演示该组件的实际应用。您可以自动化整个流程，包括信息采集与现有记录对比。不过，为简明起见，这里仅创建一个简单流程，让您通过在聊天中提示来查找并更新联系人。

即使是这个简单流程，也比直接在 HubSpot 界面操作更快捷，尤其适合批量更新。无需挨个查找联系人及需更新字段，只需在聊天中发送任意识别信息，并说明要更新的内容即可。

注意：想要更强大、全自动化的解决方案，请参考我们流程库中的预设流程。

1. 作为聊天流程，我们将添加聊天输入输出、聊天历史和一个 AI Agent 作为流程核心。
2. 接着，连接 HubSpot 更新联系人组件作为工具 给 AI agent。
3. 还要添加 HubSpot 搜索联系人组件，并同样作为工具连接。此组件是本用例所必需的。

Update Contact in HubSpot 组件需要精确的 联系人 ID 才能工作。您可以有多种方式提供 ID：在联系人源数据中已包含 ID、连接提供 ID 的组件，或手动输入。

在本例中，我们只需在聊天中输入任意联系人识别信息，流程会自动查找 ID 并更新联系人。这时就需要用到 HubSpot 搜索联系人组件。

搜索组件可根据您的查询检索相关联系人并获取其 ID。有了这两个组件作为工具，AI Agent 会自动完成全部操作：搜索联系人、获取 ID、更新联系人。您只需在聊天中提供识别属性即可。

注意： HubSpot 搜索联系人组件始终会根据您的设置（比如匹配邮箱、按创建时间等）搜索相应属性。可在本指南中学习配置方法。

来测试一下吧。在我们的 HubSpot 创建联系人指南中，我们新建了名为 Jane Doe 的联系人。假设现在要更新该联系人的电话号码，将搜索组件设置为邮箱精确匹配后，我们发送如下消息：

“将邮箱为 jane@flowhunt.io 的联系人的号码改为 +421(901)234-567”

处理完成后，聊天机器人会回复成功消息：

回到 HubSpot 联系人界面，可以看到新号码已经生效：

这种基础流程非常适合客服聊天机器人或任何通过聊天输入新联系人信息的场景。如果您需要更强大、全自动化的方案，欢迎试用 Flow 库中的预设流程。

如何查找联系人 ID

虽然大多数情况下其他组件会自动完成工作，但某些场景可能需要您手动查找联系人 ID。具体方法如下：

1. 在 HubSpot 仪表盘，进入 CRM -> 联系人。
2. 找到您要更新的联系人并打开。

现在有两种方式获取 ID 编号。您可以在地址栏最后找到它，或者进入 操作 -> 查看所有属性，查找“记录 ID”。