使用 HubSpot 客服 CLI
上次更新时间： 2026年9月29日
HubSpot Agent CLI 可将 AI 编程助手（例如ChatGPT 应用、Claude 应用和 Claude Code中的助手）与您的 HubSpot 账户连接起来。 将 Agent CLI 连接到 HubSpot 后，您可以要求 AI 助手完成重复性的 CRM 任务、分析数据、生成摘要，并协助管理整个账户中的各项流程。当您将任务委派给 AI 助手时，它们可以利用 Agent CLI 代表您自动化处理日常工作，从而帮助您的团队将更多时间投入到战略性工作中。
例如，您无需每周手动审查记录，而是可以要求 AI 代理根据 HubSpot 中的信息，识别不完整的记录、汇总销售管道活动或准备客户审查报告。
如果您是希望编写自定义脚本或在终端中手动使用 HubSpot Agent CLI 的开发者，请参阅HubSpot 的开发者文档。
开始之前
在开始使用 HubSpot Agent CLI 之前，请确保您拥有 AI 编码代理的访问权限。支持的代理包括ChatGPT 应用、Claude 应用、Claude Code 以及许多其他兼容的 AI 编码代理。
请注意：如果您在团队或企业账户中使用 Claude Cowork，您的组织管理员可能需要将api.hubapi.com加入白名单，CLI 才能安装或运行。了解有关在 Claude Cowork 中添加白名单的更多信息。
何时使用 HubSpot Agent CLI
Agent CLI 适用于需要审查大量 CRM 数据的重复性或周期性运营工作。这包括每周执行销售管道审查、批量更新记录，或在每月例会结束后向团队发送计划好的摘要等任务。查看更多用例示例。
如果您只想提出一次性问题或利用 HubSpot 数据起草内容，则可选择Claude 的 HubSpot 连接器或ChatGPT 的 HubSpot 连接器，这些选项无需安装 CLI。
AI 代理通过 HubSpot Agent CLI 可访问的内容
HubSpot Agent CLI 可利用已连接 HubSpot 用户的权限执行操作。根据您的用户权限，这可能包括在您的账户中创建、更新或删除记录。
连接 HubSpot Agent CLI 后，AI 代理可处理您 HubSpot 账户中的各类信息，包括：
- 联系人、公司、商机、工单、自定义对象及其他 CRM 记录。
- 工作流。
- 销售管道和销售管道阶段。
- 属性与自定义属性。
- 收入记录（只读）：合同、发票、订单、付款、报价、报价模板和订阅（测试版）。
- 记录之间的关联。
- 活动历史记录。
请注意：在对 CRM 数据进行更改之前，请务必审查 AI 生成的建议和拟采取的操作。
最佳实践
在使用连接到 HubSpot 的 AI 代理时：
- 在使用会修改数据的操作之前，请先从报告、摘要和分析任务入手。
- 在设置计划任务或周期性任务时，请先从单一且范围较窄的用例开始，然后再扩展到更广泛的自动化。
- 在应用更改之前，请先审查生成的建议和大规模更新。
- 某些操作可能会删除或覆盖 HubSpot 数据。如果可用，请使用--dry-run选项在应用更改之前预览更改。
- 请使用清晰、具体的提示语来描述期望的结果。
- 请遵守贵组织的数据治理和安全政策。
连接 HubSpot Agent CLI
请按照以下步骤指导您的代理安装 HubSpot Agent CLI。如果您是开发人员，请了解有关手动安装 HubSpot Agent CLI 的更多信息。
- 打开您的 AI 代理。
- 将以下提示粘贴到代理工作区中，以安装代理 CLI。
Install the HubSpot Agent CLI in this agent workspace. If this workspace uses a POSIX shell (macOS, Linux, WSL, or Bash), run `curl -fsSL https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.sh | sh`. If it uses Windows PowerShell, run `irm https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.ps1 | iex`. Then authenticate with `hubspot auth login`, install HubSpot Agent CLI Skills with `npx skills add hubspot/agent-cli-skills`, and use `hubspot --help` to explore what's available.
- 出现提示时，请登录您的 HubSpot 账户。
- 查看所请求的权限。
- 点击“连接应用”。
身份验证完成后，AI 代理即可根据您的权限访问 HubSpot 数据。
示例用例
以下示例展示了不同团队如何使用通过 HubSpot Agent CLI 连接的 AI 代理。
市场营销团队
| 任务 | AI 代理的示例提示语 |
| 识别需要跟进或数据清理的联系人。 | 每周一上午 8 点，筛选出符合高匹配度标准、但未关联任何交易、近期无销售活动或缺少关键数据补充字段的联系人，随后向 RevOps 发送一份按优先级排序的清理清单，并附上建议的后续行动。 |
| 审查电子邮件营销活动，找出不符合品牌语调指南的主题行和行动号召（CTA）。 | 审查我最近的10个电子邮件营销活动，标记不符合品牌语调指南的主题行或CTA。列出每个问题，包括活动名称、被标记的文案以及建议的修改方案。 |
| 识别高转化率着陆页中与更高转化率相关的信息传递模式。 | 按转化率分析我表现最佳的着陆页。识别常见的信息传递模式，例如标题结构、CTA措辞或优惠类型，并总结它们的共同点。 |
| 创建一份重新激活名单，包含在培育序列中未打开过邮件的联系人。 | 查找当前参与培育序列中，过去 30 天内未打开任何邮件的所有联系人。创建一个包含其姓名、公司、生命周期阶段和最后活动日期的受众分组。 |
| 跟踪源自网络研讨会活动的商机当前销售漏斗状态。 | 查找所有潜在客户来源为网络研讨会的交易，并显示其当前销售漏斗阶段、负责人、金额和最后活动日期。汇总其中处于活跃、停滞或已关闭状态的数量。 |
| 识别最匹配客户中的行业、公司规模和潜在客户来源模式。 | 查看我过去12个月内已成交的商机，并汇总最常见的行业、公司规模和潜在客户来源组合。突出显示任何有助于完善我们理想客户画像的规律。 |
| 监控活跃的邮件序列，并对邮件打开率出现显著下降的情况进行标记。 | 检查所有活跃的邮件序列，并将最近两周的打开率与前两周进行对比。标记打开率下降超过20%的序列，并注明序列名称、当前打开率和之前打开率。 |
销售和营收运营团队
| 任务 | AI 代理的示例提示 |
| 监控销售 pipeline 状况，并识别需要关注的交易。 | 每天早上7点，检查我的销售管道中本周即将成交但过去5天内无任何动态的交易，并向我发送一份摘要。 |
| 查找需要跟进和审查的、处于非活跃状态的高价值交易。 | 查找所有金额超过 $[amount] 且过去 14 天内无任何动态的未结交易。按交易金额排序，并包含交易名称、负责人、成交日期和最近动态。 |
| 通过汇总交易、支持、邮件和备注历史记录，为客户会议做准备。 | 我明天要和[公司]开会。请汇总他们的未结交易和近期已成交交易、最近5张支持工单、近期邮件往来以及过去60天内记录的任何备注。 |
| 分析延误的交易，以确定商机在销售漏斗的哪个阶段停滞时间最长。 | 查看上季度未按期成交的交易。针对每笔交易，显示其在哪个销售漏斗阶段停留时间最长，并确定交易最常停滞的两到三个阶段。 |
| 生成一份每日摘要，列出临近成交日期但近期无活动的交易。 | 每天上午8点，筛选出将在未来7天内成交、且过去3天内无任何活动的交易。向我发送一份摘要，其中包含交易名称、负责人、金额、成交日期以及最近的活动类型。 |
销售负责人
| 任务 | AI 代理的示例提示 |
| 分析通话记录，提取 coaching 和产品反馈主题。 | 分析近期通话记录中的通话时长、竞争对手提及、客户反馈以及潜在客户犹豫等主题，然后创建一个包含通话记录示例和源通话链接的辅导与产品反馈仪表盘。 |
| 识别通话时长模式异常偏高或偏低的销售代表或团队。 | 分析过去 30 天的通话记录，计算每位销售代表的平均通话时长占比。标记通话时长占比高于 70% 或低于 30% 的销售代表，并为每位代表附上一段通话记录摘录作为示例。 |
| 找出近期销售通话中反复提及的竞争对手。 | 审查过去 60 天的通话记录，并确定被提及次数最多的竞争对手。针对每个竞争对手，显示提及次数、出现的交易阶段以及一段示例引语。 |
| 按细分市场、交易阶段或产品领域汇总潜在客户的犹豫主题。 | 扫描近期通话记录，查找表明潜在客户犹豫或异议的措辞。按交易阶段和潜在客户细分市场对主题进行分组，并总结前 5 大犹豫模式，附上示例引语。 |
| 提取能佐证辅导或产品反馈主题的通话记录示例。 | 从过去 30 天的通话记录中，找出 3 至 5 个有效的需求挖掘问题示例，以及 3 至 5 个错失处理异议机会的示例。请包含销售代表姓名、通话日期以及每个示例的直接引语。 |
| 创建一个仪表盘，将通话洞察与源记录和通话记录关联起来。 | 创建一个辅导仪表盘，汇总过去30天内通话中的通话时长比例、竞争对手提及情况以及异议主题。对于每条洞察，请包含指向源通话及相关交易记录的链接。 |
RevOps 和 CRM 管理员
| 任务 | AI 代理的示例提示 |
| 清理 CRM 属性，同时确保不影响下游资产。 | 查找重复或已弃用的 CRM 属性，并显示它们在工作流、报告和视图中的使用位置。然后预览清理方案，在应用更改前对字段进行替换、删除或重新排序。 |
| 识别在不同对象中收集相同信息的重复属性。 | 扫描所有联系人、公司和商机属性，并标记那些看似以不同名称收集相同信息的属性。列出属性名称、所属对象以及每对重复属性的建议操作。 |
| 查找仍出现在工作流、报告、视图或记录布局中的已弃用字段。 | 查找过去 12 个月内未更新、但仍出现在活跃工作流、已保存报告、列表视图或记录卡片布局中的所有 CRM 属性。在进行任何更改之前，显示每个属性的使用位置。 |
| 在进行更改之前，预览删除或替换 CRM 字段可能产生的影响。 | 我想删除属性 [属性名称]。在进行任何更改之前，请向我显示使用该属性的所有工作流、报告、列表和记录卡片布局，并预览哪些功能会失效或需要更新。 |
| 重新排列记录字段，以便管理员和销售代表首先看到最重要的信息。 | 对于联系人记录布局，将以下字段移至属性侧边栏顶部：[字段 1]、[字段 2]、[字段 3]。应用更改前请预览效果。 |
| 生成清理摘要，显示已更改的内容以及仍需审核的内容。 | 完成 CRM 属性清理后，生成一份摘要，列出所有被删除、替换或重命名的属性，哪些资产已更新，以及仍需人工审核的字段列表。 |
运营团队
| 任务 | AI 代理的示例提示 |
| 合并相关支持工单并保留清理历史记录。 | 合并重复的支持工单，保留源工单的详细信息，将每张父工单路由到正确的流程阶段，并向团队发送一份清理摘要，其中包含仍需审核的记录。 |
| 查找同一客户或同一问题类型下的重复或相关支持工单。 | 查找来自同一公司且创建时间间隔在30天内的所有未解决支持工单。按公司和问题类型进行分组，并对任何疑似重复的工单进行标记。 |
| 将工单上下文合并到父记录中，同时保留源记录的详细信息。 | 对于上述已识别的重复工单，在关闭重复工单之前，将每张源工单的描述、联系历史和备注合并到父记录的备注中。 |
| 根据当前状态，将合并后的工单路由到正确的流程阶段。 | 对于每个合并后的父工单，检查其当前状态并将其移至正确的流程阶段：未解决的问题移至“进行中”，等待回复的工单移至“等待客户回复”，已解决的问题移至“已关闭”。 |
| 在合并前，对需要人工审核的工单进行标记。 | 在合并任何工单之前，请标记存在未决付款争议、SLA计时器正在运行或备注中标记为“升级”的记录。请勿合并这些工单，而应将其列出以供人工审核。 |
| 发送一份清理摘要，其中包含已合并的记录、未解决的问题以及后续跟进负责人。 | 工单合并完成后，向支持团队负责人发送一份摘要，其中应列出创建的每个父工单、合并至其中的源工单、需要跟进的未决问题，以及每个后续步骤的负责人。 |
支持团队
| 任务 | AI 代理的示例提示 |
| 无需手动打开多个记录即可审查客户历史。 | 提取该联系人的最近 5 个工单，总结每项解决情况，并标记任何反复出现的问题模式。 |
| 在创建新工单前，审查近期工单历史记录并识别客户反复出现的问题。 | 在为 [联系人] 创建新工单之前，请调取其最近的 10 份工单，总结每份工单的处理结果，并标记任何出现过多次的问题。请包含工单主题、状态和处理日期。 |
| 优先处理超过预期响应时间的工单。 | 查找所有在预期 SLA 时限内未收到回复的未结工单。按逾期天数排序，并包含工单负责人、联系人姓名和最后活动日期。 |
| 分析与计费相关的工单，以确定客户联系支持的最常见原因。 | 审查过去 90 天内所有标记为计费相关类别的工单。按数量排序，总结客户联系支持的前 5 大原因，并列出每种原因的平均解决时间。 |
| 根据相关的交易、订阅和升级历史记录准备工单回复。 | 针对工单 [工单 ID]，调取该联系人的相关交易历史、当前订阅详情以及以往的任何升级记录。总结背景信息，并起草一份能解决客户问题的回复。 |
客户成功团队
| 任务 | AI 客服的示例提示 |
| 利用多个 HubSpot 工具中的信息准备账户审查报告。 | 针对我本周的客户账户审查，请汇总我负责的业务范围内每个账户的未结交易、近期支持活动以及最新的NPS评分。 |
| 识别存在较高流失风险迹象的客户账户。 | 审查我负责的客户组合，并标记同时具备以下两项或以上信号的客户：产品登录频率下降、未解决的支持工单超过 14 天、NPS 评分低于 7，或过去 30 天内无客户成功经理（CSM）活动。按风险等级对它们进行排序。 |
| 找出产品参与度较低的续约联系人，以便主动联系。 | 筛选出所有在未来 60 天内即将续约的账户中，且过去 21 天内未登录产品的联系人。创建一份按优先级排序的联络清单，其中包含联系人姓名、账户、续约日期和最后登录日期。 |
| 通过汇总近期销售、支持及客户反馈活动，准备客户账户审查报告。 | 针对 [客户名称]，汇总过去 6 个月内的所有交易活动、未解决及近期已关闭的支持工单，以及任何 NPS 或 CSAT 反馈。请将此内容整理为一份 QBR 预备简报，以便我与客户团队分享。 |
| 通过对比客户增长趋势与历史交易规模，识别业务拓展机会。 | 查看我负责的客户群中，过去一年内员工人数或营收有所增长的客户。将它们当前的交易规模与同类客户的扩展规模进行对比，并标记出排名前10的客户作为潜在的业务扩展机会。 |
保持技能库的更新
HubSpot 客服代理 CLI 技能提供预定义的指导，帮助 AI 客服代理处理 HubSpot 数据并执行常见的 HubSpot 流程。该技能库包含有关 CRM 搜索、批量操作、数据质量任务、工作流、报表生成及其他运营活动的指导。
您可以在公共 GitHub 仓库中查看即将安装的技能。
要更新 AI 代理工作区中的技能库，请运行以下提示：
npx skills update
了解有关在Claude和ChatGPT 中使用技能的更多信息。
管理 HubSpot Agent CLI 的访问权限
超级管理员可以管理谁被允许连接 HubSpot Agent CLI。如果用户没有连接 HubSpot Agent CLI 的权限，则必须在连接前向超级管理员申请批准。
相关内容
