测试版使用 HubSpot 客服 CLI

HubSpot Agent CLI 可将 AI 编程助手（如Claude Code、Claude Cowork 和OpenAI Codex）与您的 HubSpot 账户连接起来。 将 Agent CLI 连接到 HubSpot 后，您可以要求 AI 助手完成重复性的 CRM 任务、分析数据、生成摘要，并协助管理整个账户的工作流程。当您将任务委派给 AI 助手时，它们可以利用 Agent CLI 代表您自动化处理日常工作，从而帮助您的团队将更多时间投入到战略性工作中。

例如，您无需每周手动审查记录，而是可以要求 AI 代理根据 HubSpot 中的信息，识别不完整的记录、汇总销售漏斗活动或准备客户账户审查报告。

如果您是希望编写自定义脚本或在终端中手动使用 HubSpot Agent CLI 的开发者，请参阅我们的开发者文档。

开始之前

在开始使用 HubSpot Agent CLI 之前，请确保您拥有 AI 编码代理的访问权限。支持的代理包括 Claude Code、Claude Cowork、OpenAI Codex 以及许多其他兼容的 AI 编码代理。

请注意：如果您在团队或企业账户中使用 Claude Cowork，您的组织管理员可能需要将api.hubapi.com加入白名单，CLI 才能安装或运行。了解有关在 Claude Cowork 中添加白名单的更多信息。

HubSpot Agent CLI 可访问的 AI 代理

HubSpot Agent CLI 可利用已连接的 HubSpot 用户的权限执行操作。根据您的用户权限，这可能包括在您的账户中创建、更新或删除记录。

连接 HubSpot Agent CLI 后，AI 代理可处理您整个 HubSpot 账户中的信息，包括：

• 联系人、公司、商机、工单、自定义对象及其他 CRM 记录。
• 工作流。
• 销售管道及销售管道阶段。
• 属性与自定义属性。
• 收入记录（只读）：合同、发票、订单、付款、报价、报价模板和订阅（测试版）。

请注意： 如果您是 超级管理员，您可以选择让您的账户参与HubSpot Agent CLI 中的 收入数据 测试版。

• 记录之间的关联。
• 活动历史记录。

请注意：在对 CRM 数据进行更改之前，请务必审查 AI 生成的建议和拟采取的行动。

最佳实践

在与连接到 HubSpot 的 AI 代理协作时：

• 请先从报告、摘要和分析任务入手，再使用会修改数据的操作。
• 在应用更改之前，请先审查生成的建议和大规模更新。
• 某些操作可能会删除或覆盖 HubSpot 数据。如有提供，请使用--dry-run 选项在应用更改前预览结果。
• 使用清晰明确的提示语，描述期望的结果。
• 请遵守贵组织的数据治理和安全政策。

连接 HubSpot Agent CLI

请按照以下步骤指导您的代理安装 HubSpot Agent CLI。如果您是开发人员，请了解有关手动安装 HubSpot Agent CLI 的更多信息。

1. 打开您的 AI 代理，例如Cowork或Codex。
2. 将以下提示粘贴到您的智能助手工作区中，以安装 Agent 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.

3. 出现提示时，请登录您的 HubSpot 账户。
4. 查看所需的权限。
5. 点击“连接应用”。

身份验证完成后，AI 助手即可根据您的权限访问 HubSpot 数据。

要开始使用，请使用以下示例提示之一。

用例示例

以下示例展示了不同团队如何使用通过 HubSpot Agent CLI 连接的 AI 代理。该代理对于需要审查大量 CRM 数据的重复性运营工作尤为有用。

市场营销团队

任务：识别需要跟进或数据清理的联系人。

AI 代理的示例提示：每周一上午 8 点，查找符合高匹配度标准、但未关联任何交易、近期无销售活动或缺少关键数据丰富字段的联系人，然后向 RevOps 发送一份按优先级排序的清理清单，并附上建议的后续行动。

其他示例包括：

• 审查电子邮件营销活动，找出不符合品牌语调指南的主题行和行动号召（CTA）。
• 识别高转化率着陆页中与更高转化率相关的信息传递模式。
• 针对在培育序列中未打开邮件的联系人，创建重新激活名单。
• 跟踪源自网络研讨会活动的商机当前销售漏斗状态。
• 分析最匹配客户群体的行业、公司规模及潜在客户来源模式。
• 监控正在运行的邮件序列，并对邮件打开率出现显著下降的情况进行标记。

销售和营收运营团队

任务：监控销售管道健康状况，并识别需要关注的交易。

AI 助手的示例指令：每天早上 7 点，检查我的销售管道中本周即将成交、且过去 5 天内无任何活动的交易，并向我发送一份摘要。

其他示例包括：

• 查找需要跟进和审查的、处于休眠状态的高价值交易。
• 通过汇总交易、支持、邮件和备注历史记录，为客户会议做准备。
• 分析流产的交易，以确定销售流程中机会停滞时间最长的阶段。
• 生成一份每日摘要，列出临近成交日期但近期缺乏动态的交易。

销售主管

任务：分析通话记录，提取 coaching 和产品反馈主题。

AI 代理的示例提示：分析最近的通话记录，关注通话时长、竞争对手提及、客户反馈以及潜在客户犹豫的主题，然后创建一个包含通话记录示例和源通话链接的辅导与产品反馈仪表盘。

其他示例包括：

• 识别通话时长模式异常偏高或偏低的销售代表或团队。
• 找出近期销售通话中反复出现的竞争对手提及内容。
• 按客户细分、交易阶段或产品领域汇总潜在客户的犹豫主题。
• 提取支持辅导或产品反馈主题的通话记录示例。
• 创建一个仪表盘，将通话洞察与源记录和通话记录关联起来。

RevOps 和 CRM 管理员

任务：清理 CRM 属性，同时确保不影响下游资产。

AI 代理的示例提示：查找重复或已弃用的 CRM 属性，显示它们在工作流、报告和视图中的使用位置。然后预览清理方案，以替换、删除或重新排序字段，再应用更改。

其他示例包括：

• 识别在不同对象中收集相同信息的重复属性。
• 查找仍出现在工作流、报告、视图或记录布局中的已弃用字段。
• 在进行更改前，预览删除或替换 CRM 字段可能产生的影响。
• 重新排序记录字段，以便管理员和销售代表首先看到最重要的信息。
• 生成清理摘要，显示已更改的内容以及仍需审核的内容。

运维团队

任务：合并相关支持工单并保留清理历史记录。

AI 代理的示例提示：合并重复的客服工单，保留源工单的详细信息，将每个父工单路由到正确的流程阶段，并向团队发送一份清理摘要，其中包含仍需审核的记录。

其他示例包括：

• 查找同一客户或同一问题类型下的重复或相关支持工单。
• 将工单上下文合并到父工单中，同时保留源工单的详细信息。
• 根据当前状态，将合并后的工单路由至正确的流程阶段。
• 在合并前标记需要人工审核的工单。
• 发送清理摘要，其中包含已合并的记录、未解决的问题以及后续跟进负责人。

支持团队

任务：无需手动打开多个记录即可查看客户历史信息。

AI 代理的示例提示：提取该联系人的最近 5 个工单，总结每项解决情况，并标记任何反复出现的问题模式。

其他示例包括：

• 在开启新工单前，审查近期工单历史记录并识别客户反复出现的问题。
• 优先处理超过预期响应时间的工单。
• 分析与账单相关的工单，找出客户联系支持团队的最常见原因。
• 在准备工单回复时，纳入相关的交易、订阅及升级处理记录。

客户成功团队

任务：利用来自多个 HubSpot 工具的信息准备账户审查报告。

AI 客服的示例提示：针对我本周的账户审查，请总结我负责业务范围内每个账户的未结交易、近期支持活动以及最新的 NPS 评分。

其他示例包括：

• 识别存在较高流失风险迹象的客户账户。
• 找出产品参与度较低的续约联系人，以便主动联系。
• 通过汇总近期销售、支持及客户反馈活动来准备客户账户审查报告。
• 通过对比客户账户增长趋势与历史交易规模，识别业务拓展机会。

保持技能库的更新

HubSpot 客服代表 CLI 技能提供预定义的指导，帮助 AI 客服代表处理 HubSpot 数据并执行常见的 HubSpot 流程。该技能库包含有关 CRM 搜索、批量操作、数据质量任务、工作流、报告及其他运营活动的指导。

您可以在公共 GitHub 仓库中查看即将安装的技能。

要更新您 AI 代理工作区中的技能库，请运行以下提示：

npx skills update

了解有关在Claude和OpenAI Codex 中使用技能的更多信息。

管理 HubSpot Agent CLI 的访问权限

超级管理员可通过加入“应用安装治理”测试版，管理谁被允许连接 HubSpot Agent CLI。

如果用户没有连接 HubSpot Agent CLI 的权限，则必须在连接前向管理员申请批准。

了解有关如何管理HubSpot 账户中可安装应用的更多信息。