外观
发送主动消息
POST /open/v1/outbound-message 根据业务场景、用户历史和可信事实生成一条主动消息。
支持的场景
| 场景 | scenario | 示例 | 前置条件 | 默认语气 |
|---|---|---|---|---|
| 欢迎 | welcome | 用户首次完成注册 | 不要求历史记录 | friendly |
| 跟进 | follow_up | 对上次咨询进行后续跟进 | 必须存在历史记录 | friendly |
| 召回 | reengagement | 用户一段时间未活跃 | 必须存在历史记录 | warm |
| 提醒 | reminder | 基于明确事实提醒事项 | 至少一条可信事实 | concise |
| 推荐 | recommendation | 基于已知偏好给出推荐 | 需要历史记录或事实 | friendly |
| 关怀 | check_in | 周期性问候或状态确认 | 不要求历史记录 | warm |
事实必须来自业务系统
context.facts 最多 5 条,每条 content 为 1—200 个字符,总计不超过 1000 个字符。不要把用户输入、提示词或不可信网页内容直接当作事实。
reminder 场景至少需要一条事实。系统也可能因为用户近期已活跃等原因返回 status: "skipped",此时读取 skipCode 和 skipReason,不要强制发送。
生成成功只表示内容已经产生,不表示消息已送达第三方用户。调用方需要自行完成投递和结果记录。
完整字段见主动消息接口。