电话验证接口说明.docVIP

电话验证接口文档 合力亿捷信息技术有限公司 2016年4月7日  采编历史 名字 日期 变动内容 版本 研发 14/06/20 初始 1.0 售前 16/05/16 组织结构 1.1 1.背景 本协议适用于合力亿捷呼叫中心A1平台与第三方的基于B/S架构的系统间的行为、数据及事件的交互与传递。本协议承载于HTTP协议，严格遵守HTTP协议规范。 通过本接口，第三方平台可以给合力亿捷呼叫中心发送呼叫请求，呼叫中心接收到请求后会先呼通坐席，坐席接起后再呼叫被叫用户。 2.概述 在整个业务系统中，可以简单分为合力亿捷呼叫中心平台和企业业务系统两个部分，而本文档所定义的接口就是处在这两个部分之间，实现两个系统之间的互操作和数据交换，如图表 1所示： 呼叫中心协议采用HTTP协议承载，HTTP协议采用请求/回应式的、非对称的数据传递方式，而我们所需要的接口应该是双向的、实时性强的数据通道。在图表 1模式下，企业需要一个HTTP客户端，由呼叫中心发起操作请求，也需要企业侧部署一个WEB服务器，以接收来自呼叫中心事件通知，或持续的数据传递； （企业方提供URL接口，呼叫中心在来电呼入的IVR流程中可以把来电主叫号码和用户输入的按键等字段发送到企业方的URL接口进行请求，企业方在后台处理后再把结果返回给呼叫中心） 电话验证接口 3.1接口URL（GET方式） 例如：/call/phone 参数 参数名由客户定义，给您提供以下参考（其中phone与id参数名均可以使用其他名称） 参数名 说明 值 其它 phone 请求电话 id 商户号 8位数字 MD5(此参数名要固定为MD5) MD5签名 Md5key是客户与呼叫中心协商的密钥 =MD5(phonedd5key) 即URL地址问号后面所有参数拼接上md5key，再做MD5加密 提示：上表中的id只是一个示例，没必要一定加个id的参数；是否用MD5加密也是可选择的，如果为了安全考虑，可以使用白名单（因为我们请求客户这个接口的ip是固定的） 3.2系统返回值 返回值由企业设定，参考如下： 返回值 描述 200 成功 400 错误 提示：返回的结果不要带任何格式，用简单的字符就可以，例如表示成功，用200 返回值后面可拼接电话号码，例如验证成功需要返回正确的号码以200-139xxxxxxxx这样的形式返回，合力系统会截取真实的号码 3.3接口示例 最后呼叫中心请求客户系统的地址为： 例1：MD5加密 /call/phone?phonedD5=673f1cb3d41d5eb15a3702fa9693f163 其中673f1cb3d41d5eb15a3702fa9693f163 = MD5(phonedd5key) （参数间的也要带上，并且参数与密钥只是字符串拼接，中间没有任何字符。） 例2：验证客户是否为VIP http:////kefu/pdExternalController.do?accountVip=1phone=139xxxxxxxx ?