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   作者:王超