SuperAPI AI 工具集

cleanup-deals

办公与效率

查看项目

更新于 10-16 03:36

技能介绍

用途:标准化交易数据,让管道报表更准确,减少测试交易、缺失金额和陈旧商机对预测与管道指标的干扰。

前置条件:需要 HubSpot 私有应用访问令牌(.env 中的 HUBSPOT_ACCESS_TOKEN),具备 crm.objects.deals.read 和 crm.objects.deals.write 权限;Python 3.10+ 与 uv;并需了解哪些管道处于启用状态、哪些由 Salesforce 同步而来。

Salesforce 同步注意事项:若交易由 Salesforce 同步,未经 Salesforce 管理员协调,不要删除或修改同步交易;HubSpot 的改动可能回写 Salesforce 导致数据丢失。可通过 hs_salesforceopportunityid 属性识别同步交易。

使用流程:先规划,与用户确认范围管道、哪些属于 Salesforce 同步(未协调不碰),以及关闭废弃交易的陈旧阈值(默认 90 天无活动)。再用 CRM Search API 记录清理前指标,包括交易总数、各阶段交易数、缺失金额、缺失关闭日期,以及 60 天以上无活动的陈旧交易。执行阶段:删除名称含 test、demo、sample 或金额为 0 且无关联联系人的测试交易;处理缺失金额,与销售协作补值或标记为失败;审查并关闭 90 天以上无活动的开放交易,废弃则设为 Closed Lost;统一各管道阶段名称与概率;归档或删除零活跃交易且未使用的管道。之后重跑审计查询,确认测试交易已移除、缺失金额与陈旧交易数下降,并核对管道报表。

回滚:已删除交易可在 90 天内从 HubSpot 回收站恢复;阶段变更和属性更新可手动还原,但无批量撤销;Salesforce 同步交易还需检查 Salesforce 回收站。

提示:可建立交易卫生规则,如 60 天无活动自动提醒负责人;将 amount 和 closedate 设为必填属性以防未来出现缺口。