闪信业务接入指南.docx

《闪信业务接入指南.docx》由会员分享，可在线阅读，更多相关《闪信业务接入指南.docx（13页珍藏版）》请在第一文库网上搜索。

1、闪信业务接入指南大众通信2023年XX月1w在信息泄露等问题愈发严重的当今，客户往往习惯于拒接未知来源的呼叫；对于企业来说，也存在着通过电话告知客户企业信息和相关宣传的需求。基于闪信技术，可以为客户在电话响铃前、响铃中、挂机后，为客户推送企业相关文字信息，达到企业身份展示、商务合作、营销推广等目。2概述闪信是一项主叫和被叫用户均能定制的、在通话过程中附加传递图文内容的信息服务产品。在语音呼叫接通前、通话中、挂断后，在手机上展示预先设定的彩印内容（文本等），以达到彰显个性、分享心情、商情传递等目的。彩印信息通常是用户自行编辑或由内容提供商提供的，在通话对方的手机上展示。本接口将通信+服务平台的闪

2、信能力开放出来，让第三方业务和平台都能使用类似闪信的功能。3接入指南3.1接入流程接入通信+服务平台开发，开发者需要按照如下步骤完成:1、提供服务器地址2、申请接入凭证a页产旦解决方案开发者中心QQ账户胃理即原户主页接口业务念旭电五调度s7S1P对接心云话机“本负料-RnI1rSHtfiI芮息管理pa充(12聚资费列若*m系统售理用户曾理角色权限贵作E案蜉信息a!9M1.个卢立丸照企北H11M00域U才创3用&行侵M.2.wftttf1f1cRx*Hav订跟小号虚拟小号云呼小号AWifeafiiSfei孑机号号通.WfS4、实现业务逻辑具体操作细节请咨询客服。4接口4.1 投递该接口用于投递闪

3、信信息，由玖云开放平台提供给第三方。4.1.1 接口地址softVersion）AccontsaccountSid）F1ashSmssend RESTAP1通过HTTPS方式请求PoST 请求方法：POST*UR1由平台方提供，实际对接时以平台方提供的地址为准；*包头和Ur1相关信息，请参照对应接文档：4.1.2请求参数请求参数说明参数参数类型必选说明app1dString是应用idbjString是接收对象temp1ateString是发送的模板类型编号需要提前申请ZjString是主叫（发送的热线号码）directionString否呼叫流程（默认是Mo）M0：主叫流程（去除国家码前缀后t

4、arget必须和ca11ed相同）MT：被叫流程（去除国家码前缀后target必须和Sca11ing相同）请求案例报文:2016-01-01Accounts798b9ec0eaaaa2cF1ashSmssend7sign=6949C5F977B304EC5BB969FD8838D345HTTP1.1Host:127.0.0.1:9080content-1ength:272Accept:app1ication/json;Content-Type:app1ication/json;charset=utf-8;Authorization:Nzk4Yj11YzBIYWE5NDE0Mjg1MjYwMmM

5、0AAI1NzAxNDY6MjAxNjAzMjQxNTE3MDE=(req:appid:abcd1341adfd,bj:138XXXXXXXX,zj:temp1ate*:123,direction:MO4.1.3响应参数 resp参数说明参数参数类型必选说明dataObject是数据正常返回的报文（正确请求发送有错误时没有）StatusCodeString是错误提示码，错误时有。正确时没有representString是提示信息,错误时有。正确时没有Data对应的数据如下: head参数说明参数参数类型必选说明request1dString是请求idcodeString是状态码（根据状态码判断

6、是否成功）msgString是响应信息data参数说明参数参数类型必选说明taskidString是任务ID其它参数:参数参数类型必选说明successString是true或f1ase4.1.4 响应示例resp:data:(data:taskid:628411,headcode601,msg,7,temp1ateandhot1inenotmatch,requestId,ad7e86b1b757416d9a3ed18eb93a60081successfa1se)如果返回异常不通过则：(resp:statusCode:0900001M,represent:主叫号码格式错误4.1.5 注意事项

7、对同一个手机号码同一个模板投递两次之间的时间间隔有要求，默认30秒。 对同一个手机号码同一个模板一个自然日内投递上限次数有要求，默认5次； 对同一个手机号码一个自然日内投递上限次数有要求，默认10次。超过限制将无法向此号码投递。4.1.6响应结果码枚举值描述4闪信已提交网关(msgType=2或4有效)Thef1ashSMhasbeensubmittedtothegateway5闪信提交网关失败Thef1ashSMsubmittedtothegatewayfai1edmsgType=2或4有效)6短信已提交TheSMhasbeensubmitted7短信提交失败TheSMsubmittedfa

8、i1ed10投递请求接收失败De1iveryrequestreceivefai1edCmsgType=I或3或5有效)11域选提交成功101错误的请求方法Inva1idrequestmethod102错误的请求参数(P1atfOrmid)Inva1idparameter-p1atformid103错误的请求参数(timestamp)Inva1idparameter-timestamp104错误的请求参数（V）Inva1idparameter-v105错误的请求参数(sign)Inva1idparameter-Sign107错误的请求参数(body)Inva1idparameter-body10

9、8错误的请求参数CcaIIEvent)Inva1idparameter-CaIIEvent109无效的来访UR1UnknownremoteURI112消息中无bodyNobodyinHTTPrequest113body中不是json格式Bodyisnotjsonformat114无法识别的投递号码Inva1idtargetnumber115投递号码在黑名单中targetinb1ack1ist116用户未申请异网服务NoserviceofSMSsupportp1atform117非法签名signaturei11ega1118非法源号码srci11ega1119无使用此类服务的权限Noservic

10、eofmsgtype%d120投递号段受限targetsegmentisrestricted121超出流量限制Beyondf1uidcontro1122投递类型与模版不匹配De1iverytypenotmatchingtemp1ate125未授权使用此接入号srcnotauthorized126不能短时间内连续向同,个号码投递Targetde1iverytimeinterva11imit127一天内向同一个号码投递次数达到上限Targetde1iverydaysum1imit128非移动号码noncmccphone131投递对象与主叫号码不符Targetnotmatchsca11ing132投

11、递对象与被叫号码不符Targetnotmatchca11ed201到达套餐上限停发Reachmaximumde1ivery1imit202含有敏感词I11ega1wordfound203查询接口失败checkappapifai1204资源不足APIresourceunavai1ab1e205获取应用ID或版本失败noappkeyornoversion206消息内容长度超过限制1engthofthemessagecontentexceeds1imit210UTF8转GBK失败utf8togbkerror213此目标号码状态不适合投递USSDThisstatusofnumberisnotsuita

12、b1eforde1iveringUSSD（应用场景为指定投递方式为只投USSd方式，域查询结果为闪信，则返回此响应）300接入方状态不正常thirdpartystatusva1id500未知处理状态UnknownerrorSO1服务处理错误Serviceerror600目标内容状态不正确Targetde1iverycontentstatusisunab1e601模板和号码关系不匹配temp1ateandhot1inenotmatch602域选接口查询超时或失败domainSe1ectionQuerytimeoutorfai1ed603模板不在企业下temp1atesarenotunderthe

13、enterprise604运营商不支持605系统繁忙606模板不支持用户归属运营商999域选提交失败4.1.7注意事项暂无4.2投递结果通知该接口用于通知消息，由玖云平台发给第三方。4.2.1 接口地址用户自行配置UR1地址。通过POST方式请求通知用户，只提供XM1格式。4.2.2 请求参数请求包头参数参数类型必选说明Content-TypeString是类型app1ication/xm1Content-1engthString是消息体长度请求包体参数参数类型必选说明taskidString是任务ID,由能力开放平台分配，用于异步通知结果的关联targetString是接收对象，对应于请求消息中targetstatusStrin