5G消息场景节点发送

本接口用于发送已经在平台上线的场景的节点，接口中涉及到的平台参数，请在平台上获取。

场景节点下发：指定场景中的任意节点发送消息模板。

1、接口地址

POST https://rcsapi.hanwg.com/rcs/scene/node/{{chatbotId}/{{sceneId}}/{{nodeId}}

2、请求参数

所有的请求参数名称都是区分大小写。

2.1、请求路径参数

名称	数据类型	是否必有	描述
{{chatbotId}}	string	是	在平台的申请的chatbot的编号
{{sceneId}}	string	是	在平台申请的场景的编号
{{nodeId}}	string	是	在平台申请的节点的编号

2.2、请求头参数

见全局参数

2.3、请求体参数

名称	数据类型	是否必有	描述
phone	array[string]	是	手机号码的集合默认最大支持200个号码
params	map(string, object)	是	请求触发动态参数参数格式：map(key, value)，key为变量名称，value为变量值
messageId	string	否	消息编号本条消息的唯一标识，建议用UUID，不填则平台自生成UUID，字符串长度限制范围：10-36

3、请求示例

{
    "phone": ["188********","159********"],
    "params": {
        "age": "10",
        "student": {
            "sex": "男",
            "name": "张三"
        }
    },
    "messageId": "47ea585e-d6c1-57fd-9de9-4770b19d1d46"
}

4、响应参数

名称		数据类型	是否必有	描述
code		int	是	响应状态码
desc		string	是	请求响应描述
result		object	条件	请求响应内容必需： code = 0（请求成功）
	messageId	string	条件	消息编号请求成功时返回本条消息在平台的唯一标识，与请求参数中的messageId一致
	time	date	条件	请求成功返回时的时间时间格式：yyyy-MM-dd HH:mm:ss
	failPhones	array[string]	条件	提交失败号码，请求成功且有失败号码

响应示例

{
  "code": 0,
  "desc": "请求成功",
  "result": {
    "messageId": "17dcf52dbc2d42dbbe4870f941af0c0f",
    "time": "2023-02-13 11:09:23",
    "failPhones": []
  }
}

文档更新时间: 2025-12-17 09:34 作者：王超