VASP操作员手册.doc

VASP 操作员手册操作员手册 目目 录录 第一章第一章 系统概述系统概述4 1.1 平台概述4 1.2 平台的安装4 1.2.1 短信系统的配制4 1.2.2 WEB 管理平台的配制6 1.3 各模块介绍7 1.3.1 参数设置7 1.3.2 彩信适配置7 1.3.3 彩信素材8 1.3.4 短信业务8 1.3.5 彩信业务8 1.3.6 信息群发8 1.3.7 客户服务8 1.3.8 报表管理8 1.3.9 系统管理8 1.3.10 短信产品9 第二章第二章 业务开发业务开发10 2.1 短信业务开发10 2.1.1 点播类业务10 2.1.2 包月类业务11 2.1.3 业务入口11 2.1.4 业务接口13 2.1.5 下发信息15 2.1.6 短信业务制作步骤15 2.1.7 包月扣费和包月内容下发17 2.1.8 标准存储过程模板18 2.2 彩信业务开发22 2.2.1 上行接口说明22 2.2.2 下行接口说明22 2.2.3 彩信存储过程模板23 3.2.3 彩信业务发送25 3.2.4 彩信包月下发27 附件一附件一 短信上行分发接口协议规范短信上行分发接口协议规范28 附件二附件二 短信下发各字段填写规范短信下发各字段填写规范31 附件三附件三 短信短信 SUBMIT 包协议规范包协议规范33 第一章第一章 系统概述系统概述 1.1 平台概述平台概述 编写管理员手册的目的是向用户方管理员及有关操作人员提供 EDEESOFT-短信网关综 合管理平台软件系统及其运行环境的说明 1.2 平台的安装平台的安装 1.2.1 短信系统的配制短信系统的配制 短信平台的设置 ： 只需要配制数据库连接参数，其它默认。 系统目录双击运行 Link.Udl，首先选择”提供程序驱动”对 MS SQLServer 数据库选择 “Microsoft Ole DB Provider For SQLServer”,对 Oracle 数据库选择” Microsoft Ole DB Provider For Oracle”,然后配置”数据库连接”,输入数据库的服务器 Ip 地址或者 服务名称,检测数据用户和密码,所选则数据库,测试连接正常,保存配置参数,对 MS SQLServer 数据库操作系统为 2003,如果数据库服务正常启动,但是监听端口无法打开,请到 微软网站下载 MS SQLServer SP3 补丁 1.2.2 WEB 管理平台的配制管理平台的配制 下载、安装及配置 JDK 1.5 与 Tomcat 5.0 配置配置 JDK 1.5 与与 Tomcat 5.0 安装完成后，要对 JDK 和 Tomcat 进行环境变量配置。配置方法如下： 首先进入我的电脑“属性” 高级 环境变量，然后进行环境变量的 配置。 选择 Path 进行编辑，在编辑框的最前端添加： C:Program FilesJavajdk1.5.0bin;C:Program FilesApache Software FoundationTomcat 5.0bin; 设置虚拟目录设置虚拟目录 对于彩信资源共享，web 系统采用了虚拟目录方式管理彩信资源，系统 需要/upload 目录和/recv 两个虚拟目录，分别对应 MMS 彩信资源目录和 上行接收到彩信，找到 Tomcat 5.0 安装目录下的 conf 目录下的 server.xml ，用“记事本”方式打开该文件，在 元素最后加入以下元素： TOMCAT 参数设置参数设置 要求在 tomcat 控制程序 tomcat5w.exe 中的“JAVA”参数设置中，设置如 虚拟目录 映射到的物理路径 下参数，才可以保证 web 的 jsp 文件的正常编译和显示，tomcat 和 jdk 路径根据 实际需要配置 如下配置C:Program FilesApache Software FoundationTomcat 5.0binbootstrap.jar; d:Progsjdklibtools.jar 数据库参数设置数据库参数设置 WEB-INFCLASSESperty WEB-INF 目录的 CLASSES 下 perty 文件 connectstring=jdbc:microsoft:sqlserver:/0:1433;DatabaseName=vas p_new dbuserName=sa dbpassword= 1.3 各模块介绍各模块介绍 1.3.1 参数设置参数设置 黑名单管理：实现短信彩信，手机号码过滤 过滤词语管理 ：实现短信关键词语过滤 移动退定参数：移动 3.0 同步取消参数管理，如果要实现移动短信和彩信包月管理模 块中退定操作，必须在这里添加同步地址参数。 1.3.2 彩信适配置彩信适配置 提供彩信手机型号，屏幕和铃声支持格式设置 1.3.3 彩信素材彩信素材 提供彩信图片，铃声，文本和彩信 SMIL 的资源管理。 1.3.4 短信业务短信业务 实现短信 业务代码管理，短信指令配置，短信业务内容，短信定时任务，短信业务处 理存储过程，业务代码发送（包月用户数据群发） 1.3.5 彩信业务彩信业务 实现彩信业务代码，模板制作（彩信产品） ，定时任务，订阅业务适配，业务代码发送 （包月用户数据群发） ，第三方合作管理账号 1.3.6 信息群发信息群发 手机号码群管理，短信群发，彩信群发 1.3.7 客户服务客户服务 投诉处理，短信上行，短信下行，短信包月，彩信上行，彩信下行，彩信包月， 自写短信，自写彩信。 1.3.8 报表管理报表管理 短信上行流量，短信下行流量，短信收入统计（不包括包月花单） ，短信订阅统计， 短信话单统计，彩信上行流量，彩信下行流量，彩信收入统计（不包括包月花单） ，彩 信订阅统计。 1.3.9 系统管理系统管理 登陆用户和权限管理 1.3.10 短信产品短信产品 用于用户自己扩充业务需要。用户如果增加新的模块，添加模块操作在这两个 表中，为两级关系 SYSTEM_MANAGER_DETAIL 二级菜单二级菜单 SYSTEM_MANAGER_GROUP 一级菜单一级菜单 第二章第二章 业务业务开发开发 2.1 短信业务开发短信业务开发 短信业务可分为点播类，订制类和自定义类业务 用户手机 点播业务模板包月业务模板 用户上行 系统应答 可以二开发 第三方 CP 分发 上行业务流程上行业务流程 业务指令匹配 动态库接口拦截 存储过程总入口 SMS_ON_MODeliver 标准 http 协议 其它业务模板 下发表 信息库（资源管理） 参考业务模板 SMS_ON_Command CPInterfaceUrl.dll 2.1.1 点播类业务点播类业务 1）按照内容顺序点播，如幽默笑话类的固定内容业务 默认业务模板 SMS_ON_Command_IOD 2）按照内容时间点播，如天气预报，新闻，股票类业务 默认业务模板 SMS_ON_Command_IOD_Time 3）媒体互动业务，如电视台互动，直接回复 默认业务模板 SMS_ON_Command_InterActive 4）用户自己定义的点播业务 ，按照业务开发接口规范的存储过程参数或者 http 方法的接口参数，编写特定的存储过程或者 web 处理页面 业务内容存放表 业务内容分组：SMS_CONTENT_GROUP 业务内容：SMS_CONTENT_INFO 2.1.2 包月类业务包月类业务 1）包月业务的订购 通过系统提供的订购业务模板 标准业务模板：SMS_ON_Command_Order 中兴小灵通同步接口：SMS_ON_SSMP 订阅用户表订阅用户表 SMS_USER_ORDER_DETAIL 2) 包月业务的信息发送 A 按照内容顺序提供，如幽默笑话类的固定内容业务 B 按照内容时间提供，如天气预报，新闻，股票类业务 业务内容分组：SMS_CONTENT_GROUP 业务内容：SMS_CONTENT_INFO 3) 其他娱乐游戏性质的业务 按照业务开发接口规范的存储过程参数或者 http 方法的接口参数，编写特 定的存储过程或者 web 处理页面 4) 业务的取消 按照业务代码取消模板 ：SMS_On_Order_Cancel 发送 0000 或者 00000 全部取消：SMS_On_Order_ALL_Cancel 5) 定时业务下发,可以在 WEB 作业管理中直接设置 根据业务内容，提供了标准内容下发模板 按照顺序下发：SMS_PUSH_ORDER_CONTENT 按照时间下发：SMS_PUSH_ORDER_CONTENT_TIME 参考例子参考例子 EXEC SMS_PUSH_ORDER_CONTENT SMG_Type =0 ,SPNumber=03214, ServiceID=TQYB ,GroupContentID=101 2.1.3 业务入口业务入口 系统对上行业务的处理，分动态库接口态库接口和存储过程入口存储过程入口，对于复杂业务用户可以二次 开发新的动态库或者修改动态库新的动态库或者修改动态库实现自己的业务。 数据传输顺序 先通过动态库接口 ，动态库处理后继续传递给数据库接口 A 态库接口 系统提供了 http 协议方式的数据接口 ，接口名称 CPInterFaceUrl.dll，接口统一函数 OpenRequestUrl 实现 web 页面的远程调用 分发参数如下： ICPID:企业代码 SPNUMBER:企业特服务号码 COMMAND:匹配指令 SERVICEID:业务代码 USERNUMBER:手机号码 MSGCONTENT:短信内容 LINKID:鉴权 ID 具体使用说明参考上行分发接口提供模板 TCP 接口和 HTTP 接口协议.doc 请求例子： HTTP://Query.asp?ICPID=237439 byte bytes=RESP.getBytes(); RESP=“; for (int i = 0; i 4; if(*des9) *des=*des-10+A; else *des=*des+0; *(des+1)=*src if(*(des+1)9) *(des+1)=*(des+1)-10+A; else *(des+1)=*(des+1)+0; src+;des=des+2; *des=0; return ret; 附件二附件二 短信下发各字段填写规范短信下发各字段填写规范 1.1.移动协议移动协议 FeetypeFeetype 计费类型 01=免费 02=按条 03=包月 04=封顶 05=SP 收费 FeeUserTypeFeeUserType 下发短信由谁付费 0对目的手机收费， 1对源手机收费 2对 SP 收费， 3对计费号码字段收费 Registered_DeliveryRegistered_Delivery (对应系统下发模板表的 NeedReportNeedReport 字段) 是否要求返回状态确认报告： 0：不需要 1：需要 2：产生 SMC 话单 （该类型短信仅供网关计费使用，不发送给目的终端） 2.2.联通协议联通协议 FeetypeFeetype 计费类型 01-免费 02-按条 03-包月 04-由 SP 实现 MORelateToMTFlagMORelateToMTFlag(对应系统下发模板表的 SubTypeSubType 字段) 引起 MT 消息的原因 0MO 点播引起的第一条 MT 消息 1MO 点播引起的非第一条 MT 消息 2非 MO 点播引起的 MT 消息 3系统反馈引起的 MT 消息。 ReportFlagReportFlag (对应系统下发模板表的 NeedReport 字段) 状态报告标记 0该条消息只有最后出错时要返回状态报告 1该条消息无论最后是否成功都要返回状态报告 2该条消息不需要返回状态报告 3该条消息仅携带包月计费信息，不下发给用户，要返回状态报告 3.3.网通协议网通协议 字段 短消息 SubTypeFeeTypeFeeUserTypeFeeCode （字段说明） 短消息子 类型（0 取消订阅， 1订阅或 点播请求， 2点播下 发，3订 阅下发， 其他保留） 资费类型 00=免费 01=按条收费 02=包月 03=封顶 04=包月扣费请求 05=CR话单 其他：保留 计费用户类型字段 0：对目的终端计 费 1：对源终端计费 2：对 SP 计费 3：按照计费用户 号码计费 其他保留 每条短消息 的信息费， 单位：分 点播下发 2010xx 订阅结果 30120 取消订阅 00110 包月扣款请求 3040xx 订阅下发（包月） 30200 订阅下发（按条） 3010xx 自写短信 2013xx 点到点短消息 201 （无此字段） 0 4 4 电信协议电信协议 MsgTypeMsgType 短消息类型(对应系统下发模板表的 SubType 字段) 1 取消订阅 2 订阅请求（当用户请求订阅时，作为订阅请求的响应信息。 ） 3 点播及通过 PC 下发的点对点短消息 4 订阅（每一条订阅信息下发时使用） 5 交互式操作 6 查询 FeeTypeFeeType 计费类型 00 免费 01 按条收费 02 包月 03 封顶 其他保留 FixedFee 包月话单，电信下发包月话单，填写此字段 附件三附件三 短信短信 SUBMIT 包协议规范包协议规范 1.1.联通联通 字段长度（字 节） 类型说明 SPNumber21Text SP 的接入号码 ChargeNumber21Text 付费号码，手机号码前加“86”国别标志； 当且仅当群发且对用户收费时为空；如果为 空，则该条短消息产生的费用由 UserNumber 代表的用户支付；如果为全零 字符串“000000000000000000000” ，表示该 条短消息产生的费用由 SP 支付。 UserCount1Intege r 接收短消息的手机数量，取值范围 1 至 100 UserNumber21Text 接收该短消息的手机号，该字段重复 UserCount 指定的次数，手机号码前加 “86”国别标志 CorpId5Text 企业代码，取值范围 0-99999 ServiceType10Text 业务代码，由 SP 定义 FeeType1Intege r 计费类型 01 02 03 04 05 其它 FeeValue6Text 取值范围 0-99999，该条短消息的收费值， 单位为分，由 SP 定义 对于包月制收费的用户，该值为月租费的值 GivenValue6Text 取值范围 0-99999，赠送用户的话费，单位 为分，由 SP 定义，特指由 SP 向用户发送广 告时的赠送话费 AgentFlag1Intege r 代收费标志，0：应收；1：实收 MorelatetoMTFl ag 1Intege r 引起 MT 消息的原因 0-MO 点播引起的第一条 MT 消息； 1-MO 点播引起的非第一条 MT 消息； 2-非 MO 点播引起的 MT 消息； 3-系统反馈引起的 MT 消息。 Priority1Intege r 优先级 0-9 从低到高，默认为 0 ExpireTime16Text 短消息寿命的终止时间，如果为空，表示使 用短消息中心的缺省值。时间内容为 16 个 字符，格式为”yymmddhhmmsstnnp” ，其 中“tnnp”取固定值“032+” ，即默认系统 为北京时间 ScheduleTime16Text 短消息定时发送的时间，如果为空，表示立 刻发送该短消息。时间内容为 16 个字符， 格式为“yymmddhhmmsstnnp” ，其中 “tnnp”取固定值“032+” ，即默认系统为 北京时间 ReportFlag1Intege r 状态报告标记 0-该条消息只有最后出错时要返回状态报告 1-该条消息无论最后是否成功都要返回状态 报告 2-该条消息不需要返回状态报告 3-该条消息仅携带包月计费信息，不下发给 用户，要返回状态报告 其它-保留 缺省设置为 0 TP_pid1Intege r GSM 协议类型。详细解释请参考 GSM03.40 中的 TP_udhi1Intege r GSM 协议类型。详细解释请参考 GSM03.40 中的 3,仅使用 1 位，右对齐 MessageCoding1Intege r 短消息的编码格式。 0：纯 ASCII 字符串 3：写卡操作 4：二进制编码 8：UCS2 编码 15: GBK 编码 其它参见 GSM3.38 第 4 节：SMS Data Coding Scheme MessageType1Intege r 信息类型： 0-短消息信息 其它：待定 MessageLength4Intege r 短消息的长度 MessageContentMessage Length Text 短消息的内容 Reserve8Text 保留，扩展用 2.2.移动移动 字段名字节数属性描述 Msg_Id8Unsigned Integer Pk_total1Unsigned Integer 相同 Msg_Id 的信息总条数，从 1 开始 Pk_number1Unsigned Integer 相同 Msg_Id 的信息序号，从 1 开始 Registered_Del ivery 1Unsigned Integer 是否要求返回状态确认报告： 0：不需要 1：需要 2：产生 SMC 话单 （该类型短信仅供网关计费使用，不发 送给目的终端) Msg_level1Unsigned Integer 信息级别 Service_Id10Octet String 业务类型，是数字、字母和符号的组合。 Fee_UserType1Unsigned Integer 计费用户类型字段 0：对目的 MSISDN 计费； 1：对源终端 MSISDN 计费； 2：对 SP 计费; 3：表示本字段无效，对谁计费参见 Fee_terminal_Id 字段。 Fee_terminal_I d 21Unsigned Integer 被计费用户的号码（如本字节填空，则 表示本字段无效，对谁计费参见 Fee_UserType 字段，本字段与 Fee_UserType 字段互斥） TP_pId1 GSM 协议类型。详细是解释请参考 GSM03.40 中的 TP_udhi1Unsigned Integer GSM 协议类型。详细是解释请参考 GSM03.40 中的 3,仅使用 1 位， 右对齐 Msg_Fmt1Unsigned Integer 信息格式 0：ASCII 串 3：短信写卡操作 4：二进制信息 8：UCS2 编码 15：含 GB 汉字 。 。 。 。 。 。 Msg_src6Octet String FeeType2Octet String 资 费 类 别 01：对“计费用户号码”免费 02：对“计费用户号码”按条计信息费 03：对“计费用户号码”按包月收取信 息费 04：对“计费用户号码”的信息费封顶 05：对“计费用户号码”的收费是由 SP 实现 FeeCode6Octet String 资费代码（以分为单位） ValId_Time17Octet String 存活有效期，格式遵循 SMPP3.3 协议 At_Time17Octet String 定时发送时间，格式遵循 SMPP3.3 协议 Src_Id21Octet String 源号码 SP 的服务代码或前缀为服务代码的长号 码, 网关将该号码完整的填到 SMPP 协议 Submit_SM 消息相应的 source_addr 字段， 该号码最终在用户手机上显示为短消息 的主叫号码 DestUsr_tl1Unsigned Integer 接收信息的用户数量(小于 100 个用户) Dest_terminal_ Id 21*DestUsr_tlOctet String 接收短信的 MSISDN 号码 Msg_Length1Unsigned Integer 信息长度(Msg_Fmt 值为 0 时：160 个字 节；其它=140 个字节) Msg_ContentMsg_lengthOctet String 信息内容 Reserve8Octet String 保留 3 3 电信电信 字段字段长度（字节）长度（字节） 数据类型数据类型说明说明 MsgType1integer 短消息类型（1取消订阅，2订阅请 求，3点播，4订阅，5交互式操作， 6=查询，其他保留） NeedReport1integer 是否要求返回状态报告（0=不要求，1= 要求） Priority1Integer 发送优先级（从 0 到 9） ServiceID10Octet String 业务类型 FeeType2Octet String 收费类型（参见第 7.2 节收费类型代码 表） 00免费 01按条收费 02包月 03封顶 FeeCode6Octet String 资费代码（单位为分） FixedFee6Octet String 包月费/封顶费（单位为分） MsgFormat1Octet String 短消息格式 0ASCII 编码 3短消息写卡操作 4二进制短消息 8UCS2 编码 15GB18030 编码 ValidTime17Octet String 有效时间，格式遵循 SMPP3.3 协议 AtTime17Octet String 定时发送时间，格式遵循 SMPP3.3 协议 SrcTermID21Octet String 短信息发送方的电话号码（格式为“电 话号码*子信箱号“），当短消息来自 CP 时，电话号码为 118+CP ID 或者发送 方主叫号码。 ChargeTermID21Octet 计费用户号码 String DestTermIDCount1Integer 短消息接收号码总数（100） DestTermIDOctet String* 短消息接收号码（连续存储 D