SuperAPI AI 工具集

fix-lifecycle-stages

通用与其它

查看项目

更新于 10-16 03:05

技能介绍

用途:确保 HubSpot 中每个联系人和公司都有合适的生命周期阶段,包括回填缺失阶段、纠正不允许的阶段值,并创建预防工作流自动为新记录分配阶段。缺失阶段会导致记录在管道报告中不可见、被阶段工作流排除、无法正确细分,并影响漏斗报告与线索评分。

主要能力:before.py 审计联系人和公司缺失及各阶段数量;execute.py 执行先清空再设置的修复(运行前需检查配置块中的不允许阶段映射);after.py 验证覆盖率。支持上下文感知分配:客户公司的联系人设为 Customer,商机公司的联系人设为 Opportunity,其余设为 Lead;公司有赢单交易设为 Customer,有进行中交易设为 Opportunity,其余设为 Lead。

必要用法:前置条件包括完成第一阶段清理、在 .env 中配置 HUBSPOT_ACCESS_TOKEN(需联系人和公司读写权限)、Python 3.10+ 与 uv、批量编辑权限及工作流访问权限。运行命令:uv run skills/fix-lifecycle-stages/scripts/before.py、uv run skills/fix-lifecycle-stages/scripts/execute.py、uv run skills/fix-lifecycle-stages/scripts/after.py。

关键限制:HubSpot 默认生命周期只能向前推进,顺序为 Subscriber > Lead > MQL > SQL > Opportunity > Customer > Evangelist。将记录从较后阶段移到较前阶段必须先清空再设置,且需两次独立 API 调用;直接设置会被静默拒绝。回滚依赖 execute 脚本的 CSV 审计记录,需用同样的先清空再设置模式恢复,并关闭预防工作流。UI 大批量编辑可能超时,建议逐页处理或使用 API。具体不允许阶段映射需按自身业务定义,资料未提供固定映射。