1、XX 房产 APP 应用接口(直呼方案 )开发确认书开发背景：XX 房产 APP 应用与呼叫中心对接。销售通过 APP 看到客户资料，点击拨号按钮，向呼叫中心提交拨号请求，呼叫中心程序记录请求后，告知 APP 一个电话号码，由 APP 触发销售手机拨打此号码。销售进线后，呼叫中心程序检查此销售号码是否有 APP 拨打任务。如有任务，拨打其对应的客户号码，接线给销售。如无任务，按原定 IVR 流程向下进行。 业务涉及两段程序开发，项目一采用 http 接口方式调用。开发项目二供呼叫中心 IVR系统调用，采用 webservice 接口方式。开发项目 1 - 记录 APP 拨号请求接口销售通过 A
2、PP 提供的拨号按钮联系客户，当销售点击拨号按钮时，APP 应调用呼叫中心此接口，向接口提供销售电话，客户电话两个参数。呼叫中心记录此拨号请求，记录成功后，告知 APP 两个参数， code 编码和平台电话号码。 APP 收到 code 编码为 1 时，应触发销售手机拨打平台电话号码，否则提示销售拨号请求失败。http 接口请求内容http:/ 接口参数说明参数名称 类型 描述信息EVENT String 请求目的：APP 拨号(AppDial)orgidentity String 团队唯一标识，鉴权user String 鉴权帐号password String 鉴权帐号密码pwdtype S
3、tring 密码类型 明文(plaintext) / MD5 加密(md5)agentphone String 销售手机号码customerphone String 客户电话号码http 接口返回结果|Retuen|code|Retuen|message返回值类型:String返回值 描述信息|Retuen|1|Retuen|message |Retuen|成功|Retuen|平台电话号码返回值举例：|Retuen|1|Retuen| 0218888888802188888888 为 XX 房产平台电话。APP 收到成功提示后，应触发销售手机拨打此号码。|Retuen|2|Retuen|mes
4、sage |Retuen|失败|Retuen|信息描述只要 code 不为 1，均为记录处理失败。请 APP 告知销售无法拨号。开发项目 2 - IVR 检测呼入号码是否有 APP 拨打任务呼叫中心根据进线的号码搜索 APP 拨号任务表，销售电话匹配成功后，拨打客户电话，电话拨出同时，接线给销售，销售听到拨打客户的等待音。关于 APP 任务自动撤销的处理机制如下：1. 拨打客户时，不管拨打客户是否成功，立即清除本次任务。2. 销售进线后，发现其有 APP 任务，但是任务时长已超一分钟，或更久？，将视为任务过期，销售进线后将按正常 IVR 流程向下进行。如何获取通话录音？XX 房产 WEB 管理
5、系统已做此接口，即后台实时事件接收程序。 XX 房产系统收到IVR 事件中 event=outboundhangup 后，可凭借记录中的 outboundsessionid 字段和 calldate 字段(该字段的日期部分，即 calldate 值为 2013-02-11 10:13:52 只取 2013-02-11)调用呼叫中心提供的“获取录音地址”接口。接口返回录音文件的网络地址，文件格式为 wav 文件。根据此地址，XX 房产可下载或直接播放此录音。“获取录音地址”接口提供 javascript 和 http 两种调用方式。http 接口适用于系统后台代码获取录音文件，一般用于下载录音文
6、件。http 接口请求内容http:/ 接口参数说明参数名称 类型 描述信息EVENT String 请求目的：获取录音地址接口(GetMonitor )sessionid String 通话唯一标识calldate String 通话发生日期，例如 2013-02-09http 接口返回结果|Retuen|code|Retuen|message返回值类型:String返回值 描述信息|Retuen|1|Retuen|address |Retuen|成功|Retuen|录音访问地址举例|Retuen|1|Retuen|http:/ |Retuen|失败|Retuen|信息描述Javascrip
7、t 接口适用于系统页面上直接获取录音文件地址，一般用于在线试听。房产公司系统页面里需引用呼叫中心提供的如下两个 JS 文件javascript 接口原型getMonitorCJI (sessionid, calldate, callbackFuc)javascript 参数说明参数名称 类型 描述信息sessionid String 通话唯一标识calldate String 通话发生日期，例如 2013-02-09callbackFuc String 回调函数javascript 返回结果code:code,message:message返回值类型:JSON返回值 描述信息code:1,message:address code:成功,message:录音访问地址举例code:1,message:http:/ code:错误,message:错误信息
