1、.XX房產(chǎn)APP應(yīng)用接口(雙呼方案)開發(fā)確認(rèn)書開發(fā)背景：XX房產(chǎn)APP應(yīng)用與呼叫中心對接。銷售通過APP看到客戶資料，點(diǎn)擊撥號按鈕，向呼叫中心提交撥號請求，呼叫中心首先撥打銷售電話，銷售電話接通后，再撥打客戶電話。XX房產(chǎn)可以通過獲取呼叫記錄接口，得到通話記錄信息（其內(nèi)包含sessionid和通話發(fā)生時(shí)間），利用通話記錄信息可以得到錄音文件。業(yè)務(wù)涉及兩段程序開發(fā)，均采用http接口方式調(diào)用。開發(fā)項(xiàng)目1 - 雙呼撥號請求接口銷售通過APP提供的撥號按鈕聯(lián)系客戶，當(dāng)銷售點(diǎn)擊撥號按鈕時(shí)，調(diào)用呼叫中心此接口，呼叫中心會先撥通銷售電話，銷售應(yīng)答后，呼叫客戶電話。http接口請求內(nèi)容http接口參數(shù)說明參

2、數(shù)名稱類型描述信息EVENTString請求目的：雙呼撥號接口(BackCall)orgidentityString團(tuán)隊(duì)唯一標(biāo)識，用于鑒權(quán)userString鑒權(quán)帳號passwordString鑒權(quán)帳號的密碼pwdtypeString密碼類型 明文(plaintext) / MD5加密(md5)extenString銷售的電話號碼，即主叫方targetdnString客戶的電話號碼，即被叫方calleridString透傳號碼，默認(rèn)使用中繼的主叫號碼http接口返回結(jié)果|Retuen|code|Retuen|message返回值類型:String返回值描述信息|Retuen|1|Retuen|

3、message|Retuen|成功|Retuen|信息描述|Retuen|2|Retuen|message|Retuen|失敗|Retuen|信息描述開發(fā)項(xiàng)目2 - 呼叫記錄獲取接口XX房產(chǎn)網(wǎng)主動調(diào)用此接口，獲取N條呼叫記錄。http接口請求內(nèi)容http接口參數(shù)說明參數(shù)名稱類型描述信息EVENTString請求目的：呼叫記錄獲取接口(GetCdr)orgidentityString團(tuán)隊(duì)唯一標(biāo)識，用于鑒權(quán)userString鑒權(quán)帳號passwordString鑒權(quán)帳號的密碼pwdtypeString密碼類型 明文(plaintext) / MD5加密(md5)idString正整數(shù)，大于等于0，

4、默認(rèn)0，增量參數(shù)，用于數(shù)據(jù)去重limitString正整數(shù)，大于等于1，默認(rèn)10，最大不能超過5000注：每次請求返回行數(shù)最大值為limit（最大不能超過5000條），即從id大于傳入的參數(shù)id的值開始按id升序取出limit條記錄。http接口返回結(jié)果返回值類型:Json格式的字符串result:返回結(jié)果,msg:data:通話記錄數(shù)據(jù),.,totalCount:總記錄數(shù)resultmsgsuccess"result":"success","msg":"data":"id":188,"

5、;calldate":"2013-02-11 10:13:52","answertime":"2013-02-11 10:13:52","endtime":"2013-02-11 10:13:52","calleridnum":"quot;,"dst":"quot;,"didnumber":"400400800","duratio

6、n":"100","billsec":"80","disposition":"ANSWER","agentno":"8888","calltype":"DialOut","team_id":"2","agent_group_id":"3","account_id":"879","

7、trunk_id":"1","sessionid":"d9fd25f98383a9fb32b7ff17d0379e06","totalCount":1error"無權(quán)訪問"json格式數(shù)據(jù)記錄data的各屬性定義：名稱（數(shù)據(jù)庫字段名）描述id呼叫記錄數(shù)據(jù)ID編號calldate開始時(shí)間answertime應(yīng)答時(shí)間endtime結(jié)束時(shí)間calleridnum主叫號碼dst被叫號碼didnumberDID號碼duration總時(shí)長(秒)billsec計(jì)費(fèi)時(shí)長（秒）disposition通話

8、結(jié)果(應(yīng)答/未應(yīng)答)agentno坐席工號calltype呼叫類型（呼出/呼入）team_id團(tuán)隊(duì)IDagent_group_id坐席組IDaccount_id帳號IDtrunk_id中繼IDsessionid通話唯一標(biāo)識如何獲取通話錄音？憑借呼叫記錄中的sessionid字段和calldate字段(該字段的日期部分，即calldate值為2013-02-11 10:13:52只取2013-02-11)調(diào)用呼叫中心提供的“獲取錄音地址”接口。接口返回錄音文件的網(wǎng)絡(luò)地址，文件格式為wav文件。根據(jù)此地址，可下載或直接播放此錄音?！矮@取錄音地址”接口提供javascript和http兩種調(diào)用方式。

9、http接口適用于系統(tǒng)后臺代碼獲取錄音文件，一般用于下載錄音文件。http接口請求內(nèi)容http接口參數(shù)說明參數(shù)名稱類型描述信息EVENTString請求目的：獲取錄音地址接口(GetMonitor)sessionidString通話唯一標(biāo)識calldateString通話發(fā)生日期，例如2013-02-09http接口返回結(jié)果|Retuen|code|Retuen|message返回值類型:String返回值描述信息|Retuen|1|Retuen|address|Retuen|成功|Retuen|錄音訪問地址舉例|Retuen|1|Retuen|Retuen|2|Retuen|message|Retuen|失敗|Retuen|信息描述Javascript接口適用于系統(tǒng)頁面上直接獲取錄音文件地址，一般用于在線試聽。房產(chǎn)公司系統(tǒng)頁面里需引用呼叫中心提供的如下兩個(gè)JS文件<script src=”<script src=”javascript接口原型getMonitorCJI (sessionid, calldate, callbackFuc)javascript參數(shù)說明參數(shù)名稱類型描述信息sessionidString通話唯一標(biāo)識calldateString通話發(fā)生日期，例如2013-02-09callbackFucString回調(diào)函數(shù)ja