闪信业务接入指南.docx
闪信业务接入指南大众通信2023年XX月1w在信息泄露等问题愈发严重的当今，客户往往习惯于拒接未知来源的呼叫；对于企业来说，也存在着通过电话告知客户企业信息和相关宣传的需求。基于闪信技术，可以为客户在电话响铃前、响铃中、挂机后，为客户推送企业相关文字信息，达到企业身份展示、商务合作、营销推广等目。2概述闪信是一项主叫和被叫用户均能定制的、在通话过程中附加传递图文内容的信息服务产品。在语音呼叫接通前、通话中、挂断后，在手机上展示预先设定的彩印内容（文本等），以达到彰显个性、分享心情、商情传递等目的。彩印信息通常是用户自行编辑或由内容提供商提供的，在通话对方的手机上展示。本接口将通信+服务平台的闪信能力开放出来，让第三方业务和平台都能使用类似闪信的功能。3接入指南3.1接入流程接入通信+服务平台开发，开发者需要按照如下步骤完成:1、提供服务器地址2、申请接入凭证a页产旦解决方案开发者中心Q÷Q账户胃理即原户主页接口业务念旭电五调度s7S1P对接心云话机“本负料-Rn'I1rSHtfiI芮息管理»p«a充(12聚资费列若*m系统售理用户曾理角色权限贵作E案蜉信息a!9M1.个卢立丸照企北H<11M00域U才创3用&&行侵M.2.wftttf1f1cRx*Hav<B3.日】6：30分友认正的，&日融06.色双线时间段.拘在次日&S.US日日.圄企业”证信电囱取开发It类*e公司公司名缘:公司地址：所属行业：文化1«在杵英盟：e-;他一科统一枚会阳代码：法库代事人：公司电法：公剂站：已通过3、申请内容模板£2玖云平台越英产a*决方富开发者中心Oj,*5tiSS5号通模板管闪信»语音通知Bt口业务358»®»)普惶云调启sTbS1P对接&云话机>订跟小号虚拟小号云呼小号AWifeafiiSfei孑机号号通.WfS4、实现业务逻辑具体操作细节请咨询客服。4接口4.1 投递该接口用于投递闪信信息，由玖云开放平台提供给第三方。4.1.1 接口地址softVersion）AccontsaccountSid）F1ashSmssend RESTAP1通过HTTPS方式请求PoST 请求方法：POST*UR1由平台方提供，实际对接时以平台方提供的地址为准；*包头和Ur1相关信息，请参照对应接文档：4.1.2请求参数请求参数说明参数参数类型必选说明app1dString是应用idbjString是接收对象temp1ateString是发送的模板类型编号需要提前申请ZjString是主叫（发送的热线号码）directionString否呼叫流程（默认是Mo）M0：主叫流程（去除国家码前缀后target必须和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:Nzk4Yj11YzBIYWE5NDE0Mjg1MjYwMmM0AAI1NzAxNDY6MjAxNjAzMjQxNTE3MDE=("req":"appid":"abcd1341adfd","bj":"138XXXXXXXX",',zj":"temp1ate'*:"123","direction":"MO"4.1.3响应参数 resp参数说明参数参数类型必选说明dataObject是数据正常返回的报文（正确请求发送有错误时没有）StatusCodeString是错误提示码，错误时有。正确时没有representString是提示信息,错误时有。正确时没有Data对应的数据如下: head参数说明参数参数类型必选说明request1dString是请求idcodeString是状态码（根据状态码判断是否成功）msgString是响应信息data参数说明参数参数类型必选说明taskidString是任务ID其它参数:参数参数类型必选说明successString是true或f1ase4.1.4 响应示例"resp":"data":("data":"taskid":"62841"1,head""code'"601,msg,7,temp1ateandhot1inenotmatch",requestId",ad7e86b1b757416d9a3ed18eb93a6008"1"success'fa1se)如果返回异常不通过则：(resp:statusCode:0900001M,represent:"主叫号码格式错误"4.1.5 注意事项 对同一个手机号码同一个模板投递两次之间的时间间隔有要求，默认30秒。 对同一个手机号码同一个模板一个自然日内投递上限次数有要求，默认5次； 对同一个手机号码一个自然日内投递上限次数有要求，默认10次。超过限制将无法向此号码投递。4.1.6响应结果码枚举值描述4闪信已提交网关(msgType=2或4有效)Thef1ashSMhasbeensubmittedtothegateway5闪信提交网关失败Thef1ashSMsubmittedtothegatewayfai1ed<msgType=2或4有效)6短信已提交TheSMhasbeensubmitted7短信提交失败TheSMsubmittedfai1ed10投递请求接收失败De1iveryrequestreceivefai1edCmsgType=I或3或5有效)11域选提交成功101错误的请求方法Inva1idrequestmethod102错误的请求参数(P1atfOrmid)Inva1idparameter-p1atformid103错误的请求参数(timestamp)Inva1idparameter-timestamp104错误的请求参数（V）Inva1idparameter-v105错误的请求参数(sign)Inva1idparameter-Sign107错误的请求参数(body)Inva1idparameter-body108错误的请求参数CcaIIEvent)Inva1idparameter-CaIIEvent109无效的来访UR1UnknownremoteURI112消息中无bodyNobodyinHTTPrequest113body中不是json格式Bodyisnotjsonformat114无法识别的投递号码Inva1idtargetnumber115投递号码在黑名单中targetinb1ack1ist116用户未申请异网服务NoserviceofSMSsupportp1atform117非法签名signaturei11ega1118非法源号码srci11ega1119无使用此类服务的权限Noserviceofmsgtype%d120投递号段受限targetsegmentisrestricted121超出流量限制Beyondf1uidcontro1122投递类型与模版不匹配De1iverytypenotmatchingtemp1ate125未授权使用此接入号srcnotauthorized126不能短时间内连续向同,个号码投递Targetde1iverytimeinterva11imit127一天内向同一个号码投递次数达到上限Targetde1iverydaysum1imit128非移动号码noncmccphone131投递对象与主叫号码不符Targetnotmatchsca11ing132投递对象与被叫号码不符Targetnotmatchca11ed201到达套餐上限停发Reachmaximumde1ivery1imit202含有敏感词I11ega1wordfound203查询接口失败checkappapifai1204资源不足APIresourceunavai1ab1e205获取应用ID或版本失败noappkeyornoversion206消息内容长度超过限制1engthofthemessagecontentexceeds1imit210UTF8转GBK失败utf8togbkerror213此目标号码状态不适合投递USSDThisstatusofnumberisnotsuitab1eforde1iveringUSSD（应用场景为指定投递方式为只投USSd方式，域查询结果为闪信，则返回此响应）300接入方状态不正常thirdpartystatusva1id500未知处理状态UnknownerrorSO1服务处理错误Serviceerror600目标内容状态不正确Targetde1iverycontentstatusisunab1e601模板和号码关系不匹配temp1ateandhot1inenotmatch602域选接口查询超时或失败domainSe1ectionQuerytimeoutorfai1ed603模板不在企业下temp1atesarenotundertheenterprise604运营商不支持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
