用途:审计并清理 HubSpot 中无用工作流,减少自动化面板中的杂乱,让真正运行的内容更易理解。
主要能力:通过 v4 Automation API 清点全部工作流,记录 flow ID、名称、启用状态、类型、创建与更新时间;识别停用 90 天以上、从未有注册、名称含 test/temp/copy of/draft 的测试项、已被新版本取代、持续报错的工作流;删除前检查工作流是否被其他工作流触发或引用、是否设置其他工作流依赖的属性、是否有文档引用。
使用方式:需 HubSpot 私有应用访问令牌(.env 中 HUBSPOT_ACCESS_TOKEN),具备 automation scope;需 Python 3.10+ 与 uv。建议先运行 /workflows-as-code 导出所有工作流的 JSON 备份。流程分四阶段:确认归档优先策略(先停用,等一周再删除)及不可触碰的工作流;清点工作流;标记候选并等待用户明确确认,确认后先停用,等一周,再删除;删除后重新清点、记录清理日志并通知负责人。停用可用 UI 或 PUT /automation/v4/flows/{flowId} 并传 isEnabled: false(需当前 revisionId),删除可用 DELETE /automation/v4/flows/{flowId} 或 UI。若 API 报 403,某些套餐层级需在 HubSpot UI 的 Automation > Workflows 手动审计。
适用场景:定期清理 HubSpot 自动化工作流,如季度评审。
限制:已删除工作流无法在 HubSpot 恢复;可从预先导出内容用 POST /automation/v4/flows 重建;HubSpot 仍保留联系人上的工作流活动历史;需注意套餐层级可能导致 API 403。