外呼通话记录.docVIP

外呼通话记录 接口文档 版本：1.0 北京天润融通科技有限公司 2012年 08月09日 Revision History Name Date Reason For Changes Version 周忠海 12/08/09 初始 1.0 引言 编写目的 为开发人员提供一个规范化的接口协议，以实现与第三方平台的互操作，进行业务定制。 背景 本协议适用于天润托管型呼叫中心Clink平台与第三方的基于B/S架构的系统间的行为、数据及事件的交互与传递。本协议承载于HTTP协议，严格遵守HTTP协议规范。本协议的大部分数据传递采用JSON格式，采用JSON协议框架。 通过本接口，第三方平台可以查询客户来电记录信息，及其详细信息。 定义 参考资料 RFC2616，HTTP协议 RFC2617，HTTP认证 XML协议 Uniform Resource Identifier (URI): Generic Syntax 概述 外呼通话记录请求接口 接口URL（POST方式） 发起者：合作方 接受者：天润融通 接口类型：HTTP接口 调用方式：POST 返回格式：JSON数据 URL规范： /interfaceAction/cdrObInterface!listCdrOb.action 相关参数 参数 要求 描述 备注 hotline 可选 企业热线号码 与enterpriseId二选一 enterpriseId 可选 企业Id 与hotline二选一 userName 必选 用户名 登录后台用户名，如admin pwd 必选 密码 对应username的密码，md5(md5(登录密码)+seed)，例如：md5(md5(123456)seed) seed 必选 随机字符串 uniqueId 可选 电话唯一标识 如果uniqueId值不为空，则其余参数无效，仅hotline、enterpriseId、userName、pwd、seed、uniqueId参数值有效。即仅查询电话唯一标识为uniqueId的记录信息。 callType 可选 呼叫类型 为空表示全部，3表示点击外呼,4表示预览外呼,5表示预测外呼,6表示主叫外呼,7表示自助录音,8表示传真发送10预约回呼 taskId 可选 任务Id callType为预览或预测外呼时才有此条件 status 可选 呼叫结果 为空表示全部，1表示客户未接听, 2表示座席未接听，3表示双方接听 title 可选 查询条件 qno表示队列号(多个之间用英文逗号隔开)，customer_number表示客户电话，cno表示座席工号(多个之间用英文逗号隔开)，number_trunk表示中继号码(多个之间用英文逗号隔开)，client_number表示座席电话 value 可选 查询条件值 对应title的值，此参数需要URLEncode province 可选 客户电话归属省份 为空表示全部，如四川，此参数需要URLEncode city 可选 客户电话归属城市 为空表示全部，如成都，此参数需要URLEncode startTime 可选 开始时间 格式“yyyy-mm-dd hh:mm:ss”，例如：2012-08-01 00:00:00，默认当月第一天，此参数需要URLEncode endTime 可选 结束时间 格式“yyyy-mm-dd hh:mm:ss”，例如：2012-08-08 00:00:00，默认当月最后一天，此参数需要URLEncode timeType 可选 查询的时间类型 默认取值为 1 。1电话进入系统时间，2 记录创建时间 start 可选 从第几条开始取 正整数，大于等于0，默认0 limit 可选 需要取出的数据条数 正整数，大于0，最大不能超过1000，默认10 userField 可选 用户自定义参数 任意字符 返回值 此接口返回JSON格式数据。 JSON格式数据 {result:返回结果msg:{ data:[{通话记录数据},{}..], paging:{从第几条开始取:0,总条数:15,本页条数:10} } } result msg description success { uniqueId:ccic_dev_11-1344323905.20,customerNumber:01041005968,customerProvince:北京,customerCity:北京,numberTrunk:6001,queueName:,cno:2001,clientNumber:01041005966,status:双方接听,sta