5G消息场景发送
1、概述
本接口用于发送已经在平台上申请制作上线的场景,接口中涉及到的平台参数,请在平台上获取。
场景:顾名思义,即对话处于不同的场景则发送相应的消息模板。一个场景拥有一个对话流程,每个节点都有进入条件,在流程中触发了下一节点条件,可以自动发送相应的已配置的消息模板给终端。场景分为主动场景、被动场景,主动场景由客户主动发送场景消息进入,被动场景由终端用户触发场景的【开始节点】的“进入条件”进入。
场景下发:发送开始节点的消息模板。
场景节点下发:指定场景中的任意节点发送模板。
场景交互超时时间默认1分钟。
场景交互的开启需要chatbot设置为托管模式,且场景需要上线才能使用:

场景下发接口的调用需要先在web中配置场景:

场景实例
2、接口地址
POST https://rcsapi.hanwg.com/rcs/scene/send/{{chatbotId}}
3、请求参数
3.1、请求路径参数
见全局参数
3.2、请求头参数
3.3、请求体参数
| 名称 | 数据类型 | 是否必有 | 描述 |
|---|---|---|---|
| phone | array[string] | 是 | 手机号码的集合 默认最大支持200个号码 |
| sceneId | string | 是 | 场景编号 |
| messageId | string | 是 | 消息ID 本条消息的唯一标识,建议用UUID |
4、请求示例

{
"phone": [
"15766666666"
],
"sceneId": "555",
"messageId": "{{uuid}}"
}
5、响应参数
| 名称 | 数据类型 | 是否必有 | 描述 | |
|---|---|---|---|---|
| code | int | 是 | 响应状态码 | |
| desc | string | 是 | 请求响应描述 | |
| result | object | 条件 | 请求响应内容 必需: code = 0(请求成功) |
|
| messageId | string | 条件 | 消息编号 请求成功时返回本条消息在平台的唯一标识 |
|
| time | date | 条件 | 请求成功返回时的时间 时间格式:yyyy-MM-dd HH:mm:ss |
|
| failPhones | array[string] | 条件 | 提交的失败号码 条件:请求成功且有失败号码 |
|
6、响应示例
{
"code": 0,
"desc": "请求成功",
"result": {
"messageId": "2b73f33402ac4271adc7577a5a7a5459",
"time": "2023-02-13 09:50:02",
"failPhones": []
}
}文档更新时间: 2025-12-17 09:34 作者:王超