记录并关联 HubSpot…

在通过 HubSpot CLI 记录销售活动并需要把活动关联到联系人/交易时使用。

适用场景

解决思路

1. 先阅读 `bulk-operations/SKILL.md`，套用其中的 batching、pipe 和 dry-run 模式。
2. 写 `objects create` 时打开 `resources/activity-properties-reference.md`，查 calls/notes/meetings/tasks 的属性名和枚举值；因为当前 `hubspot properties get` 无法发现活动类型的枚举选项值。
3. 时间戳写入/读取规则：`objects create --property hs_timestamp=...` 写入的是 Unix ms（13 位）；`objects get --type calls <id>` 读回的是 `properties.hs_timestamp`（Unix ms 字符串）；`activities list --contact <id>` 读回的是顶层扁平字段 `timestamp`，格式为 ISO 8601（如 `2024-01-15T10:00:00Z`）。
4. 获取当前 Unix ms：macOS 用 `$(date +%s)000`，Linux 用 `$(date +%s%3N)`。
5. 创建 CALL：`call_id=$(hubspot objects create --type calls --property hs_call_title="Discovery call" --property hs_call_body="Confirmed $50K budget, Q2 timeline." --property hs_call_direction=OUTBOUND --property hs_call_status=COMPLETED --property hs_call_duration=1800000 --property hs_timestamp=$(date +%s)000 --format json | jq -r '.id')`，然后执行 `hubspot associations create --from calls:$call_id --to contacts:149` 和 `hubspot associations create --from calls:$call_id --to deals:456`。
6. 创建 NOTE：`note_id=$(hubspot objects create --type notes --property hs_note_body="Sent proposal. Follow-up Friday." --property hs_timestamp=$(date +%s)000 --format json | jq -r '.id')`，然后执行 `hubspot associations create --from notes:$note_id --to deals:456`。
7. 创建 MEETING：开始/结束时间用 Unix ms，并把开始时间复用为 `hs_timestamp`。命令：`start=$(date +%s)000; end=$(( ${start%000} + 3600 ))000; meeting_id=$(hubspot objects create --type meetings --property hs_meeting_title="Demo — Acme" --property hs_meeting_outcome=COMPLETED --property hs_meeting_start_time=$start --property hs_meeting_end_time=$end --property hs_timestamp=$start --format json | jq -r '.id')`，然后执行 `hubspot associations create --from meetings:$meeting_id --to contacts:149`。
8. 创建 TASK：`hs_timestamp` 是截止日期，不是创建时间。命令：`due=$(( $(date -v+7d +%s) * 1000 )); task_id=$(hubspot objects create --type tasks --property hs_task_subject="Confirm proposal received" --property hs_task_priority=HIGH --property hs_task_status=NOT_STARTED --property hs_task_type=CALL --property hs_timestamp=$due --format json | jq -r '.id')`，然后执行 `hubspot associations create --from tasks:$task_id --to deals:456`；Linux 上取 7 天后时间戳可用 `date -d '7 days' +%s`，再乘 1000。
9. 查询某联系人的未完成任务，用两次 CLI 调用，不用 xargs；`associations list` 每行输出 `{"id","type"}`，`objects get` 从 stdin 批量读取：`hubspot associations list --from contacts:149 --to tasks | hubspot objects get --type tasks --properties hs_task_subject,hs_task_status,hs_task_priority,hs_timestamp | jq -c 'select(.properties.hs_task_status != "COMPLETED")'`。
10. 批量给某个阶段的每个 deal 创建 follow-up task：deal ID 和 task ID 必须成对传递。第一步，生成每 deal 的 payload，并把 `deal_id` 与创建 payload 一起保留：`due=$(( $(date -v+7d +%s) * 1000 )); hubspot objects search --type deals --filter "dealstage=appointmentscheduled" --properties dealname | jq -c --argjson due "$due" '{deal_id: .id, payload: {properties: {hs_task_subject: ("Follow up: " + .properties.dealname), hs_task_priority: "HIGH", hs_task_status: "NOT_STARTED", hs_task_type: "CALL", hs_timestamp: ($due|tostring)}}}' > /tmp/deal_tasks.jsonl`。
11. 第二步，批量创建 tasks，一次 CLI 调用完成：`jq -c '.payload' /tmp/deal_tasks.jsonl | hubspot objects create --type tasks > /tmp/created_tasks.jsonl`。
12. 第三步，逐行 zip 两个 ID 列表，并通过 stdin 流式创建关联 pair：`paste <(jq -r '.deal_id' /tmp/deal_tasks.jsonl) <(jq -r '.id' /tmp/created_tasks.jsonl) | jq -Rc 'split("\t") | {from:("tasks:"+.[1]), to:("deals:"+.[0])}' | hubspot associations create`。
13. 超过 100 行时，套用 `bulk-operations/SKILL.md` 中的 dry-run / digest / confirm 模式。
14. 创建任何活动后必须立即用 `hubspot associations create` 关联到联系人/交易，否则活动在 CRM UI 中不可见。
15. 读取跨类型活动时间线时记住 `activities list` 的行结构是 `{"id","type","timestamp","title","body","status","owner_id"}`，没有原始属性名。
16. CLI 中没有 sequences/cadences；不要期望用此技能操作 sequences/cadences。

适用边界 · 注意事项

• 需要 CLI 原生 sequences/cadences 时不要使用此技能。
• 没有 HubSpot CLI 和 HubSpot CRM 账号/权限时不要使用此技能。
• 只想创建活动记录但不准备关联联系人/交易时不要使用，因为记录在 CRM UI 中不可见。