用途:管理 HubSpot CRM 记录的负责人(hubspot_owner_id),支持记录归属分配、重派、跨对象类型审计以及代表离职交接,基于 bulk-operations 技能实现。使用前需先阅读 bulk-operations/SKILL.md,JSONL 管道、分页、dry-run/digest/confirm 及历史恢复均在该处说明。
主要能力与用法:hubspot_owner_id 是联系人、公司、交易和工单上的字符串字段;负责人是 CRM 用户,可用 hubspot owners list 获取,系统无 teams 对象,团队视图需按 hubspot_owner_id 在客户端分组。
- 解析邮箱到 owner ID,不要硬编码 ID,因为它们因门户而异,解析后应缓存。
- 按负责人查找记录:对四种对象类型使用同一过滤条件,如 hubspot objects search --type contacts --filter "hubspot_owner_id=$FROM_ID" --properties email,firstname,lifecyclestage;无负责人记录用 !property 形式,如 --filter "!hubspot_owner_id"。超过 100 条需按 bulk-operations 的 --after 循环分页。
- 批量重派:先搜索再更新,将每行重塑为 {id, properties:{hubspot_owner_id}} 并管道到 objects update。objects update 不可逆,必须先 dry-run 生成 digest 与 apply_command_hint,然后带 --digest/--confirm 重跑(confirm 对单条为记录 ID,对批量为行数)。单条分配无需 jq 与 stdin,但同样需先 dry-run。
- 代表离职流程:循环联系人、公司、交易、工单四种类型,先 dry-run 输出预览,审阅后逐类型带 digest/confirm 执行。误重派可用 hubspot history --since 1h 列出受影响 ID。
- 团队级视图:按 hubspot_owner_id 分组记录,再与 owners list 连接得到可读邮箱。
限制:所有更新操作不可逆,必须遵循 dry-run/digest/confirm 安全流程;团队视图仅能在客户端分组,系统不提供 teams 对象;ID 因门户而异,不可硬编码。其余具体收费、价格、平台等信息资料暂未提供。