國(guó)信呼叫中心二次開(kāi)發(fā)接口說(shuō)明書(shū)

1、國(guó)信呼叫中心電話客服系統(tǒng)接口說(shuō)明書(shū) V1.1國(guó)信計(jì)算機(jī)科技 2012/10/08國(guó)信科技以“技術(shù)創(chuàng)新”為產(chǎn)品設(shè)計(jì)理念，以現(xiàn)代化的管理方式，不斷追求技術(shù)進(jìn)步、服務(wù)創(chuàng)新，是專(zhuān)業(yè)的呼叫中心電話客服系統(tǒng)提供商, 采用先進(jìn)的SIP 軟交換技術(shù)，為大中小微型企業(yè)機(jī)構(gòu)量身定制呼叫中心解決方案，開(kāi)啟企業(yè)級(jí)互聯(lián)網(wǎng)語(yǔ)音應(yīng)用新時(shí)代。 公司名稱：深圳市國(guó)信計(jì)算機(jī)科技有限公司 公司網(wǎng)址： 服務(wù)郵箱：support Tel/Fax ：+86-755-28529359客服QQ ：1258045866客服QQ ：1258053566一、國(guó)信呼叫中心電話IVR 交互接口電話IVR 交互開(kāi)放接口用于支持呼叫中心與用第三方系統(tǒng)的對(duì)

2、接。讓沒(méi)有IVR 語(yǔ)音交互能力的第三方系統(tǒng)也能通過(guò)電話與客戶交互。典型應(yīng)用場(chǎng)景為：電話下單，電話防偽驗(yàn)證，優(yōu)惠卡消費(fèi)，電話自助查詢等注：由國(guó)信先行根據(jù)您的需求寫(xiě)出電話語(yǔ)音交互流程配置文件，文件格式是XML 的，協(xié)助對(duì)接調(diào)試成功，后續(xù)客戶可自行開(kāi)發(fā)和維護(hù)。二次撥號(hào)交互HTTP 請(qǐng)求接口定義如下：呼叫中心使用HTTP 協(xié)議提交客戶輸入的數(shù)字串到對(duì)接的系統(tǒng)。 此接口要求用戶自研的系統(tǒng)具有http get請(qǐng)求的處理能力。 二次撥號(hào)交互HTTP 響應(yīng)定義如下：第三方系統(tǒng)http 響應(yīng)返回任意字符串?？勺孕卸x字符串的意義，例如：200:成功 400: 失敗。呼叫中心根據(jù)配置文件結(jié)合響應(yīng)自動(dòng)選擇下一步處理

3、方式，處理方式包括： 轉(zhuǎn)話給某個(gè)客服分機(jī) 繼續(xù)放音收號(hào) 掛機(jī)。 使用示例，如圖1-1所示1、使用電話對(duì)卡號(hào)或序列號(hào)驗(yàn)證和提交接口示例： http:/x.x.x.x/srvlt1? id=xxx&caller=xxx&cardnum =xxx 響應(yīng)為純字符串：“200”：提交成功，播放購(gòu)買(mǎi)提示音 “202”：提交成功，可繼續(xù)輸入卡號(hào) “404”：卡無(wú)效，可繼續(xù)輸入“500”：系統(tǒng)錯(cuò)誤，掛機(jī)可以繼續(xù)自定義返回值, 系統(tǒng)可以根據(jù)每個(gè)返回值，播放對(duì)應(yīng)的提示音，進(jìn)行后續(xù)處理。2、電話訂購(gòu)貨物的接口示例：http:/x.x.x.x/srvlt2? id=xxx&caller=xxx& buycount =

4、xxx 響應(yīng)為純字符串：“200”：提交成功，播放購(gòu)買(mǎi)提示音后掛機(jī) “403”：無(wú)權(quán)購(gòu)買(mǎi)，例如當(dāng)前號(hào)碼在黑名單中等 “404”：缺貨，掛機(jī)可以繼續(xù)自定義返回值, 系統(tǒng)可以根據(jù)每個(gè)返回值，播放對(duì)應(yīng)的提示音，然后進(jìn)行后續(xù)處理。3、電話查詢余額的接口示例：http:/x.x.x.x/srvlt2? id=xxx&caller=xxx& userid =xxx 響應(yīng)為字符串：189.12 ：你的余額為一百八十九元一角二分 NOT_FOUND: 用戶不存在 OUT_TIME: 用戶已過(guò)期可以繼續(xù)自定義返回值, 系統(tǒng)可以根據(jù)每個(gè)返回值，播放對(duì)應(yīng)的提示音，然后進(jìn)行后續(xù)處理。3、銷(xiāo)售系統(tǒng)處理方式如圖1-1，根

5、據(jù)http 消息的id 參數(shù), 關(guān)聯(lián)出歷次提及的信息，生成訂單。 圖 1-1 呼叫中心IVR 與銷(xiāo)售系統(tǒng)交互示例二、國(guó)信呼叫中心HTTP 來(lái)電通知接口定義用于對(duì)接客戶現(xiàn)有CRM 和OA 系統(tǒng)，使得CRM 和OA 具有來(lái)電彈屏功能 圖 2-1 呼叫狀態(tài)通知配置三、國(guó)信呼叫中心WebService-SOAP 第三方呼叫控制外呼接口1WSDL 獲取方式，x.x.x.x 是電話服務(wù)器的IP 地址http:/x.x.x.x:12121/bridge/services/CallSoapControl?wsdl2根據(jù)WSDL 生成SOAP 的客戶端代碼即可進(jìn)行第三方呼叫控制3接口說(shuō)明3.1 點(diǎn)擊呼叫接口，可

6、用于批量外呼。 public void click2call(final String caller, final String callee3.2 點(diǎn)擊掛機(jī)的接口 public void click2hungup(final String caller, final String callee3.3 點(diǎn)擊呼叫狀態(tài)查詢接口表 2-3 呼叫狀態(tài)查詢接口 public int state4click(final String caller, final String callee四、IP 電話點(diǎn)擊呼叫接口1WSDL 獲取方式，x.x.x.x 是電話服務(wù)器的IP 地址:

7、12121/bridge/services/Click2CallControl?wsdl2根據(jù)WSDL 生成SOAP 的客戶端代碼即可進(jìn)行IP 電話的點(diǎn)擊呼叫3接口說(shuō)明3.1 IP電話點(diǎn)擊呼叫接口。 public String click2ipcall(final String extnum, final String callee3.2 點(diǎn)擊掛機(jī)的接口 public void click2hungup(final String clickCallId3.3 點(diǎn)擊呼叫狀態(tài)查詢接口表 2-3 呼叫狀態(tài)查詢接口 public int state4click(final String caller,

8、 final String callee3.4 獲取當(dāng)次點(diǎn)擊呼叫的呼叫日志3.4.1 使用下面WSDL 生成日志查詢接口客戶端代碼:12121/bridge/services/CallRecordHome?wsdl3.4.2 當(dāng)次點(diǎn)擊呼叫日志查詢方法說(shuō)明 public Calllog listCallog(final Integer first, final Integer maxResults, final String whereCondition, final String orderby 注意：呼叫日志在接通后生成，掛機(jī)10秒后才能下載錄音四、國(guó)信呼叫中心

9、WebService-SOAP 呼叫日志查詢接口1.WSDL 獲取方式，x.x.x.x 是電話服務(wù)器的IP 地址:12121/bridge/services/CallRecordHome?wsdl:12121/bridge/services/CallLogDataService?wsdl2根據(jù)WSDL 生成SOAP 的客戶端代碼即可查詢呼叫日志，下載錄音3接口說(shuō)明3.1 呼叫日志查詢接口。 public Calllog listCallog(final String beginDate, final String endDate, f

10、inal String telnum public byte downloadVoice(final String filepath四、短信接口1.WSDL 獲取方式，x.x.x.x 是電話服務(wù)器的IP 地址:12121/bridge/services/ClientSmsHome?wsdl2根據(jù)WSDL 生成SOAP 的客戶端代碼即可調(diào)用發(fā)送短信3接口說(shuō)明3.1 短信發(fā)送接口關(guān)鍵方法說(shuō)明。 public int send(final ClientSms sms3.1 短信發(fā)送接口關(guān)鍵方法說(shuō)明。表 4-1 短信發(fā)送結(jié)果查詢接口listWithUserId 方法的定義

11、 public ClientSms listWithUserId(final int firstIndex, final int maxResults, final int userId4. 如何獲取發(fā)送者編號(hào)(sender 四、HTTP 點(diǎn)擊呼叫接口1. 該接口用于通過(guò)網(wǎng)頁(yè)點(diǎn)擊一個(gè)電話號(hào)碼發(fā)起呼叫2. 固定線路點(diǎn)擊呼叫接口:12121/bridge/callctrl?caller=801&callee=179575&authtype=no&opt=CLICK_TO_DIAL 3. IP 電話點(diǎn)擊呼叫接口： :12121/bridge/callctrl?caller=802&callee=127463138663 3&authtype=no&opt=CLICK_TO_IP_DIAL 4. 參數(shù)說(shuō)明 表 5-1 HTTP 點(diǎn)擊呼叫接口說(shuō)明 接口說(shuō) 明 參數(shù) 12121 國(guó)信呼叫中心服務(wù)器IP地址 國(guó)信呼叫中心服務(wù)器WEB端口 該接