1.引言-呼叫中心.doc

咨询转移三方挂断 接口文档 版本：1.0 北京天润融通科技有限公司 2014年 01月07日 Revision History Name Date Reason For Changes Version 张雪峰 14/01/07 初始 1.0 张雪峰 14/01/16 1.1 张雪峰 14/01/26 添加座席挂断接口 1.2 引言 编写目的 为开发人员提供一个规范化的接口协议，以实现与第三方平台的互操作，进行业务定制。 背景 本协议适用于天润托管型呼叫中心CCIC2平台与第三方的基于B/S架构的系统间的行为、数据及事件的交互与传递。本协议承载于HTTP协议，严格遵守HTTP协议规范。本协议的大部分数据传递采用JSON格式，采用JSON协议框架。 通过本接口，第三方平台可以给天润托管型呼叫中心发送呼叫请求，天润系统分别呼叫客户和座席，并把双方接通。 定义 参考资料 RFC2616，HTTP协议 RFC2617，HTTP认证 XML协议 Uniform Resource Identifier (URI): Generic Syntax 概述 在整个业务系统中，可以简单分为天润托管呼叫中心平台和企业业务系统两个部分，而本文档所定义的接口就是处在这两个部分之间，实现两个系统之间的互操作和数据交换，如图表 1所示。 图表 1 呼叫中心后台与企业业务系统直接接口模式 图表 2 通过WEB浏览器的接口模式 呼叫中心协议采用HTTP协议承载，HTTP协议采用请求/回应式的、非对称的数据传递方式，而我们所需要的接口应该是双向的、实时性强的数据通道。在图表 1模式下，企业需要一个HTTP客户端，向呼叫中心发起操作请求，也需要企业侧部署一个WEB服务器，以接收来自呼叫中心事件通知，或持续的数据传递； 3. 咨询 接口类型：HTTP请求 接口使用账户：企业账户 接口地址：天润呼叫中心接口服务器IP或域名 接口参数：企业编号，用户名，密码，座席工号，咨询类型，咨询对象 接口返回值：JSON格式返回结果 接口URL URL示例： /interface/Consult?enterpriseId=userName=seed=pwd=cno=consultObject=objectType= 参数说明 参数 要求 描述 备注 enterpriseId 必选 企业编号 管理员后台登陆后，位于右上角位置 userName 必选 用户名 登录后台用户名，如admin pwd 必选 密码 需和seed进行MD5加密，格式：md5(md5(对应userName的密码)+seed)，例如：md5(md5(123456)seed) seed 必选 随机字符串 cno 必选 座席号 比如2000，此座席必须在通话中 objectType 必选 咨询对象类型 取值为： 0：电话号码 1：座席工号 2：分机号 consultObject 必选 咨询对象 objectType=0时为电话号码 objectType=1时为座席工号 objectType=2时为分机号 返回值 此接口为同步接口，当通过验证开始呼叫座席后只有座席接听/呼叫超时/呼叫失败时才会返回。 JSON格式数据 {result:返回结果, code:结果代码,msg:描述} result code msg success 0 咨询成功 error 1 参数[具体参数名]不能为空 error 2 参数[具体参数名]格式不正确 error 3 企业不存在或状态不正常 error 4 无权操作，接口未开通 error 5 密码错误 error 6 传入的座席工号有误 error 7 座席[具体座席号]不在线 error 8 座席[具体座席号]不在通话中 error 9 目标座席不在线，请稍后咨询 error 10 目标座席忙或者已置忙 error 11 连接已中断 error 12 其它错误，请联系管理员 示例 /interface/Consult?enterpriseId=3010066userName=adminseed=1234pwd=b605e86d02eef8bfd0646f6a704c17c9cno=2001consultObjectbjectType=0 返回： {result:success,code:0,msg:咨询成功}. 转移 接口类型：HTTP请求 接口使用账户：企业账户 接口地址：天润呼叫中心接口服务器IP或域名 接口参数：企业编号，用户名