增长闭环
log_action 的默认行为
省略字段时，log_action 会怎样处理阶段和下次跟进时间，精确到每种情况。
log_action 记录一件做过或观察到的事。只有 action.summary 是必填的。本页把其余字段的行为讲清楚。
对应哪个机会
opportunity_id：就是那个机会（必须属于该项目）。url：对应规范化后 URL 相同的机会；未知的 URL 会自动登记（用title给它起名）。- 两者都没有：这次行动单独记录，不关联任何机会。
阶段
| 你传了 | 结果 |
|---|---|
省略 stage | 阶段不变。服务端绝不会根据行动去推断阶段。 |
stage 与当前相同 | 阶段没有变化。 |
stage 不同 | 阶段改变，并记录一条 stage_changed 事件。 |
下次跟进时间
| 情形 | 结果 |
|---|---|
给了 next_followup（{"in_days": 3}、{"at": "…"} 或 ISO 时间） | 设为该值。 |
next_followup: null | 清除。 |
| 省略，且阶段变了 | 按新阶段设置：contacted +3 天，replied +2 天，willing_to_talk +2 天；converted 和 dropped 清除。discovered 没有默认值，时间保持原样。 |
| 省略，且阶段没变 | 保持原样。 |
最后一行很关键。对一个已经过了跟进时间的机会再记一次行动，不会把时间往后推，所以它会继续以 followup_due 留在简报的 today 里，直到你设置新的 next_followup、传 null，或改变阶段。响应会返回 opportunity.next_followup_at，不用再调一次就能确认这个值。
对已有机会调用 track,next_followup 的行为一样：省略就是不变。
其他字段
| 字段 | 行为 |
|---|---|
experiment_id | 把这次行动挂到该实验上；如果机会还没有实验，也把机会挂上去。响应里带 experiment_progress。 |
link_code | 这次行动用到的短链接，用于点击归因。 |
outcome | 记录一个结果。与机会或短链接关联时算已归因（direct），否则是 unknown。如果 outcome.type 是 willing_to_talk 而阶段不是，hints 会提醒你把阶段也传上。 |
note | 额外说明；存在阶段变更或笔记事件里。 |
occurred_at | 事情发生的时间；默认现在。 |
idempotency_key | 用同一个 key 重复调用，会返回第一次的结果并带 duplicate: true，不再记录新内容。只要可能重试，就应该传。 |
不要记录
私信的原文和个人数据。像“发了私信，约一次通话”这样一句话的 summary 就够了。