S-MAS短信云平台操作指南:短信接口
MAS移动移动代理服务器使用手册
MAS 移动代理服务器Mobile Agent Server(MAS)用户手册Version 1.1若雅软件系统有限公司目录目录....................................................................................................................... - 1 -1.概述......................................................................................................................... - 3 -2.MAS使用配置 ....................................................................................................... - 3 -3.MAS 功能简介 ...................................................................................................... - 3 -1)Web短信 ....................................................................................................................... - 3 -2)系统管理 ........................................................................................................................ - 3 -3)个人设置 ........................................................................................................................ - 3 -4)服务设置 ........................................................................................................................ - 3 -5)客户服务 ........................................................................................................................ - 4 -6)查询与统计 .................................................................................................................... - 4 -7)MAS管理 ...................................................................................................................... - 4 -4.手册使用说明 ........................................................................................................ - 4 -1)手册适用范围 ................................................................................................................ - 4 -2)手册导航 ........................................................................................................................ - 4 -3)名词说明 ........................................................................................................................ - 5 -5.MAS使用指南 ....................................................................................................... - 5 -1)用户登录 ........................................................................................................................ - 5 -2)Web短信 ....................................................................................................................... - 6 -短信群发.......................................................................................................................................... - 7 -批量发送........................................................................................................................................ - 13 -已发送短信.................................................................................................................................... - 13 -待发送短信.................................................................................................................................... - 15 -收件箱............................................................................................................................................ - 15 -草稿箱............................................................................................................................................ - 16 -短信稽核........................................................................................................................................ - 16 -3)系统管理 ...................................................................................................................... - 18 -敏感词管理.................................................................................................................................... - 18 -4)个人设置 ...................................................................................................................... - 19 -个人通讯录.................................................................................................................................... - 20 -用户信息........................................................................................................................................ - 21 -公司通讯录.................................................................................................................................... - 21 -8)服务设置 ...................................................................................................................... - 22 -广播设置........................................................................................................................................ - 22 -点播设置........................................................................................................................................ - 26 -查询设置........................................................................................................................................ - 31 -路由设置........................................................................................................................................ - 38 -资费规则........................................................................................................................................ - 39 -9)客户服务 ...................................................................................................................... - 40 -订阅代理........................................................................................................................................ - 40 -人工回复........................................................................................................................................ - 42 -回复查询........................................................................................................................................ - 43 -10)查询与统计.............................................................................................................. - 44 -短信查询与统计 ............................................................................................................................ - 44 -11)互动服务.................................................................................................................. - 44 -互动设置........................................................................................................................................ - 46 -互动回复........................................................................................................................................ - 48 -互动查询........................................................................................................................................ - 49 -互动统计........................................................................................................................................ - 50 -值班人员........................................................................................................................................ - 50 -申请互动........................................................................................................................................ - 51 -12)MAS管理................................................................................................................ - 52 -Mas业务配置 ................................................................................................................................ - 52 -Mas服务器信息配置 .................................................................................................................... - 53 -应用接入信息 ................................................................................................................................ - 53 -Mas服务器配置参数 .................................................................................................................... - 54 -Mas日志统计 ................................................................................................................................ - 54 -Mas升级通知 ................................................................................................................................ - 55 -Mas服务器认证鉴权 .................................................................................................................... - 55 -告警统计........................................................................................................................................ - 56 -6.附加说明............................................................................................................... - 56 -7.相关索引............................................................................................................... - 57 -1. 概述MAS(英文全称Mobile Agent Server)是一套基于移动短信的企业客户服务应用系统,MAS与传统客服显著不同在于以短信作为沟通企业与企业客户的信息载体,取代以往人工/ 自动语音、信函等传统客服手段,以高效、即时、准确、低廉及无所不在的移动短信作为联系企业与客户的服务纽带,支持企业发起(服务广播)、客户发起(服务点播、信息查询)及人工短信回复等多种服务方式,实现企业与客户间的服务互动,真正体现企业“以客户为中心”的经营理念,帮助企业通过人性化的客户服务稳固和拓展客户群体,真正实现“客服增值”目标。
移动代理服务器MAS短信API2.2开发手册(JAVA)
移动代理服务器MAS短信API2.2开发⼿册(JAVA)移动代理服务器MAS 短信API2.2开发⼿册(JAVA)V2.2深圳市嘉讯软件有限公司⼆○○七年⼗⼀⽉⽬录1 引⾔ (1)1.1 编写⽬的 (1)1.2 背景说明 (1)1.3 术语定义 (1)2 概述 (3)2.1 接⼝功能 (3)2.2 接⼝组成 (4)2.3 短信收发机制 (4)2.3.1 MT短信与其回执、回复的对应 (4)2.3.2 MO短信的分流 (5)3 接⼝介绍 (6)3.1 接⼝管理模块 (6)3.1.1 主页⾯ (6)3.1.2 新建页⾯ (7)3.1.3 编辑页⾯ (9)3.1.4 队列管理页⾯ (9)3.2 数据库DB接⼝ (10)3.2.1 发送队列表 (11)3.2.2 接收队列表 (13)3.2.3 回执队列表 (13)3.3 Java API (13)3.3.1 类APIClient (14)3.3.2 类MOItem (28)3.3.3 类RPTItem (29)4 使⽤指导 (29)4.1 开发步骤 (29)4.2 调试⽅法 (30)4.3 运⾏设置与监控 (31)5 附录 (32)5.1 附录⼀:API返回值列表 (32)5.2 附录⼆:回执编码列表 (33)1引⾔1.1 编写⽬的移动代理服务器MAS提供了强⼤的短信接⼊机制。
本⼿册⽤于指导客户利⽤移动代理服务器MAS提供的短信接⼝进⾏其他需要短信功能的新系统开发或原有系统的短信功能扩展。
本⼿册的阅读对象为需要采⽤移动代理服务器MAS的短信接⼝完成客户开发的设计⼈员与编码⼈员。
1.2 背景说明本⼿册适⽤于产品“移动代理服务器MAS” V1.1 + MAS1.1 P08D071121通⽤补丁。
1.3 术语定义移动代理服务器MAS:全称为“移动代理服务器MAS”,属深圳嘉讯软件公司开发的⼀套产品,本⼿册中有时也直接简称为“移动代理服务器”或“MAS”。
MT短信:通过短信接⼝发往⼿机终端的短信,也指从移动代理服务器的某⼀功能直接发往⼿机终端的短信。
中国移动通信有限公司政企客户分公司云MAS平台SDK接口1.0.1(HTTP版)
云MAS平台SDK1.0.1(HTTP版)用户手册作者:中国移动通信有限公司政企客户分公司完成日期:2015-12-7签收人:签收日期:修改情况记录:1云MAS平台HTTP开发说明1.1简介云MAS平台SDK HTTP版接口说明文档1.2背景系统名称:云MAS平台项目开发者:中国移动通信集团政企客户分公司1.3定义MT Message Terminal——下行短信,即向手机终端发送短信MO Message Original——上行短信,即手机用户向特服号码发送短信1.4环境服务器具有直连访问互联网的能力。
并且提供HTTP Server接收比较报告,状态报告,上行短信。
1.5云MAS平台与HTTP客户端数据交互流程HTTP客户端云MAS服务端云MAS消息队列云MAS审核服务云MAS发送服务行业网关1.HTTP客户端提交短信至云MAS2.服务端提交消息至消息队列2.服务端提交消息至审核服务3.审核不通过4.返回审核结果数据结构见2.13.审核通过,消息队列提交客户封包至发送服务4.提交短信至行业网关5.返回短信回复6.返回短信回复8.返回短信回执9.返回短信回执7.返回短信回复数据结构见2.210.返回短信回执数据结构见2.34.通知删除待发内容4.返回审核状态HTTP服务端2:返回状态码和后台生成的UUID,SDK收到的返回值说明:➢“1.返回提交状态”,说明云MAS是否收到HTTP提交的数据;数据还未提交行业网关;➢“4.返回审核结果”,说明云MAS已经对提交内容进行了审核;数据还未提交行业网关;➢“7.返回短信回复”,短信已经提交网关;➢“10.返回短信回执”,短信已被网关下发;*因平台有流控设置,需要进行多条短信连续提交时,为保证提交速度和效率,请按照“1.返回提交状态”返回值判断是否提交下一条;2数据结构说明2.1MT提交报告数据结构●类型(TYPE):JSON●用途用于内部,跟踪短信状态,不能用于判断短信是否正确送达,2.2MT状态报告数据结构●类型(TYPE):JSON●用途保存状态报告接口函数返回的短信内容,不能用于判断短信2.3MO数据结构●类型(Type):JSON3功能介绍及使用3.1身份验证●功能介绍企业必须通过身份验证才能进行短信发送,身份验证用户名、密码和集团客户名称完成。
中国移动通信有限公司政企客户分公司云MAS平台SDK接口1.0.1(HTTP版)
云MAS平台SDK1.0.1(HTTP版)用户手册作者:中国移动通信有限公司政企客户分公司完成日期:2015-12-7签收人:签收日期:修改情况记录:1云MAS平台HTTP开发说明1.1简介云MAS平台SDK HTTP版接口说明文档1.2背景系统名称:云MAS平台项目开发者:中国移动通信集团政企客户分公司1.3定义MT Message Terminal——下行短信,即向手机终端发送短信MO Message Original——上行短信,即手机用户向特服号码发送短信1.4环境服务器具有直连访问互联网的能力。
并且提供HTTP Server接收比较报告,状态报告,上行短信。
1.5云MAS平台与HTTP客户端数据交互流程SDK收到的返回值说明:➢“1.返回提交状态”,说明云MAS是否收到HTTP提交的数据;数据还未提交行业网关;➢“4.返回审核结果”,说明云MAS已经对提交内容进行了审核;数据还未提交行业网关;➢“7.返回短信回复”,短信已经提交网关;➢“10.返回短信回执”,短信已被网关下发;*因平台有流控设置,需要进行多条短信连续提交时,为保证提交速度和效率,请按照“1.返回提交状态”返回值判断是否提交下一条;2数据结构说明2.1MT提交报告数据结构●类型(TYPE):JSON●用途用于内部,跟踪短信状态,不能用于判断短信是否正确送达,2.2MT状态报告数据结构●类型(TYPE):JSON●用途保存状态报告接口函数返回的短信内容,不能用于判断短信2.3MO数据结构●类型(Type):JSON3功能介绍及使用3.1身份验证●功能介绍企业必须通过身份验证才能进行短信发送,身份验证用户名、密码和集团客户名称完成。
●请求申明测试环境:.13:80/app/http/authorize正式环境:.cn/app/http/authorize●●3.2发送普通短信HTTP客户端向云MAS平台发送请求,带上相应的请求参数,云MAS 平台接收请求,并进行验证,验证通过后进行短信发送。
云MAS平台HTTP2.1
云MAS平台HTTP2.1云MAS平台HTTP2.1(HTTP版)接⼝⽂档接⼝定义1.1发送普通短信1.1.1.1业务功能HTTP客户端向云MAS平台发送请求,带上相应的请求参数,云MAS平台接收请求,并进⾏验证,验证通过后进⾏短信发送。
1.1.1.1.1传输数据结构●正式环境地址:http://112.35.1.155:1992/sms/norsubmit●类型(TYPE):JSON●请求⽅式:post●传输数据加密⽅式:base64响应类型(TYPE):JSON数据案例组装数据{"addSerial":"111","apId":"301583","content":”你好","ecName":"集团客户”,"mac":"e8c5c17a57182ea3aa27833b9b1a001f","mobiles":"181********" ,"secretKey":"301583","sign":"lsign001"} Base64加密eyJhZGRTZXJpYWwiOiIxMTEiLCJhcElkIjoiMzAxNTgzIiwiY29udGVudCI6IuS9oOWl vSIsImVjTmFtZSI6IumbhuWbouWuouaItyIsIm1hYyI6IjVjYTY5ZTZmYTdkZWM5MGM1NmQwYWYwYWQ5NWQwMDE1IiwibW9iaWxlcyI6IjE4MTM3ODI4OTgzIiwic2VjcmV0S2V5 IjoiMzAxNTgzIiwic2lnbiI6ImxzaWduMDAxIn0=字符集是UTF-8Java代码案例响应失败例如:{ "msgGroup": "", "rspcod": "InvalidUsrOrPwd", "success": false}响应成功例如:{ "msgGroup": "0519022349001000500001","rspcod": "success", "success": true} Java代码案例1.2发送模板短信1.2.1.1业务功能模板短信发送,HTTP客户端向云MAS平台发送请求,根据指定模板ID,传⼊模板所需参数发送短信,云MAS平台接收请求,并进⾏验证,验证通过后进⾏短信发送。
MAS短信发送操作说明
发送短信
首先,选择短信中心〉〉普通发送,如图:
可手动输入要发送的手机号,然后回车,添加到收件人列表中:
也可导入号码文件,将号码列入收件人列表。
点击号码文件按钮,
然后弹出一个窗口,浏览号码文件,然后点击“确定”,号码文件的号码就被读取到收件人列表中,号码文件可为文本文件或者excel表格。
然后点击发送即可将短信发出。
查看短信状态
选择短信中心〉〉已发箱,点击每批短信的下发详情的查看按钮,即可查看发送状态,可知短信是否发送成功。
记录移动云MAS短信平台发送模板短信+获取回执状态
记录移动云MAS短信平台发送模板短信+获取回执状态直接上代码,清晰明了(所有发送短信代码是写在⼀个⼯具类),也参考了⽹上⼀些博主的⽂章,⾮常感谢,以下内容只是记录平时做东西的内容,如有不正确的地⽅,欢迎指正。
PS:(写在前⾯)需要注意的⼏个点:(1)需要先在mas平台上配置相关信息和接⼝(主页-管理-接⼝管理),https请求需要将短信平台上的短信接⼝创建为http协议模式,否则请求失败;http请求同理,只要短信接⼝的⽤户名、密码和协议对应正确,⼀般没有太⼤问题;(2)如果是发送模板短信需要先申请短信模板,且传⼊参数必须和模板中变量所包含的类型⼀致,否则mas平台上数据校验⽆法通过(有条件还是获取⼀下回执报告,因为有时候即使响应状态返回success,最后没有收到短信,进⼊平台查看可以看到其实回执状态报错,并没有发送成功);(3)如果短信模板中的变量长度不能满⾜需要,可以联系客户经理申请特殊变量,特殊变量⼀个模板中可以使⽤两次;(4)https短信接⼝⽂档中写得很清楚:【请客户侧忽略证书校验,移动侧不提供证书秘钥】,所以在做post请求的时候⼀定要记得【忽略证书校验】,否则请求失败,返回值为空;http请求不⽤管。
(5)短信响应状态成功返回的是:{"msgGroup":"0906163415000000332084","rspcod":"success","success":true},有错误的时候是:{ "msgGroup": "", "rspcod": "InvalidUsrOrPwd","success": false}(6)短信发送成功回执状态返回的是“[]”,有错误的时候是:[{"errorCode":"CM:2007","mobile":"138********","msgGroup":"0906144506000001364223","receiveDate":"20210906244506","reportStatus":"CM:2007","submitDate":"20210906144506"}](7)上⾯说的其实平台上和提供的⽂档中基本都有说明,多看提供的接⼝⽂档,对实现⾃⼰想要的功能有帮助1.SMSUtil.javaa.通过https请求发送模板短信(⽹上很多的都是⽤http⽅式请求,只不过获取回执状态需要⾃⼰搭建http服务,太菜了感觉⽐较⿇烦就采⽤了https 请求,可以⾃⼰主动获取回执报告,这个因⼈⽽异)1/**2 * 云MAS-发送模板短信(https)3 *4 * @param mobiles ⼿机号5 * @param templateId 模板id6 * @param param 参数列表7 * @return8 * @throws UnsupportedEncodingException9*/10public static AjaxResult sendTemplateSms(String mobiles, String templateId, List<String> param) throws UnsupportedEncodingException {11 apId="xxx";//⽤户名12 secretKey="xxx";//密码13 ecName = "xxx"; //集团名称14 sign = "xxx"; //⽹关签名编码15 addSerial = ""; //拓展码填空16 templateurl = "https://112.35.10.201:28888/sms/tmpsubmit";//和http请求地址不⼀样 http://112.35.1.155:1992/sms/tmpsubmit1718//发送短信--start--19 String params = null;20if(param != null){21 params = JSON.toJSONString(param.toArray());22 }else{23 params = "[]";24 }25 SendRequest submitReq = new SendRequest();26 submitReq.setApId(apId);27 submitReq.setEcName(ecName);28 submitReq.setSecretKey(secretKey);29 submitReq.setParams(params);30 submitReq.setMobiles(mobiles);31 submitReq.setSign(sign);32 submitReq.setAddSerial(addSerial);33 submitReq.setTemplateId(templateId);3435 StringBuffer stringBuffer = new StringBuffer();36 stringBuffer.append(submitReq.getEcName());37 stringBuffer.append(submitReq.getApId());38 stringBuffer.append(submitReq.getSecretKey());39 stringBuffer.append(submitReq.getTemplateId());40 stringBuffer.append(submitReq.getMobiles());41 stringBuffer.append(submitReq.getParams());42 stringBuffer.append(submitReq.getSign());43 stringBuffer.append(submitReq.getAddSerial());44 String encode = "";45try {46//接⼝要求参数为MD5加密后的值47 submitReq.setMac(Md5Utils.hash(stringBuffer.toString()));48 String reqText = JSON.toJSONString(submitReq);49//base64编码50 encode =new String(Base64.encodeBase64Chunked(reqText.getBytes("UTF-8"))); //有中⽂时使⽤UTF-851 } catch (UnsupportedEncodingException e1) {52 e1.printStackTrace();53 }54 String resStr = "";55try {56 resStr = new String(HttpUtils.sendPostTrust(templateurl,encode,"utf-8","POST"));//https链接57 } catch (Exception e) {58 e.printStackTrace();59 }60//发送短信--end--6162//响应状态、回执状态处理--start--63 SendResponse sendRes = JSON.parseObject(resStr,SendResponse.class);//响应状态64 String receiptReport=getReport(apId,secretKey,ecName);//回执状态66 String errorCode="";67if(receiptReport!="[]"){68 JSONArray jsonArray= JSONArray.parseArray(receiptReport);69if(receiptReport.contains("errorCode")){70for(int index=0;index<jsonArray.size();index++){71 JSONObject jsonObject = jsonArray.getJSONObject(index);72if(jsonObject.getString("mobile").equals(mobiles)) {73 errorCode=jsonObject.get("errorCode").toString();74 }75 }76 }77 }78else{79 errorCode="";80 }81if(sendRes.getSuccess() && !"".equals(sendRes.getMsgGroup()) && "success".equals(sendRes.getRspcod())){ 82switch (sendRes.getRspcod()) {83case "success":84if (errorCode != null && errorCode != "") {85return AjaxResult.error(11, "其他错误:" + errorCode+",请联系管理员!");86 } else {87return AjaxResult.error(0, "发送成功");88 }89case "IllegalMac ":90return AjaxResult.error(1, "mac校验不通过");91case "IllegalSignId ":92return AjaxResult.error(2, "⽆效的签名编码");93case "InvalidMessage ":94return AjaxResult.error(3, "⾮法消息,请求数据解析失败");95case "InvalidUsrOrPwd ":96return AjaxResult.error(4, "⾮法⽤户名/密码");97case "NoSignId ":98return AjaxResult.error(5, "未匹配到对应的签名信息");99case "TooManyMobiles ":100return AjaxResult.error(6, "⼿机号数量超限,应≤5000");101default:102return AjaxResult.error(-1, "系统异常");103 }104 }105else{106return AjaxResult.error(-2,"请求异常");107 }108//响应状态、回执状态处理--end--109 }110111//获取状态报告112public static String getReport(String apId,String secretKey,String ecName){113 String reporturl = "https://112.35.10.201:28888/sms/report";114115 SendRequest submitReq = new SendRequest();116 submitReq.setApId(apId);117 submitReq.setEcName(ecName);118 submitReq.setSecretKey(secretKey);119120 StringBuffer stringBuffer = new StringBuffer();121 stringBuffer.append(submitReq.getEcName());122 stringBuffer.append(submitReq.getApId());123 stringBuffer.append(submitReq.getSecretKey());124 stringBuffer.append(submitReq.getTemplateId());125 String encode = "";126try {127//接⼝要求参数为MD5加密后的值128 submitReq.setMac(Md5Utils.hash(stringBuffer.toString()));129 String reqText = JSON.toJSONString(submitReq);130//base64编码131 encode =new String(Base64.encodeBase64Chunked(reqText.getBytes("UTF-8"))); //有中⽂时使⽤UTF-8 132 } catch (UnsupportedEncodingException e1) {133 e1.printStackTrace();134 }135 String receiptReport = "";136try {137 receiptReport = new String(HttpUtils.sendPostTrust(reporturl,encode,"utf-8","POST"));//https链接138139 } catch (Exception e) {140 e.printStackTrace();141 }142return receiptReport;143 }2.HttpUtils.java---->sendPostTrust1//添加信任主机2private static void trustAllHosts() {3// 创建不验证证书链的信任管理器这⾥使⽤的是x509证书4 TrustManager[] trustAllCerts = new TrustManager[]{new TrustAnyTrustManager() {5public java.security.cert.X509Certificate[] getAcceptedIssuers() {6return new java.security.cert.X509Certificate[]{};7 }89public void checkClientTrusted(X509Certificate[] chain, String authType) {10 }1112public void checkServerTrusted(X509Certificate[] chain, String authType) {13 }14 }};15// 安装所有信任的信任管理器16try {17 SSLContext sc = SSLContext.getInstance("TLS");18 sc.init(null, trustAllCerts, new java.security.SecureRandom());19//HttpsURLConnection通过SSLSocket来建⽴与HTTPS的安全连接,SSLSocket对象是由SSLSocketFactory⽣成的。
移动嘉讯短信MAS服务程序配置说明
移动嘉讯短信MAS配置使用说明安装步骤与说明1、嘉讯MAS系统配置1)新建接口,登录到移动代理MAS服务器(MAS服务器的地址),输入MAS厂商提供的系统管理员用户名和密码登录系统进行配置,进入到系统管理----接口管理模块,新增一个短信接口,录入相应接口信息,其中:接口编码:接口的编码标识符,如:oamas,在后面配置服务程序中的XML文件时使用到。
接口名称:接口的描述,如:oamas接口类型:选择API类型业务类型:选择“行业应用”业务代码:默认选择移动已经配置好的业务代码登录用户:对应接口的loginName参数,如:oamas,后面XML文件的配置中也用到。
登录密码:对应接口的密码参数,后面XML文件的配置中也用到。
配置好保存即可,若我们还处理调试状态,可把接口状态设置为“调试状态”方便测试。
2、配置后台服务程序.1)使用最新的短信服务程序,特别注意FlowGate.jar包中是否已包含嘉讯的相关类文件,同时把嘉讯厂商提供的ImApi.jar(询问移动或嘉讯厂商要相关接口文件)接口文件放到短信服务程序中,同时把该包加入在run.bat的脚本中,注意run.bat中JDK程序的地址更改。
2)配置ServiceConfig.xml,把下面的脚本拷贝到ServiceConfig.xml文件中,增加一个新的服务菜单。
<smsservice.SMSService desc="移动短信服务" enable="true" multithread="false"><RetryTimes>40</RetryTimes><Debug_Mode>true</Debug_Mode><Interval>20</Interval></smsservice.SMSService>3)配置app_sms_config.xml文件,在脚本中添加以下脚本代码。
嘉讯 移动代理服务器 MAS 短信 API2.2 常见问题手册
移动代理服务器MAS 短信API2.2常见问题手册V2.2深圳市嘉讯软件有限公司二○○七年十一月目录1 API常见问题 (1)1.1 API所支持的版本? (1)1.2 API以前的版本能否升级到V2.2版本? (1)1.3 目前API支持哪些开发语言? (1)1.4 API V2.2支持哪些接口类型? (1)1.5 MAS提供哪些API的开发资料? (2)1.6 如何对API接口进行开发? (2)1.7 如何新增一个API接口? (2)1.8 新增接口失败是哪些原因造成? (2)1.9 各语言DEMO运行所需的环境? (3)1.10 DEMO程序中的参数需要怎么填写? (3)1.11 API接口初始化失败有哪些原因? (3)1.12 DEMO发送短信时出现-3错误? (3)1.13 调用API发送短信时会经常出现-1与-11的错误? (3)1.14 DEMO初始化常见错误? (3)1.15 通过API接口发送短信的错误回执代码与通过MAS页面发送的错误回执代码是否一样? 41.16 通过API接口发送的短信在MAS的数据库中是否有发送记录? (4)1.17 提示发送成功,但是手机收不到? (4)1.18 API定时发送时间不一致问题? (4)1.19 API 是否支持多线程? (5)1.20 API 是否支持批量发送? (5)1.21 API一次发送手机号码数量说明? (5)1.22 API如何收发PDU短信? (5)1API常见问题1.1 API所支持的版本?l API2.0支持版本:IM V4.0、IM V4.1、MAS V1.0、MAS V1.0.2、MAS V1.1。
l API2.1支持版本:IM V4.0(须升级到IM4Patch200706041800)、IM V4.1、MAS V1.0.2、MAS V1.1。
l API2.2支持版本:MAS V1.1版本 + MAS1.1 P08D071121通用补丁。
S MAS短信云平台
适用范围
应用范围
适用客户群
95/96/1010/1069短号接入平台; 多台移动、电信、联通信息机统一对接; 政府、事业单位、集团企业统一短信无限扩展服务; 现有系统平台(OA/ERP/CRM等)短彩信对接;
大中型企业、事业单位、集团客户。
功能介绍
01
短信发送
02
通讯录管理
03
短信接口
04
报表统计
06
个性设置
05
用户权限
平台具备移动、电信以及联通三短信互发功能,有立即发送、批量群发、定时发送等多种发送方式。查询便 捷,已发、待发一目了然。
具有强大的通讯录管理功能,可对内部人员及客户通讯录进行有效的管理。;自由分配用户的短信额度,对用户及关 进行计费。
对系统内置及外部应用进行统一管理,并配置短信及收发权限。
对平台流量、接口流量、运营商流量、关流量以及平台短信计费等进行统计,自由选择统计时间,以折线图 显示报表统计结果,支持导出Excel报表。企业关
直连三大运营商标准协议关及信息机通道,对企业关、短信过滤关键字、白名单、黑名单进行设置管理。
可添加多个用户并对用户进行统一的维护管理,包括用户的归属角色、基本信息以及相应角色的权限分配等 信息。
S MAS短信云平台
由尚科自主研发的三合一的短彩信发送平台
01 平台优势
03 功能介绍
目录
02 适用范围
S-MAS短信云平台是由尚科自主研发的三合一的短彩信发送平台,采用了业界领先的技术,基于移动、电信、 联通三大运营商短彩信标准通信协议开发,尚科S-MAS短信云平台是一个既具有开放API接口又具备通道监控管理 的政企短信中间件平台,可支持多个短消息类服务号接入,完全集成了政企用户所特有的短信应用功能,可与政 企现有的站、政务办公、CRM、OA、ERP等系统进行无缝对接,支持Oracle、Mysql、Mssql等主流数据库,并且 可以监控通道和用户的发送状态。尚科S-MAS短信云平台区别于传统的短信平台在于有效遏制了垃圾短信的产生, 短信接收都是在用户许可下接受信息的。可广泛嵌入于国家机关办公及行政管理系统、电子商务站、银行/证券业 系统软件、企业税务系统行业软件、汽车行业软件、餐饮行业软件、酒店预订行业软件、物流行业管理软件、 “家校通”校园管理软件、保险行业管理软件。
短信平台接入网关说明书及常见问题解答
短信平台接入网关说明书及常见问题解答一、网关介入说明1 网关接入运营商网关接入有2种方式,推荐专线接入安全可靠不易丢包。
如果是互联网推荐使用防火墙隔离出互联网DMZ区,保证安全。
1.1 专线接入专线接入:下图只做参考,各省可根据实际情况在保证网络安全前提下进行划分网络。
移动运营商如果提供MAS机可以和短信平台部署一个网段,MAS机可认为移动的前端网关服务器,它是为了方便移动管理和维护以及安全考虑提供一台MAS机。
注意:Mas机是部署在和短信平台同一个局域网内。
如果接入Mas机,由于全国MAS厂商很多,所以要主要短信平台和MAS机的连接方式,目前支持的方式:直接提供MAS机的ip,端口配置在短信平台的网关参数配置中。
如果是提供相关的api、接口或者数据库连接方式,目前不支持这几种方式,这几个方式出问题了不是很好管理,出现问题不好解决。
如果Mas是这样连接的话,请直接采用网关直连的方式。
如果是只提供ip和端口就可以了,就相当于mas机就是移动的短信业务平台,就很好管理了,就算有问题也只有网络方面的1.2 互联网接入互联网接入:下图只做参考,各省可根据实际情况在保证网络安全前提下进行划分网络。
移动运营商如果提供MAS机可以和短信平台部署一个网段,MAS机可认为移动的前端网关服务器,它是为了方便移动管理和维护以及安全考虑提供一台MAS机。
2 网关参数2.1 移动参数短信平台支持移动CMPP2、CMPP3.0协议,需要运营商提供参数如下:特服号码:12379,短信平台必填项企业代码:移动运营商提供企业id,短信平台必填项网关地址:移动运营商提供网关服务器ip地址,短信平台必填项网关端口:移动运营商提供网关服务器端口号,短信平台必填项登录名称:移动运营商提供登录网关用户名,短信平台必填项登录密码:移动运营商提供登录网关密码,短信平台必填项业务代码:移动运营商提供业务类型,没有提供则为空2.2 电信参数短信平台支持电信SMGP3.0和ISAG协议,SMGP协议需要运营商提供参数如下:特服号码:12379,短信平台必填项企业代码:电信运营商提供企业id,短信平台必填项网关地址:电信运营商提供网关服务器ip地址,短信平台必填项网关端口:电信运营商提供网关服务器端口号,短信平台必填项登录名称:电信运营商提供登录网关用户名,短信平台必填项登录密码:电信运营商提供登录网关密码,短信平台必填项业务代码:电信运营商提供业务代码,没有提供则为空ISAG协议需要运营商提供参数如下:特服号码:12379,短信平台必填项企业代码:电信运营商提供企业id,短信平台必填项网关地址:电信运营商提供网关服务器访问地址“http://网关IP:网关端口”,短信平台必填项登录名称:电信运营商提供登录网关用户名,短信平台必填项登录密码:电信运营商提供登录网关密码,短信平台必填项服务代码:电信运营商提供服务代码,没有提供则为空产品代码:电信运营商提供产品代码,没有提供则为空回调地址:默认填写http://短信平台IP:8080/asp/sms/SmsWebService,短信平台必填项2.3 联通参数短信平台支持联通SGIP1.2协议,需要运营商提供参数如下:特服号码:12379,短信平台必填项企业代码:联通运营商提供企业id,短信平台必填项网关地址:联通运营商提供网关服务器ip地址,短信平台必填项网关端口:联通运营商提供网关服务器端口号,短信平台必填项登录名称:联通运营商提供登录网关用户名,短信平台必填项登录密码:联通运营商提供登录网关密码,短信平台必填项本地端口:短信平台自身提供,默认8801,短信平台必填项业务代码:联通电信运营商提供业务代码,没有提供则为空源节点ID:联通电信运营商提供源节点ID,没有默认填写02.4 配置参数短信平台支持5种协议,根据运营商提供的协议短信平台选择对应的协议,然后再进行每个协议的详细参数配置,参数配置完成点击“保存”按钮,在点击“停止”按钮,最后点击“启动”按钮,刷新当前页面查看状态指示灯是否为绿色,绿色代表短信平台与网关服务器联通。
移动云Mas发送普通短信和模板短信
移动云Mas发送普通短信和模板短信//实体类public class SubmitReq {private String ecName;//客户名称private String apId;//⽤户名private String secretKey;//密码private String mobiles;//⼿机号码逗号分隔。
(如“1813728****,1813727****,1813726****”)private String content;//发送短信内容private String sign;//⽹关签名编码,必填,签名编码在中国移动集团开通帐号后分配,可以在云MAS⽹页端管理⼦系统-SMS接⼝管理功能中下载。
private String addSerial;//扩展码,根据向移动公司申请的通道填写,如果申请的精确匹配通道,则填写空字符串(""),否则添加移动公司允许的扩展码。
private String templateId;//模板IDprivate String mac;//API输⼊参数签名结果,签名算法:将ecName,apId,secretKey,mobiles,content ,sign,addSerial按照顺序拼接,然后通过md5(32位⼩写)计算后得出的值。
private String params;public String getParams() {return params;}public void setParams(String params) {this.params = params;}public String getTemplateId() {return templateId;}public void setTemplateId(String templateId) {this.templateId = templateId;}public String getEcName() {return ecName;}public void setEcName(String ecName) {this.ecName = ecName;}public String getApId() {return apId;}public void setApId(String apId) {this.apId = apId;}public String getSecretKey() {return secretKey;}public void setSecretKey(String secretKey) {this.secretKey = secretKey;}public String getMobiles() {return mobiles;}public void setMobiles(String mobiles) {this.mobiles = mobiles;}public String getContent() {return content;}public void setContent(String content) {this.content = content;}public String getSign() {return sign;}public void setSign(String sign) {this.sign = sign;}public String getAddSerial() {return addSerial;}public void setAddSerial(String addSerial) {this.addSerial = addSerial;}public String getMac() {return mac;}public void setMac(String mac) {this.mac = mac;}}//短信发送测试//短信发送测试import java.io.UnsupportedEncodingException;import mons.codec.binary.Base64;import com.huazi.projects.entity.SubmitReq;public class SmsSend {private static String apId="*****";//⽤户名private static String secretKey="*****";//⽤户密码private static String ecName = "*****";//集团名称(分组)private static String sign = "*****";//签名编码private static String addSerial = "";//拓展码public static String url = "http://112.35.1.155:1992/sms/tmpsubmit";//请求url 该接⼝为模板短信 //http://112.35.1.155:1992/sms/norsubmit //普通短信接⼝public static void main(String[] args) {//String[] param = {"*****","****"};//模板相关的变量参数String mobiles = "*******";//⼿机号,多个⼿机号⽤英⽂的 , 隔开String templateId = "*****"," ; //模板IDSmsSend.smsSend(templateId , param, mobiles);}//模板信息public static String smsSend(String templateId, String[] param,String mobiles) {String params = null;if(param != null){params = JsonUtil.object2json(param);}else{params = "[]";}SubmitReq submitReq = new SubmitReq();submitReq.setApId(apId);submitReq.setEcName(ecName);submitReq.setSecretKey(secretKey);submitReq.setParams(params);submitReq.setMobiles(mobiles);submitReq.setSign(sign);submitReq.setAddSerial(addSerial);submitReq.setTemplateId(templateId);StringBuffer stringBuffer = new StringBuffer();stringBuffer.append(submitReq.getEcName());stringBuffer.append(submitReq.getApId());stringBuffer.append(submitReq.getSecretKey());stringBuffer.append(submitReq.getTemplateId());stringBuffer.append(submitReq.getMobiles());stringBuffer.append(submitReq.getParams());stringBuffer.append(submitReq.getSign());stringBuffer.append(submitReq.getAddSerial());String encode = "";try {//接⼝要求参数为MD5加密后的值submitReq.setMac(Md5Util.MD5(stringBuffer.toString()));String reqText = JsonUtil.object2json(submitReq);//encode =new String(Base64.encodeBase64Chunked(reqText.getBytes("UTF-8"))); //有中⽂时使⽤UTF-8} catch (UnsupportedEncodingException e1) {e1.printStackTrace();}String resStr = "";try {resStr = new String(HttpUtil.post(HttpUtil.ContentType_JSON_UTF8,url,encode.getBytes()));//http链接} catch (Exception e) {e.printStackTrace();}return resStr;}//普通信息public static String norsubmit(String url ,String content ,String mobiles){SubmitReq submitReq = new SubmitReq();submitReq.setApId(apId);submitReq.setEcName(ecName);submitReq.setSecretKey(secretKey);submitReq.setContent(content);//短信内容submitReq.setMobiles(mobiles);submitReq.setSign(sign);submitReq.setAddSerial(addSerial);StringBuffer stringBuffer = new StringBuffer();stringBuffer.append(submitReq.getEcName());stringBuffer.append(submitReq.getApId());stringBuffer.append(submitReq.getSecretKey());stringBuffer.append(submitReq.getMobiles());stringBuffer.append(submitReq.getContent());stringBuffer.append(submitReq.getSign());stringBuffer.append(submitReq.getAddSerial());String encode = "";String resStr = "";try {submitReq.setMac(Md5Util.MD5(stringBuffer.toString()));String reqText = JsonUtil.object2json(submitReq);encode =new String(Base64.encodeBase64Chunked(reqText.getBytes("UTF-8")));resStr = new String(HttpUtil.post(HttpUtil.ContentType_JSON_UTF8,url,encode.getBytes()));} catch (Exception e) {e.printStackTrace();}return resStr;}}//httpUtil⼯具类import java.io.ByteArrayOutputStream;import java.io.IOException;import java.io.InputStream;import .Authenticator;import .CookieHandler;import .CookieManager;import .CookiePolicy;import .HttpURLConnection;import .PasswordAuthentication;import .URL;import java.util.Map;import java.util.Map.Entry;public class HttpUtil {public static final String ContentType_BIN = "application/octet-stream";public static final String ContentType_FORM = "application/x-www-form-urlencoded";public static final String ContentType_XML_UTF8 = "text/plaint; charset=utf-8";public static final String ContentType_JSON_UTF8 = "application/json; charset=utf-8";public static final String ContentType_HTML = "text/html";public static final String ContentType_TXT = "text/plain";public static byte[] post(String contentType, String url, byte[] content) throws IOException {return doRequest(contentType, "POST", url, content, null);}public static byte[] get(String contentType, String url) throws IOException {return doRequest(contentType, "GET", url, null, null);}public static byte[] doRequest(String contentType, String method, String url, byte[] content, Map<String, String> headers) throws IOException { URL u = null;HttpURLConnection conn = null;//尝试发送请求try {u = new URL(url);conn = (HttpURLConnection) u.openConnection();conn.setRequestMethod(method);conn.setRequestProperty("Content-Type", contentType);if (headers != null && ! headers.isEmpty()) {for(Entry<String, String> item: headers.entrySet()){conn.setRequestProperty(item.getKey(), item.getValue());}}conn.setConnectTimeout(60000); //1 minconn.setReadTimeout(600000); //10 minconn.setUseCaches(false);if (content != null && content.length >0) {conn.setDoOutput(true);java.io.OutputStream paramOut = conn.getOutputStream();paramOut.write(content);paramOut.flush();paramOut.close();}ByteArrayOutputStream out = new ByteArrayOutputStream(102400);InputStream buffIn = new java.io.BufferedInputStream(conn.getInputStream());int buffsize = 8192;int bytesRead = 0;byte[] buffer = new byte[buffsize];while ((bytesRead = buffIn.read(buffer, 0, buffsize)) != -1)out.write(buffer, 0, bytesRead);out.flush();buffer = null;return out.toByteArray();} finally {if (conn != null) {conn.disconnect();}}}static {CookieHandler.setDefault(new CookieManager(null, CookiePolicy.ACCEPT_ALL)); }public static void setBasicAuth(String username, String passwd){Authenticator.setDefault(new BasicAuthenticator(username, passwd));}private static class BasicAuthenticator extends Authenticator {String userName;String password;public BasicAuthenticator(String userName, String password) {erName = userName;this.password = password;}protected PasswordAuthentication getPasswordAuthentication() {return new PasswordAuthentication(userName, password.toCharArray());}}}//MD5Util⼯具类package com.huazi.projects.util;import java.security.MessageDigest;import javax.crypto.Mac;import javax.crypto.spec.SecretKeySpec;import mons.codec.binary.Base64;/*** MD5加密/验证⼯具类** @author bluesky**/public class Md5Util {static final char hexDigits[] = { '0', '1', '2', '3', '4', '5', '6', '7','8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };/*** ⽣成MD5码** @param plainText* 要加密的字符串* @return md5值*/public final static String MD5(String plainText) {try {byte[] strTemp = plainText.getBytes("UTF-8");MessageDigest mdTemp = MessageDigest.getInstance("MD5");mdTemp.update(strTemp);byte[] md = mdTemp.digest();int j = md.length;char str[] = new char[j * 2];int k = 0;for (int i = 0; i < j; i++) {byte byte0 = md[i];str[k++] = hexDigits[byte0 >>> 4 & 0xf];str[k++] = hexDigits[byte0 & 0xf];}return new String(str);} catch (Exception e) {return null;}}/*** ⽣成MD5码** @param plainText* 要加密的字符串* @return md5值*/public final static String MD5(byte[] plainText) {try {byte[] strTemp = plainText;MessageDigest mdTemp = MessageDigest.getInstance("MD5");mdTemp.update(strTemp);byte[] md = mdTemp.digest();int j = md.length;char str[] = new char[j * 2];int k = 0;for (int i = 0; i < j; i++) {byte byte0 = md[i];str[k++] = hexDigits[byte0 >>> 4 & 0xf];str[k++] = hexDigits[byte0 & 0xf];}return new String(str);} catch (Exception e) {return null;}}/*** 先进⾏HmacSHA1转码再进⾏Base64编码* @param data 要SHA1的串* @param key 秘钥* @return* @throws Exception*/public static String HmacSHA1ToBase64(String data, String key) throws Exception { SecretKeySpec signingKey = new SecretKeySpec(key.getBytes(), "HmacSHA1"); Mac mac = Mac.getInstance("HmacSHA1");mac.init(signingKey);byte[] rawHmac = mac.doFinal(data.getBytes());return Base64.encodeBase64(rawHmac).toString();}/*** 校验MD5码** @param text* 要校验的字符串* @param md5* md5值* @return校验结果*/public static boolean valid(String text, String md5) {return md5.equals(MD5(text)) || md5.equals(MD5(text).toUpperCase());}/**** @param params* @return*/public static String MD5(String... params) {StringBuilder sb = new StringBuilder();for (String param : params) {sb.append(param);}return MD5(sb.toString());}}。
短信平台API接口使用手册
成功,返回结果 <ReceiveMessage> <Result total="2" mess="" /> <Message> <SendNum>1385196xxxx</SendNum> <SendTime>2009-01-08 11:10:20.0</SendTime> <MemberName>xxxx</MemberName> <MemberCompany>国研科技</MemberCompany> <Content>浏试接收服务</Content> </Message> <Message> <SendNum>138519xxxxx</SendNum> <SendTime>2009-01-08 11:41:38.0</SendTime> <MemberName>xxxx</MemberName> <MemberCompany>国研科技</MemberCompany>
1.2 企业接口调用方式
企业接口函数的调用方式, 此处列出各种语言及开发环境调用的示例,具体环境还 需要作实际的修改。
1.2.1 C#中的调用
在 C#中调用 WebService 很简单, 在项目中添加一个 WEB 引用, 打入服务器的地 址:http:// 10.0.0.14:1080/Webservice/SendShortMessage.asmx 会列出此服务下面的 所有方法,点击添加引用即可,在代码里面可以像本地类一样的使用 WebService 的服 务,例如,你建立的 WebService 的引用为 testSvc,那么调用的方式为: testSvc. SendShortMessage obj = new testSvc. SendShortMessage(); xml = obj. ExecSendBatchMessage (“messageContent”, “sender”, “receivers” ,
smscenter(短信平台)接口说明
Smscenter(短信平台)接口说明接口名称:Operate_SystemUser接口方法:/*** deleteSystemUser:删除* @author guobing* @param loginnane 用户登录名称* @return:返回有:"删除成功"、"删除失败"、"删除的用户不存在"*/public String deleteSystemUser(String loginnane);/*** insertSystemUser:新增* @author guobing* @param loginname:登录名、loginpwd:登录密码、realname:真实姓名、mobile:电话号码、sex:性别(男,女)、* roleid:角色id、status:状态是否可用(非0表示可以用,0表示不可以用)、company:所在公司、* department:所在部门、job:所干工作* @return :返回有:"新增成功"、"新增失败"*/public String insertSystemUser(String loginname,Stringloginpwd,String realname,String mobile,String sex,String roleid,String status,String company,String department,String job);/*** querySystemUser:查询* @author guobing* @param loginname:登录名* @return:返回:SystemUser(系统用户对象)*/public SystemUser querySystemUser(String loginname);/*** updateSystemUser:修改用户* @author guobing* @param loginname:登录名、loginpwd:登录密码、realname:真实姓名、mobile:电话号码、sex:性别(男,女)、* roleid:角色id、status:状态是否可用(非0表示可以用,0表示不可以用)、company:所在公司、* department:所在部门、job:所干工作* @return :返回有:"修改成功"、"修改失败"、"用户不存在"*/public String updateSystemUser(String loginname,Stringloginpwd,String realname,String mobile,String sex,String roleid,String status,String company,String department,String job);/*** editPassword:修改密码* @author guobing* @param:loginname:登录名称、loginpwd:登录密码* @return:"修改成功"、"修改失败"、"用户不存在"*/public String editPassword(String loginname,String loginpwd);。
短信平台接口说明
短信平台接口说明第1章 基本约定第1节基本术语:前台流水号:前台流水号就是发送短信上送的批次号,一般在私有字段里面。
后台流水号:后台流水号是当提交成功之后短信平台返回给前端的流水号,此流水号在短信的所有业务中都是唯一的。
(1)上送文件格式以一行为一条短信数据. (2)提交成功之后,返回报文的分隔符为”:”. (3)群发短信手机号码之间采用的分隔符为”,”. (4)私有字段的分隔符采用”$” (5)非明确说明的,分隔符都采用”|”.第2节基本原理及提交成功返回短信平台基本原理如下所示:提交成功有文件类和单条短信返回: (1) 单条短信单条短信返回的格式为:|respcode @@@0000| respmsg@@@发送成功| frountID@@@前台流水号| backofficeID@@@后台流水号|^其中前台流水号为发送时前台请求时上送的批次号,后台流水为短信平台后台的流水号.(2)文件请求文件格式的报文返回为:|respcode@@@0000|respmsg@@@发送成功|frountID@@@前台文件批次号| frontfilename@@@前台文件名| backofficeID@@@后台文件批次号|^其中后台文件序列号由短信平台生成.第3节TCP接口必须要传送报文头第一个为报文域长度,其中包含整个报文头的12字节。
第二个为流水号,可以传定值1第三个是路由号,传8十六进制例子表示如下:33 00 00 00 01 00 00 00 08 00 00 00 7c 39 39 3939 7c 7c 31 33 33 32 33 35 39 31 36 33 38 7c b6cc cf fb cf a2 b2 e2 ca d4 b7 a2 cb cd d0 c5 cfa2 7c 5e定义的结构体typedef struct{unsigned int uiPacketLength; //包长,包含包头长度的总长度unsigned int uiSequenceID; //标识包的唯一ID,由客户端填写unsigned int CommandID; //路由号,一般固定为8或与短信平台协商}MSG_HEADER_T;第2章WebService接口说明提供两个类型的方法给调用即:单条发送方法,群发SERVICEURL:http://指定IP地址:端口 / SMSWebService.asmxSERVICENAME: SMSWebService第1节单条发送方法短信串的具体内容如下:|短信发送交易码|私有字段|手机号码|发送信息|^其中短信交易码为9999.私有字段定义:短信类型$发送人(部门)$提交人$业务类型$提交时间$开始日期$开始时间$结束日期$结束时间$批次号$是否需要回执$其中,开始日期、开始时间、结束日期、结束时间不定义(置空)则立即发送例如:6$XD$3$20090907102700$20090907$102700$20090907$205959$0907123456$ 短信类型为6,7,其中6为信贷系统日间短信,7为信贷系统日终短信.业务类型为2,人工定制短信.例如:|tranCode@@@9999|SMSType@@@6|Department@@@XD|Sender@@@6221|Bussinesstype@@@1|Sendtime@@@20100514134500|Begindate@@@20100514|BeginTime@@@08 0101|Enddate@@@20100514|Endtime@@@205959|SerioNo@@@1253535|Isback@@@1|mobile@@@186********|content@@@信贷系统短信测试|^具体描述:/// <summary>/// 单条发送短信(标准版)/// </summary>/// <param name="content">短信串</param>/// <returns>返回-1:数据库操作失败;0:数据没更新:大于0:正确</returns> public int SendSMS(string content)第2节群发(一笔最大条数1000,TCP方式一次最多20)短信串的具体内容如下:|短信发送交易码|私有字段|手机号码串|发送信息|群发短信分隔符|^其中短信交易码为9996.私有字段定义:短信类型$发送人(部门)$提交人$业务类型$提交时间$开始日期$开始时间$结束日期$结束时间$批次号$是否需要回执$其中,开始日期、开始时间、结束日期、结束时间不定义(置空)则立即发送,分隔符为空,则默认”,”作为分割符.例如: 6$XD$3$20090907102700$20090907$102700$20090907$205959$0907123456$///<summary>///群发短信(标准版)分隔符是“,”///</summary>/// <param name="content">短信串</param>/// <returns>返回-1:数据库操作失败;0:数据没更新:大于0:正确</returns>public int SendMoreSMS(string content)第3章文件群发接口第1节通讯接口文件接口的目的是当客户端需要通过文件发送短信的时候,首先通过WebService或者TCP/IP告知短信平台要发送文件.文件传送采用FTP和TCP/IP 的方式.具体如下:1.WebService接口.短信串的具体内容如下:|短信发送交易码|私有字段|文件类型|文件名|^其中短信交易码为9995.私有字段定义:短信类型$发送人(部门)$提交人$业务类型$提交时间$开始日期$开始时间$结束日期$结束时间$批次号$是否需要回执$发送文件时,批次号为前台上送的文件批次号例如:|tranCode@@@9995|SMSType@@@6|Department@@@XD|Sender@@@6221|Bussinesst ype@@@1|Sendtime@@@20100514134500|Begindate@@@20100514|BeginTime@@@08 0101|Enddate@@@20100514|Endtime@@@205959|SerioNo@@@1253535|Isback@@@1 |Filetype@@@txt|Filename@@@temp.txt|^/// <summary>////// </summary>/// <param name="content">短信串</param>/// <returns>返回-1:数据库操作失败;0:数据没更新:大于0:正确</returns> public int SendMoreSMS(string content)返回报文:|respcode@@@0000|respmsg@@@发送成功|frountID@@@5|frontfilename@@@temp.txt|backofficeID@@@|^2.TCP/IP接口短信串的具体内容如下:|短信发送交易码|私有字段|文件类型|文件名|^其中短信交易码为9995.私有字段定义:短信类型$发送人(部门)$提交人$业务类型$提交时间$开始日期$开始时间$结束日期$结束时间$批次号$是否需要回执$发送文件时,批次号为上送的文件批次号如:00$HX$8001$0$20090907102700$20090907$102700$20090907$205959$090712 3456$1$第2节文件传输接口文件传输接口的方式有以下两种,其中一种为通过Socket传输文件流的方式,另外一种就是FTP方式,文件最大为20M.文件内部每条短信的定义如下:|序列号|手机号码|内容|^(1)SOCKET传输文件流的方式暂时不支持(2)FTP方式当短信平台收到发送文件类型的短信之后,通过FTP双方约定的目录获取文件,然后解析文件开始发送.第4章数据库的接口接口模式:采用数据库模式数据库版本:SQL SERVER 2000实现原理:直接把数据插入到短信数据库(call)的短信提交表(SMS_REQUEST),通过短信平台发出,提交之前需要先通过NextValue方式获取内部流水号。
MAS使用教程
MAS功能和操作
▪ 通讯录
通讯录是实现内部号码资源管理,促进通讯业务简单、有效使 用的业务功能。它对号码资源可以进行树状分组,并可以分级、 分权限管理。
MAS功能和操作
▪ 通讯录
公司通讯录:是每个用户共享的群组,每个用户都可以使用,但 是增加、修改、删除该群组中内容的人只能是系统管理员。 个人通讯录:是每个用户的私人通讯录,此组是不共享。即帐号A 建立的个人通许录,帐号B登录系统后无法查看帐号A建立的个人 通讯录。 客户通讯录:也是管理员建立,性质同公司通讯录类似。 群组管理:可以根据客户的需求自行建立群组,群组的成员和个 人,公司以及客户的通讯录可以重合,但是开放的性质同个人通 讯录。
MAS代理服务器的技术特色和优势
▪ ▪ ▪ ▪ ▪ ▪ ▪ ▪ 丰富的基本功能; 支持大批量短信群发和超长短信 批量短信:同时发送多个号码同一个内容; 支持回执、失败短信自动重发和回执状态报告 电信级的标准行业应用产品,稳定、可靠,操作简单 业务生成器,可快捷的定义生成各类短信应用,完全 零编程 定义的短信业务可以和企业机构业务系统融合,直接 读取业务系统中的数据 丰富的业务统计分析功能
MAS代理服务器的易用性
系统采用B/S方式,操作简便、界面友好,采用仿 WINDOWS操作系统样式,只要略懂电脑基本操作 即会操作使用; 系统专门针对企业机构业务人员而非技术人员使用而 设计; 系统强大易用的业务生成器,提供了非常强大的行业 业务定制生成能力; 不需要编程、不需要写业务脚本、不需要写SQL语句 即可生成各种动态业务; 一切都能在图形化界面导引下轻松自然地完成; 生成过程全部采取图形化操作,简单几个步骤、几分 钟就可以生成一个功能强大的定制业务。
MAS功能和操作
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
短信平台可广泛嵌入于办公及行政管理系统、电子商务网站、银行/证券业系统软件、企业税务系统行业软件、汽车行业软件、餐饮行业软件、酒店预订行业软件、物流行业管理软件、“家校通”校园管理软件、保险行业管理软件。
以下为你介绍短信云平台中短信接口功能的操作指南。
短信接口
短信接口栏目包括短号管理、接口管理以及短信队列功能。
短号管理
左则点击“短号管理”栏目进入短号管理页面,可对短号进行增加和删除操作。
图表 1
接口管理
左则点击“接口管理”栏目进入接口管理页面,接口管理包括接口分组以及接口管理功能。
接口分组
以树状显示接口分组,可对分组进行增加、修改、删除等操作。
图表2
接口管理
以列表的形式显示接口信息,可对接口进行增加、查看、修改以及删除等操作。
图表 3
增加接口:选中要增加接口的分组,点击“增加”按钮填写接口名称、用户名、密码、应用序列号等信息,点击“提交”后即可成功增加接口。
图表 1
⏹查看接口信息:选中接口所在分组,可以根据指令进行查询,选中接口点击
按钮可查看选中接口详情。
图表 5
⏹修改接口信息:选择接口,点击按钮可修改该接口的名称、用户名、密码
等接口信息。
图表 6
删除接口:选中要删除的接口,点击“删除”按钮即可删除接口。
图表7
短信队列
短信队列栏目对接口所流通的短信进行统一的管理;左侧点击“短信队列”栏目进入短信队列管理页面,以树状形式展现接口列表,点击接口分组可查看接口分组所流通的待发短信、待收短信、收发日志;
待发短信
选择接口分组,可查看该分组下待发的短信;可以根据手机号码、发送时间段查询、增加、删除待发短信;
图表8
待收短信
选择接口分组,点击“待收短信”可查看该接口分组下的待收短信。
图表9
⏹增加:选择接口分组,点击按钮编辑发送时间、SMID、运营商号码、手
机号码、短信内容等信息可新增待收短信(本功能只支持单个短信号码)。
⏹导出:选择要导出待收短信的接口分组,点击按钮可导出该接口分组的
待收短信,导出文件格式为.xls。
收发日志
选择接口分组,点击“收发日志”后以列表形式显示该接口分组下的所有收发的各大运营商的短信信息。
图表10
⏹可以根据手机号码、发送时间段、类型(发送、接收)进行查询;点击“查看”可
查看该短信的收发日志明细情况。
图表11
图表12。