什么是“在 HubSpot 中搜索联系人”组件

“在 HubSpot 中搜索联系人”组件可让您基于任意 HubSpot 属性（包括自定义属性）查找和筛选联系人。结合运算符选项，可以实现数十种独特的应用场景。

该组件的主要优势

• 灵活的属性搜索： 可使用任意 HubSpot 属性（包括自定义字段）筛选联系人，让您完全掌控目标定位和数据提取方式。
• 高级运算符支持： 可使用等于、大于、小于、区间、包含等条件，实现精准且可自定义的查询。
• 工作流兼容性： 可与其他组件结合，构建完整流程。非常适合线索跟踪、提醒或跨工具同步数据。
• 提升数据清理效率： 轻松识别不完整或过时的联系人记录，帮助保持 CRM 数据的清晰和最新。
• 基于时间的筛选： 可按创建或修改日期搜索，非常适合设置周年优惠、再激活活动或陈旧线索检测。
• 自定义输出选项： 可将结果发送至所需位置——聊天、Slack、Google 表格、电子邮件等，方便自动化报告和提醒。

组件设置

运算符

运算符是描述您的查询与目标之间关系的数学函数。例如，您可以搜索邮件的精确匹配，也可以查找在特定日期后创建的联系人、缺少特定属性的联系人等。

属性名称

您可以按 HubSpot 属性或自定义对象搜索。结合运算符选项，可实现数十种独特场景。除了联系人信息（如姓名、邮箱或公司），还可以按创建/修改日期、生命周期阶段等筛选。

其他设置

• 限制： 设置要检索的联系人数量。默认是 1（适用于精确匹配场景），但批量操作时可设置更高。请注意，结果数量越多，处理时间和价格也会相应增加。
• 工具描述： 为代理补充说明，帮助其理解如何使用该工具。
• 工具名称： 添加一个名称，供代理在详细输出中引用该组件，便于管理和识别。
• 详细模式： 决定代理是否在 FlowHunt 聊天界面展示其思考过程，调试时尤其有用。

句柄

• 工具： 将组件作为工具连接到 AI Agent。这是主要的输出句柄，允许代理使用该组件创建新的联系人记录。
• 添加联系人后： 连接组件，指定联系人创建后应执行的操作。例如，可设置 Slack 通知、自动更新 Google 表格，或进一步处理数据。

如何使用“在 HubSpot 中搜索联系人”组件

了解了组件功能后，让我们看看如何实际操作。在介绍实际操作前，以下是一些典型应用场景，展示该组件能解决的问题类型：

• 合规与数据清理： 利用“not in”、“没有该属性”或“包含标记”等运算符，查找测试线索、缺失字段或不完整记录进行抑制或清理。
• 陈旧线索检测： 对生命周期=lead 且在特定时间内未修改的联系人自动提醒。
• 区域活动： 按国家、城市或邮编等筛选联系人，生成并发送基于地域的活动、邀请等。
• 基于时间的活动： 按特定创建日期查找联系人，生成并发送周年优惠。
• 自动续订提醒： 对“最后修改日期小于等于”某日期的客户进行筛选，触发回访或优惠提醒。
• 关键账户新联系人： 检测目标账户公司中新建的联系人，及时触发内部提醒或分配给合适销售。
• 邮编分配销售线索： 用“in”运算符匹配联系人邮编，并分配给本地销售或本地化活动。
• 兴趣智能分配： 利用自定义属性（如“兴趣=产品A”）即时分配联系人到相关销售或内容流程。

构建陈旧线索检测流程

让我们测试一下该组件。我们将创建一个非常简单的陈旧线索检测流程。换句话说，我们要查找生命周期阶段=lead 且 最后修改日期为 X 天前的联系人。

本例将以聊天流（chatflow）形式测试。当然，也可以完全自动化，作为定时任务运行，并将结果输出到所需位置，无论是 Slack、Gmail 通知，还是用于自动报告的表格。

操作步骤：

1. 作为聊天流，添加 Chat Input、Output 和 History。
2. 添加一个会将 HubSpot 组件作为工具的 AI Agent。
3. 由于有两个检索条件，需要添加两个“在 HubSpot 中搜索联系人”组件。
4. 按下图连接组件：

5. 设置搜索的运算符和属性名称。
6. 第一个搜索组件查找lastmodifieddate，要求大于等于X天前。也就是查找陈旧记录：

7. 第二个搜索组件查找lifecyclestage，要求等于lead。确保结果中没有现有客户或其他记录类型：

8. 如此即可实现一个允许您在聊天中下达指令并获取结果的聊天流。您可以进一步完善该流程，让其自动运行并将结果发送到第三方应用而不是聊天。

让我们测试一下。在聊天中发送如下指令：

返回生命周期阶段为 lead 且最后修改日期大于等于 5 天的联系人。

在全自动工作流中，您可以直接将指令写入 AI Agent 和搜索联系人组件的设置里。本例为聊天流，因此只需在聊天中发送指令即可。

经过一段处理后，流程返回了一个联系人：

我们来验证一下结果。在 HubSpot 联系人列表中可以看到有 4 条记录，其中一条是客户，另外两条今天（4 月 10 日）刚被修改。因此，流程返回的这个联系人确实是唯一符合给定条件的：

本例中，我们手动触发流程，搜索结果在聊天中返回。当然，您可以将其改造为全自动解决方案，作为定时任务运行，并将聊天输出替换为您需要的任何输出源，如用于自动报告的“新建 Google 表格”组件，以及用于通知的“发送 Slack 消息”或“邮件通知”工具。