一、接口联调
1、 回调地址是什么?
回调地址对应于文档表2-2中的callbackURL与notifyURL。callbackURL是5G消息接入层发往Chatbot的消息中URL的根路径,格式为 http|https://domain|ip[:port]/,协议支持http和https,地址可以是域名也可以是ip,接收上行消息、状态报告通知、撤回结果通知等;notifyURL是5G消息接入层发往Chatbot的媒体文件审核结果消息中URL的根路径,格式为 http|https://domain|ip[:port]/,协议支持http和https,地址可以是域名也可以是ip。
2、配置出访IP的作用是什么?
用于开发者和5G消息系统交互时的校验。
3、出访IP可以配置多个吗?
官方CSP最多可配置15个IP。
4、配置的IP地址和回调地址可以修改吗?
目前支持线下邮件方式提交修改申请,后续可在中国移动5G消息运营平台提交修改申请。
5、serverRoot是什么?
服务器基础URL。
发送消息接口的serverRoot为:112.35.162.232:8078/mbmp/developer/accesslayer
媒体文件上传的serverRoot为:112.35.162.232:8078/mbmp/fileservice/accesslayer
6、apiVersion是固定值吗?
是的,目前固定填v1。
7、chatbotURI是什么?
在URL中,消息中携带为原始主叫号码,通知中携带为被叫号码,用于标识chatbot。格式为sip:12599@botplatform.rcs.chinamobile.com,其中@botplatform.rcs.chinamobile.com 为固定域名,红色部分替换为对应chatbotID即可。具体参见接口文档表1-3 。
8、Authorization是什么?
HTTP头域,保存鉴权信息,用于5G消息平台对Chatbot身份进行认证。具体计算方法见文档表2-2 。
9、消息头中的Address和消息体中的address有何区别?
按照文档示例填写接收方地址Request-URI即可:消息头中Address,群发消息固定填00000,非群发消息则填用户TEL URI;消息体中,群发时填群发列表中第一个地址,非群发则填用户TEL URI。
10、address和destinationaddress的区别是什么?
1)address字段为接受方地址Request-URI,存在于两个位置,分别是消息头和消息体:消息头中Address,群发消息固定填00000,非群发消息则填用户TEL URI;消息体中,群发时填群发列表中第一个地址,非群发则填用户TEL URI。
2)destinationaddress是消息体关键字段,群发消息中可携带接收方地址数组,最多支持100个。
11.conversationID和contributionID是什么意思?有什么用?
conversationID:用于唯一标识主被叫用户间的一个聊天对话,目前终端未实现,平台下行后终端返回不会再带此字段,通过UUID算法随机生成即可。
contributionID:唯一标识一个聊天会话,通过UUID算法随机生成,用户回复此消息时会将inReplyToContributionID值填为此contributionID的值,以标识是对此条消息的回复。用户上行消息的contributionID与终端下行的inReplyToContributionID对应,上行的每条消息contributionID都是随机生成。
二、消息下发
1、都可以下发哪些消息类型?
支持下发文本消息、文件消息、单/多卡片消息,以及带悬浮菜单的文本、文件、卡片消息。
2、如何区分不同的消息类型?
消息体中的contentType字段为消息类型标识,具体参见表1-10。
3、消息下发内容是否需要审核?
是。由MaaP平台对下发的消息内容进行机器审核,同时支持人工审核。
4、媒体文件是否支持外链直接下发?
不支持。下发文件消息或含文件的卡片消息前,需先调用媒体文件上传接口上传相应的媒体文件,平台响应中将含有该媒体文件的内链地址,可用于消息下发。
5、 媒体文件上传成功后是否可以直接使用内容地址下发?
否。媒体文件上传后,平台将对文件内容进行审核,审核结果平台将通过调用媒体审核通知接口异步同步至CSP的回调地址。审核通过的媒体文件可以用于消息下发。
6、媒体文件上传接口一次可上传多少个文件?
一次只能上传一个缩略图和一个文件,属于同一个tid两个URL。
7、上传媒体文件的格式和大小有没有要求?
媒体类型 | 格式要求 |
文本 | 纯文本格式的消息,支持发送的表情包含emoji表情和符号表情。dmoji表情参见本标准附录A,符号表情参见RCC.71 V2.4。 |
缩略图 | 格式要求:JPEG、JPG 大小:最大10KB |
图片 | 格式要求:至少支持JPEG、JPG、PNG、BMP(含全景图片)、GIF的发送和展示 大小:依据5G消息系统下发的文件大小参数来设置,如果系统侧没有下发该参数,则限定为不超过20MB |
音频片段 | 格式要求: 至少支持3GP、MP3、M4A、AAC、AMR的发送和播放 实时语音录制长度:最大60秒 选择本地音频大小:依据5G消息系统下发的文件大小参数来设置,如果系统侧没有下发该参数,则限定为不超过20MB |
视频片段 | 格式要求:至少支持MPEG4、3GP、WEBM的发送和播放 实时视频录制长度:最大90秒 选择本地视频大小:依据5G消息系统下发的文件大小参数来设置,如果系统侧没有下发该参数,则限定为不超过20MB |
8、文件审核时长是多久?文件有效期是多久?
文件上传后MaaP平台启动审核,文件有效期由MaaP平台设定,目前默认为72h。
9、消息发送报告应该如何选择?
通过发送消息接口中的reportRequest字段进行状态报告订阅,需要哪个状态报告就声明哪个,可选值参见表1-7,声明方式如下:

10、状态报告是否在消息发送后实时同步?
状态报告是采取异步通知方式。消息发送后,平台会返回发送相应,相应内容包括结果码、结果描述和消息ID。状态报告将由平台根据订阅情况,通过调用状态报告通知接口异步同步至CSP回调地址。
11、已下发的消息是否可以撤回?
对于已注册5G消息业务的用户,若用户终端不在线,则系统离线存储消息,存离线期间用户上线后将重新投递,若三天后仍未上线,则此条消息丢弃;存离线期间的消息支持撤回,需调用发送撤回消息接口进行撤回。
12、如何判断消息是否存离线了?
消息下发后若未收到任何状态报告,则考虑为用户离线,商户可选择撤回该条消息转为其他通道下发,或进行离线存储下发。
13、离线消息会存多久?
5GMC可设置消息离线存储时长,目前为72h。
14、发送消息撤回请求后平台是否会回复撤回结果?
是。平台会调用消息撤回结果通知接口通知chatbot撤回结果。
15、如果用户未注册5G消息业务会出现什么结果?
若chatbot未声明回落机制平台会返回发送失败的状态报告。
16、现在chatbot的接口是restful无状态的,conversationID和contributionID需要根据SIP协议来维护状态吗?对于发送http请求时,是不知道INVITE会话的生命周期的。
能否维护状态取决于终端。
社区开发者常见问题答疑汇总传送门:https://rcs.10086.cn/5gforum/d/72
江苏开发者大赛答疑文档:https://rcs.10086.cn/5gforum/d/173
备注:若QA未包含您的疑问,可以直接发帖到社区进行提问哟