用途:清理 HubSpot 中未使用的自定义属性,减少属性膨胀对表单、用户操作和数据映射的影响,覆盖联系人、公司、交易等对象类型。
主要能力:通过 Properties API(v3)盘点各对象的自定义属性,记录名称、标签、对象类型、类型、分组、有值记录数,以及是否被表单、工作流、列表使用;识别 Salesforce 同步属性(hs_salesforce_* 或同步映射)、名称含 test、temp、old_、copy_of 的属性及已停用集成创建的属性;支持先归档后删除的流程。
使用方式:前置条件为在 .env 中配置 HUBSPOT_ACCESS_TOKEN,需 crm.schemas..read 和 crm.schemas..write 权限,环境要求 Python 3.10+ 与 uv。流程分四阶段:规划阶段与用户确认采用归档优先还是直接删除,并确认是否有 Salesforce 同步及映射;执行前盘点属性;执行阶段对零记录且未被表单、工作流、列表使用的属性可安全删除,同步属性、表单字段、工作流依赖、计算属性需谨慎处理,建议先归档;归档通过 DELETE /crm/v3/properties/{objectType}/{propertyName} 完成,需先向用户展示列表并获得明确确认;之后等待 30 天再删除无问题的已归档属性,并记录清理日志。
适用场景:作为季度数据库清理例行工作,治理属性命名规范,限制自定义属性创建权限,避免触及 HubSpot 每对象属性上限。
限制与回滚:归档属性可随时取消归档,删除属性不可恢复,定义与关联数据将永久丢失,因此应先归档再删除以留出安全窗口。涉及 Salesforce 同步属性时应与 Salesforce 管理员协调。其余具体限制暂未提供。