用途:审计 HubSpot 表单,找出并清理未使用、测试或已弃用的表单,避免其干扰工作流与报表配置。
主要能力:通过 Marketing Forms API(v3)分页拉取全部表单,记录表单 ID、名称、类型、提交次数、创建日期与最后提交日期;按条件标记候选:创建超过 30 天且零提交、6 个月以上无提交且未嵌入活跃页面、名称含 test/temp/draft/copy of 的测试表单、被新版本替代的弃用表单。删除前检查表单是否被工作流入组触发器、落地页/网站页面、弹窗或滑入式 CTA 引用,再经用户明确确认后通过 DELETE /marketing/v3/forms/{formId} 或 UI 删除,并复检与记录清理日志。
使用方式:需在 .env 配置带 forms 权限的 HubSpot 私有应用访问令牌 HUBSPOT_ACCESS_TOKEN,使用 Python 3.10+ 与 uv。流程分计划、清理前、执行、清理后四阶段:先与用户确认清理力度(直接删除,还是先加 [DEPRECATED] 前缀下季度再删)及不可触碰表单;再盘点;然后标记候选并确认;最后复检和记录。
限制:部分套餐层级调用 Forms API 可能返回 403,此时需在 HubSpot UI 的 Marketing > Forms 手动审计。已删除表单无法在 HubSpot 恢复;含提交的表单删除后,提交数据仍保留在联系人记录,但表单定义消失,删除前应导出表单定义以便重建。建议建立命名规范,如 [TEAM] - Purpose - Version。