用途:通过 HubSpot CLI 将销售活动(通话、笔记、会议、任务)记录到联系人和交易等对象上,并关联到相关记录,使其在 CRM UI 中可见。
主要能力与要点:
- 创建活动记录:用 hubspot objects create --type calls/notes/meetings/tasks 创建通话、笔记、会议、任务。
- 必须关联:单独创建的活动在 CRM UI 中不可见,必须紧随 hubspot associations create --from calls:<id> --to contacts:<id>(必要时再关联 deals)。
- 时间戳差异:写入 hs_timestamp 用 Unix 毫秒(13 位,如 $(date +%s)000);objects get 读取返回字符串;activities list 返回顶层 ISO 8601 的 timestamp。任务中 hs_timestamp 表示截止日期而非创建时间。
- 查询未完成任务:先 associations list --from contacts:<id> --to tasks,再通过 stdin 批量 objects get,最后用 jq 过滤。门户级排除状态用 @!=(NOT_IN),仅匹配有该属性的记录;要含空值需再加 !hs_task_status 条件组。仅包含某些状态用 @=(IN)。搜索过滤器上限为 5 个过滤器组、每组 6 条件、共 18 条件。
- 批量:先 search 交易并保留 deal_id,生成任务 payload 文件,批量 objects create,再用 paste 与 jq 将交易 ID 和任务 ID 配对,最后一次性 associations create。create 类操作是追加型,--dry-run 仅预览,去掉即执行,无 digest/confirm;更新/删除/合并等不可逆操作才需 digest 流程。
适用场景:面向销售代表在 HubSpot 中记录和整理通话、笔记、会议、任务,查询联系人未完成任务,为某阶段交易批量创建跟进任务并关联。
限制:活动必须立即关联否则不可见;活动属性枚举值可用 hubspot properties options-list --type calls <property> 查询,通话结果可用 hubspot activities calls dispositions list;Sales Hub sequences 在 CLI 中只读(list/get/enrollments,automation.sequences.read 权限),无法通过 CLI 将联系人加入序列;建议先读 bulk-operations/SKILL.md 了解批量、管道与 dry-run 模式。产品接口可能变化,使用前可重查 hubspot --help / CHANGELOG.md。