SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场hubspot-sales-audit

hubspot-sales-audit

营销与增长

查看项目

更新于 10-17 03:41

技能介绍

用途

hubspot-sales-audit 是对 HubSpot 门户中销售运营相关内容的只读审计技能，核心问题是：销售管道所呈现的数据是否可信。预测本质上是对交易记录求和，如果大量开放交易缺少金额、关闭日期已过、负责人已离职，预测在人工判断之前就已失真。该审计把这类问题量化，并指出可修复项。

与其他审计的关系

该技能与 /hubspot-audit、/hubspot-marketing-audit 共用同一引擎。它运行共享维度（数据库规模、负责人健康度、公司数据、重复项）加销售维度，跳过送达率与互动相关检查。由于共享维度由同一份代码计算，各范围下的数字与市场团队的审计结果一致。

选择方式：只负责销售用本技能；只负责市场用 /hubspot-marketing-audit；整个门户用 /hubspot-audit（两份视角合并为一份报告）。

前置条件

  • 已同时安装 hubspot-audit 技能（提供引擎）
  • .env 中配置 HUBSPOT_ACCESS_TOKEN，具备 deals、contacts、companies、owners 的读权限；如需填充“活动与跟进”维度，再加 tasks 和 leads 的读权限
  • Python 3.10+ 与 uv

审计可在任何有交易对象的 HubSpot 版本上运行；leads 对象需要 Sales Hub，没有时对应行显示 n/a。

运行方式

引擎位于相邻的 hubspot-audit 技能目录中。请在项目目录下运行，以便 .env 和 reports/ 正确解析（在仓库克隆中路径为 skills/hubspot-audit/scripts/audit_portal.py）：

uv run ../hubspot-audit/scripts/audit_portal.py --scope sales

输出 reports/hubspot-sales-audit-{YYYY-MM-DD}.md 及同名 .json 文件。

测量内容

  • 管道配置：管道数量、每条管道的交易与开放交易数、零交易管道、开放阶段超过 10 个的管道；评分依据为空管道与臃肿管道。
  • 交易数据质量：开放交易缺少金额、关闭日期、负责人或关联联系人；关闭失败交易缺少失败原因；评分依据为缺失金额与关闭日期。
  • 管道卫生与速度：60 天以上无活动记录的开放交易、关闭日期已过的开放交易、无下一步活动的开放交易；近 90 天成交数与赢单率；评分依据为停滞与过期交易。
  • 销售归属与交接：负责人已停用的开放交易；SQL 和 Opportunity 阶段联系无负责人；Opportunity 阶段联系无交易；评分依据为无主交易与无主销售阶段联系。
  • 活动与跟进：开放任务、逾期开放任务、线索、无负责人线索；评分依据为逾期任务。
  • 共享维度：负责人健康度、公司数据、数据库规模、重复项，详见 /hubspot-audit。

阈值是脚本中 # --- Configuration --- 区块的常量：STALE_DEAL_DAYS（60）、WIN_RATE_WINDOW_DAYS（90）、MAX_STAGES_PER_PIPELINE（10）。阅读评分前应按自身销售周期调整；60 天停滞窗口对大额企业交易偏严格，对交易型业务偏宽松。

结果解读要点

  • 过期关闭日期优先处理：开放交易关闭日期在过去，说明它已成交、延后或失败，但记录未反映，这是成本最低的预测修复。
  • 停滞是对话而非删除：60 天无活动可能是死单，也可能是销售不记录。先抽样确认（可用 MCP 服务，见 /connect-hubspot-mcp），两种问题修复方式不同。
  • 缺金额比缺交易对加权管道影响更大：无金额交易对加权报表贡献为零。若早期阶段确实还没有金额，应在应存在金额的阶段起将金额设为条件必填。
  • 无主开放交易属 P0：负责人已停用的交易无人跟进且不出现在任何人的预测中，应最先重新分配。
  • 交接缺口反映市场与销售的分歧：SQL 或 Opportunity 阶段联系无负责人说明路由中断；Opportunity 阶段联系无交易说明生命周期阶段被手工或由不创建交易的工作流设置。这两行应与市场运营共享。
  • 失败原因是最便宜的赢单/输单数据：若多数关闭失败交易没有原因，应在 Closed Lost 阶段将该属性设为必填。
  • 赢单率仅作背景参考，不影响评分。停滞交易很多的管道若赢单率健康，通常意味着失败交易从未被关闭。

从发现到修复

建议顺序：1）/reassign-deactivated-owners 处理离职负责人的开放交易与联系；2）/assign-unowned-contacts 处理无人跟进的销售阶段联系；3）/cleanup-deals 处理缺失金额与关闭日期、停滞与过期交易、测试交易、未使用管道；4）/cleanup-lead-owners 处理无主公司、交易、线索及非员工用户；5）/fix-lifecycle-stages 处理无交易的 Opportunity 阶段联系及阶段错误的客户；6）/lifecycle-progression-workflow 建立交接自动化防止缺口重现；7）/merge-duplicate-companies 合并拆分交易历史的重复账户。可用 /hubspot-implementation-plan 将报告转为分阶段计划。

预防优于清理：三项门户设置可阻止本审计发现的大部分问题，均在 HubSpot 界面配置——按交易阶段设置必填属性（Settings > Objects > Deals > Pipelines）、限制跳阶段与回退的管道规则、以及开放交易超过停滞窗口无活动时自动为负责人创建任务的工作流。

不覆盖的范围

  • 预测准确性与各阶段停留时间：由 HubSpot 预测工具与管道报表负责；Sales Hub Professional 及以上可通过 API 读取预测提交（crm.objects.forecasts.read）以扩展引擎。
  • Sequences：Sequences API 仅支持用户级认证，账户级令牌无法审计注册情况。
  • 销售个人绩效：本审计衡量数据质量而非人；按负责人拆分是有意省略的，仅在团队就用途达成一致后再添加。
  • 报价、产品与行项目：暂不在范围内。

回滚

无需回滚，审计只读。如需移除输出，删除 reports/ 下生成的文件即可。