Skip to content

发送主动消息

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",此时读取 skipCodeskipReason,不要强制发送。

生成成功只表示内容已经产生,不表示消息已送达第三方用户。调用方需要自行完成投递和结果记录。

完整字段见主动消息接口