信元公众信息发展有限责任公司

1、信元公众信息发展有限责任公司用户手册信元公众信息发展有限责任公司SP用户手册产品名称：中国电信168SP用户手册产品编号：1.1文档编号：版 本 号：1.0编制单位：全国电话信息服务运营中心更新日期：2006-04-19拟制人审核标准化批准目 录1.引言.42. 168 SP流程开发中的注意事项.42.1流程开始必须检查主叫的合法性42.2流程中要尽量用系统变量，少用自定义变量52.3流程中不要应用过多的函数52.4流程中请写明详细的注释.62.5新的节目需要提供详细的开发资料.62.6语音更新及流程改版注意事项.62.7流程中建表说明.63. 168SP流程开发相关函数说明63.1 168流

2、程中点送节目相关说明及相关函数.63.2 168流程中录音相关说明及关函数.74. 168SP网关开发说明74.1协议描述.84.2直接传输字符串的包格式.84.3需要包头信息的包格式.84.4不加密字符串的短连接传输协议.94.5根据密钥加密的短连接传输协议.104.6不加密的字符串长连接传输协议.114.7根据密钥加密的长连接传输协议.124.8 IVR向通用网关发包.135. 168SP自管理WEB页面使用说明.155.1话单统计查询管理.156. 168SP聊天室WEB管理页面使用说明.166.1 创建会议.166.2 聊天室web页面管理.161.引言本说明是对SP、电信运营商两方提

3、供的一个协同工作的说明。本文档主要提供给SP用户阅读参考，以帮助SP用户更好理解平台流程开发规范，了解系统的使用，通过规范流程的开发，规范流程的管理，从而提高工作效率。 重点注意： 接入前请与负责您业务的项目经理确认此业务开通的平台（目前168全网业务分为二期和三期两个平台） 注意语音格式，二期平台语音为6K 16bit VOX语音，三期平台为8K 4bitVOX语音，如语音格式不对，则无法正常进行测试及业务上线。 三期平台对文件名区分大小写，为了统一，所有语音文件名及路径名全部用小写，流程中文件名及路径名同样使用小写，请一定注意。2.1流程开始必须检查主叫的合法性及填加用户确认。流程接入后，

4、需要对主叫号码进行判断，以禁止非法主叫的接入，可调用函数： 具体函数请看电信168用户验证函数.sc 请注意，电信168没有类似网通116一样的卡认证等操作，也没有tbl_areacode这样的表，所以在写流程时不需要写这些，请严格按以下格式进行流程编写。 流程接入后要求有标准的播报费率及用户按键确认过程，标准如下： welcome_xxxxx.vox 欢迎播打XXX热线，本节目信息费每分钟X元。 fee_xxxxx.vox 以上内容免收信息费，请您按任意键继续。 sure_xxxxx.vox 请您按任意键继续。 具体可参照电信168流程整体例子.sc2.2流程中要尽量用系统变量为了保障平台的

5、稳定，流程中要尽量用系统变量，少用自定义变量，每个流程中限制使用的自定义变量不能超过100个。大量的应用自定义变量，会导致平台IVR消耗大量的内存，从而是平台性能下降，降低平台的稳定性。2.3 流程中不要应用过多的函数一个流程中应用的函数不要超过20个，并且要注意，多次复用的部分请写成函数，对于只调用一次的函数请尽量写到主函数中，另外，函数中请不要多重嵌套，嵌套调用函数不要超过2层。过多的函数调用及函数嵌套使用，一但处理不当，就会造成流程挂死，语音资源不能正常释放等问题，所以在开发流程时一定要注意。2.4 流程中请写明详细的注释为了规范流程的开发，也为了便于SP及我们当流程出现问题的时候能及时

6、查找原因，请您在开发流程时写明详细注释。2.5 新的节目需要提供详细的开发资料新提交的业务，请提供详细的文档资料，其中包括，流程图，语音说明文本，需要建库的请提供SYBASE建库脚本，SP自已编写流程的提供.sc源文件及.ini配置文件。2.6 语音更新及流程改版注意事项语音更新时，除提供所需.vox语音文件同时，请提供相应的语音文字说明。以方便我们及时审核语音。流程改版时请提供改版后的流程图及相关说明文档，SP自己开发流程的请提供改版后的.sc源文件及.ini配置文件。2.7 流程中建表说明为了规范数据库的使用，请合作方提供建表脚本时按照如下格式命名：T168XXXXX_自定义字符串例：节目

7、号为16812345，相关建表为T16812345_user,T16812345_log注意：请合作方一定按以上流程开发中相关注意事项与说明开发流程，谢谢！3. 168SP流程开发相关函数说明3.1 流程中点送节目相关说明及相关函数 3.1.1点送部分可按以下函数编写，此函数可以直接使用：二期平台请参照：电信168二期写预拨号函数.sc三期平台请参照：电信168三期写预拨号函数.sc3.1.2 点送部分统一计费编码为：168XXXXX02，如节目号码为16812345,则点送的计费编码为：1681234502.3.2 流程中录音相关说明及关函数录音时为了避免一个文件夹下录音文件过多，不易打开文

8、件，在写录音文件时请注意一定要将录音文件放到统一的一个Record文件夹下，然后以日期命名文件夹，详细请参考以下函数：电信168录音函数.sc4. 168SP网关开发说明通用网关是新太IVR和SP应用服务器之间，进行消息交互的中间协议转换程序。通用网关的位置如下图（1）所示：图（1）新太IVR和通用网关之间采用新太内部的协议，通用网关和外部SP应用服务程序之间采用TCP/IP协议，通用网关作为客户端，SP应用服务程序作为服务器端，可以采用长接连或者短连接两个连接方式。按照TCP协议长连接和短连接的连接方式，以及业务数据否需要加密等业务需求，新太通用网关对外提供了四种方式的连接协议，分别是：短连

9、接不加密的字符串传输方式，短连接根据密钥加密的传输方式，长连接不加密的字符串传输方式，以及长连接根据密钥加密传输协议。4.1 协议描述新太通用网关对外提供了四种方式的连接协议，分别是：短连接不加密的字符串传输方式（不需要包头信息），短连接根据密钥加密的传输方式，长连接不加密的字符串传输方式，以及长连接根据密钥加密传输协议。4.2 直接传输字符串的包格式对于不加密的字符串短连接传输协议方式，由于传输的数据以“0”为结束符，控制简单，因此数据是直接传输的，传输的包为以”0”结尾的字符串数据。4.3 需要包头信息的包格式对于其他三种方式，包括根据密钥加密的短连接传输协议、不加密的字符串长连接传输协议

10、、根据密钥加密的长连接传输协议，都需要在数据之前加上包头通信控制信息。数据包格式如下图所示，所包含的内容从左到右进行传输：表1 通讯包格式示意图注意：包头中的信息全部为网络字节顺序！包头的各字段说明如下：序号字段名称长度(Bytes)字段说明1head2包头标识，固定为0XFFFF2version2版本信息，当前为0X00203taskid4任务流水号4sender4发送方标识15sessionid4发送方标识26timestamp4时间戳7flag2数据加密标志：0：不加密，1：DES加密8length2不包括包头的包体长度表2 包头格式说明包头信息中，除了包体长度（length）以外，其他

11、的字段，包括开始标识（head），版本信息（version），任务流水号（taskid），发送方标识1（sender），发送方标识2（sessionid），时间戳(timestamp)，以及数据加密标识（flag），需要在响应包中原样返回；否则通用网关接收返回消息后，可能解析出错，最终导致IVR业务处理错误。再次提醒：包头中的字段信息全部为网络字节顺序；短连接不加密方式不需要包头信息。4.4 不加密字符串的短连接传输协议这种方式并发性好，开发实现起来简单，程序配置方便，容易排除错误，适合于安全性要求不高，或要求高安全性但通过专线网络连接的业务；除了在公网上开展小额支付的业务以外，其他的业务都建

12、议采用这种方式。对于这种方式，系统消息交互的过程，大概分如下几个步骤，见下图（2）所示：图（2）4.5 根据密钥加密的短连接传输协议这种方式并发性好，安全性高，但实现起来相对较难，联调出现错误不容易排除。在公网上实现的并发性高的电子商务类交互业务，建议采用这种方式。本方式采用DES加密，双方需要约定一个密钥(Key)，目前约定密钥为长度额为8位的字符串，一般由SP服务器端来指定，提供给通用网关的维护人员，由维护人员在本地对通用网关进行配置。在发送数据给对方之前，通信的双方根据本地配置的密钥对数据进行DES加密处理；在收到数据后，同样根据本地配置的密匙进行解密处理；通信连接方式上和上述第一种完全

13、一样。具体过程详细说明如下，如图（3）所示：图（3）4.6 不加密的字符串长连接传输协议这种方式可靠性高，能够保持持续的连接，但对于资源的消耗比较高，并发性不太好，调试跟踪不太方便，一般不建议采用这种方式。具体过程详细说明如下，如图（4）所示：图（4）4.7 根据密钥加密的长连接传输协议这种方式可靠性高，安全性高，能够保持持续的连接，但对于资源的消耗比较高，并发性不太好，调试跟踪不太方便，一般不建议采用这种方式。本方式采用DES加密，双方需要约定一个密钥(Key)，目前约定密钥为长度额为8位的字符串，一般由SP服务器端来指定，提供给通用网关的维护人员，由维护人员在本地对通用网关进行配置。在发送

14、数据给对方之前，通信的双方根据本地配置的密钥对数据进行DES加密处理；在收到数据后，同样根据本地配置的密匙进行解密处理；通信连接方式上和上述第三种完全一样。具体过程详细说明如下，如图（5）所示：图（5）4.8 IVR向通用网关发包 流程的DIRECTREQUESTDATA动作能将信息发给网关。DIRECTREQUESTDATA有三个参数。第一个参数，是网关的ID，它的值是【网关的站号×100+模块GOR】比如，在OAMTerm中配置程序CommonGW的站号是22，则该网关的ID 22×100 95 2295第二个参数，是模块编号，IVR根据模块号访问不同的模块，收发数据第

15、三个参数，就是要向网关发送的内容（一般是一个请求信息，如在社保查询中就是一个带有个人社保号等信息的查询包），以字符串形式出现，而具体的格式则需要与对方订立数据接口协议，作为通用网关不牵涉具体的业务。如果流程中想要查询模块编号为12的社保信息，命令串为“888888”，则流程写法如下：:stSend DIRECTREQUESTDATA2295,12,"888888"DataReceived (0)->stOkDataReceived->stFailGatewayNotExist->stExitTimeOut->stTimeOut: stOkASSIGN

16、 SR1, FD0Equal SR1, "888888111"Passed ->stOpenPrompt Failed ->stExit这里的"888888"就是一个查询字符串，格式当然是虚构的，因为真实的系统中可能不是那么的简单的。通过对FD0的访问读取请求的结果串. 返回值含义1客户端不可用或超出最大连接数！2连接服务器失败！3发送数据失败！4接收数据出错！5加密数据出错！6数据解密出错！7接收数据超时！注意：SP的服务端在收到IVR的请求数据包后，一定要回复数据包，以便使流程能正常接受应答。5. 168SP自管理WEB页面使用说明5.1

17、话单统计查询管理进入全国声讯联网系统：4:8080/输入服务商提供代码、操作员登陆账号、操作员登陆密码后，进入查看页面；可看到有下面5个栏目。流程管理和服务管理暂不对各sp开放；统计下载：对业务话单进行统计查询管理和下载；公告栏：查询最新向各sp发放的一些通知等；其他操作：可显示sp信息、进行密码修改、日志查询等的操作。注意：sp首次登陆web页面后，应第一时间修改登陆密码。6. 168SP聊天室WEB管理页面使用说明6.1 创建会议会议必须要由主持人创建，创建方法请参考：会议创建例子6.2 聊天室web页面管理打开web页面，在地址栏中输入：http:/

18、1/:8080 （三期118）、8:8080/ （二期168）出现登录页面在网页上，输入会议编号、帐号后进入会议室页面（如下图所示）：注意：会议编号、帐号会及时通知各sp;在会议召开的过程中，有会议参加者，由会议发起者（即主持人），将会议参加者的状态由初始的只听模式改为可说的状态。这样就可听可讲了。呼叫成员：就是我们可以将欲加入的电话号加入到会议当中来。拆出会议：就是将会议中的一个或某些与会者从会议当中踢出去。合并会议：将正在开的2个或多个会议合并成一个会议。拆分会议：将一个正在开的会拆分成个若干个会议，拆分方数以与会者数量相关。转移权限：暂时不支持。加入会议：将在不同会议中的与会者加入到某一会议中（注：不允许将某一会议的主持人加入其他会议）。关闭报数：暂不支持该功能。开始密谈：支持2个