公司邮件签名模板个人信息记得自行调整.docx
卡券验证接口接口文档版本号：VLO编写人：刘韵如编写时间：20141116RevisionHistoryNameDateReasonForChangesVersion刘韵如2014-11-16创建文档1.0刘韵如2014-12-04优化文档1.1目录1 .引言4编写目的4背景4定义4参考资料42 .概述43 .对接步骤54 .接口说明5接口形式5使用说明65 .常见问题6如何获得呼叫结果6L引言编写目的为企业技术和产品设计人员提供卡券验证接口及流程设计方案，以实现与第三方平台的互操作，进行业务定制。背景本方案适用于天润托管型呼叫中心CCIC2平台与第三方的基于B/S架构的系统间的行为、数据及事件的交互与传递。本方案承载于HTTP协议，严格遵守HTTP协议规范。本方案的大部分数据传递采用JSON格式，采用JSON协议框架。定义参考资料RFC2616,HTTP协议RFC2617,HTTP认证JSON：JavaScriptObjectNotation,一种轻量级的数据交换格式IVR：InteractiveVbiceResponse,互动式语音应答，即语音导航TTS：TextToSpeech,文本转语音，即文本朗读2 .概述卡券验证是提供给企业的自动语音流程，企业的用户可以通过拨打电话进行团购券验证，会员卡激活，订票等自助服务，大量节约企业的人工成本。常见流程如图:成功3 .对接步骤1 .整理自助验证的语音导航流程及文案，并提交云平台技术支持人员评估2 .与语音云平台技术支持人员约定接口规范：接口功能，接口名称，接口所需参数及返回值等。进行接口开发。3 .云平台技术支持人员根据企业需求进行语音导航及接口地址配置，待企业开发完成后，初步测试接口能否正常使用，及时通知企业进行修改。4 .企业与技术支持人员共同进行导航及接口测试，检测是否符合业务要求，接收及返回的数据格式及内容是否正确。修订后确定最终流程方案。5 .安排最终流程的语音录制，企业可以自行提供语音，也可通过天润融通代录制6 .配置语音文件，测试通过后正式上线7 .接口说明接口形式接口类型：HTTP请求，GET或PoST方式接口请求方：天润融通语音云平台接口接收方：企业侧（接口需要企业开发）接口参数：卡号，密码等返回值：JSoN格式数据，要求无嵌套，无树形结构，内容均为“变量名”:“变量值”形式。接口功能：判断用户输入数据的有效性，返回验证信息接口示例：示例接口参数：number:用户输入的卡号/券号password:用户输入的密码CustomerNumber:用户的来电号码返回示例：（注意不能有层级结构）卡号密码正确：''resull'T'0''密码错误：“resull'TT'）卡号错误："resull'P'2''）示例返回参数：result:是否验证成功及错误原因使用说明企业可根据业务流程决定使用一个或多个如上形式的接口进行验证。1 .单次验证：在用户将所需信息（例如卡号及密码）全部输入之后再进行服务器之间的交互，返回验证信息。如上文中示例接口。2 .依次验证：用户每输入一项信息后云平台调用一个相应的接口进行交互，获取有效性验证，仅在信息有效的情况下继续下一步。可能需要多个接口，例如：a.卡号验证接口：输入参数：customerNumber=01087120766&number=98772312&uniqueld=CeiJdeVjLI-1344493753.3（来电号码,卡号及通话流水号）返回值："result":"。","description":"卡号合法"b.密码验证接口：输入参数：customerNumber=01087120766&pwd=123456&uniqueld=CCiJdeVjLI-1344493753.3（来电号码、密码及同一个通话流水号）返回值："result":"。","description":"验证成功"在卡号验证成功之后,云平台获得返回值,判断卡号合法之后才提示用户进行密码输入,通过向企业传回唯一的通话流水号将两次交互关联到同一业务，并进行密码验证，若卡号判断为不合法，则不进入输入密码的步骤。具体接口个数及参数由双方约定。5.常见问题如何获得呼叫结果有两种途径可以获得呼叫结果和信息：挂机推送接口和通话记录接口，可单独或搭配使用。具体比较如下表：挂机推送接口通话记录接口使用条件企业提供接口，稳定的网络环境企业主动调用调用方向云平台今企业企业今云平台调用时间通话结束企业自行决定提供内容所有原始通话数据语音流程中获取的数据企业调用外呼接口时提供的自定义数据完整的通话相关数据及少量用户自定义数据使用建议适用于希望实时同步数据，并且需要较多自定义业务参数，服务器稳定的企业适用于无实时获取数据需求，数据中较少业务参数，对数据完整性要求高的企业接口说明参见挂机推送接口文档参见通话记录接口文档IjF天润融通I云”中6
