聯(lián)傲電話助理二次開發(fā)
首頁(yè)>聯(lián)傲電話助理二次開發(fā)>概述
1.概述
TAServer為聯(lián)傲云座席客戶端服務(wù)程序，安裝后開機(jī)自動(dòng)運(yùn)行。聯(lián)傲云座席提供WebSocket開發(fā)接口，封裝了完整的方法和事件，可方便地在應(yīng)用系統(tǒng)中實(shí)現(xiàn)外呼、彈屏、錄音等應(yīng)用。
聯(lián)傲電訊已將接口再次封裝成teleAgent.js對(duì)象,集成商在項(xiàng)目中引用teleAgent.js對(duì)象就可以。
話務(wù)員直接使用企業(yè)CRM或定制的應(yīng)用，實(shí)現(xiàn)軟件外呼，來電彈屏，通話錄音功能。
teleAgent.js接口
1.方法
1. Connect ( Socket_port)
功能：連接聯(lián)傲云座席服務(wù)
參數(shù)：Socket_port： WebSocket 服務(wù)端口。
注意：每個(gè)座席只允許連接一個(gè)客戶端。如果已有一個(gè)客戶端連接，則不允許其它的客戶端連接。
2. Disconnect
功能：斷開聯(lián)傲云座席服務(wù)
3. Login (CompanyAccount, AgentNo, Password,)
功能：連接并登陸賬號(hào)
參數(shù)：CompanyAccount： 該企業(yè)在聯(lián)傲云注冊(cè)的企業(yè)賬號(hào) AgentNo： 用戶在聯(lián)傲云的賬號(hào) Password： 用戶在聯(lián)傲云的密碼
說明：業(yè)務(wù)系統(tǒng)和聯(lián)傲云各自有自己的賬號(hào)體系，業(yè)務(wù)方要建立一個(gè)業(yè)務(wù)系統(tǒng)賬號(hào)到聯(lián)傲云賬號(hào)的映射表，例如某用戶在業(yè)務(wù)系統(tǒng)中的賬號(hào)密碼是：張三、123, 對(duì)應(yīng)在聯(lián)傲云的賬號(hào)密碼是：李四、456；企業(yè)賬號(hào)的：ABC.
系統(tǒng)集成完成后，用戶打開業(yè)務(wù)系統(tǒng)，在業(yè)務(wù)系統(tǒng)中用：張三、123 完成登錄驗(yàn)證，然后調(diào)用Login接口用：ABC、李四、456 向聯(lián)傲云完成座席登錄.
4. Logout
功能：話務(wù)員簽出
5. DoAction(action, param)
功能：通訊控制功能。
參數(shù)： action 指具體要使用的功能名，大寫字符串表示，參見下表
|
action |
Param |
|
呼叫 ‘CALLOUT’ |
呼叫的目標(biāo)號(hào)碼 |
|
功能：軟件呼叫。 示例: teleAgent.DoAction(‘CALLOUT’,’13912345678’) 應(yīng)用：點(diǎn)擊呼叫、自動(dòng)呼叫。 注意： 采用TA01T 型電話盒：無需摘起話機(jī)，可以直接調(diào)用此方法呼叫。 采用TA01R/M 型電話盒：必須摘機(jī)后才可以掉用此方法呼叫. |
|
|
發(fā)碼‘SENDDTMF’ |
DTMF碼 |
|
功能：效果相當(dāng)于手動(dòng)按電話機(jī)按鍵 示例：teleAgent.DoAction(‘SENDDTMF’,’1’) 應(yīng)用：例如軟件呼叫對(duì)方接通的是呼叫中心或總機(jī)，需要二次按鍵，則可以用此方法模擬手撥按鍵。 |
|
|
摘機(jī)‘OFFHOOK’ |
|
|
功能：軟件摘機(jī) 示例： teleAgent.DoAction(‘OFFHOOK’) 應(yīng)用：例如客戶來電，用此方法實(shí)現(xiàn)軟件接聽。 注意：僅對(duì) TA01R/M 型電話盒有效。 |
|
|
掛機(jī)‘ONHOOK’ |
|
|
功能：軟件掛機(jī) 示例：teleAgent.DoAction(‘ONOOK’) 應(yīng)用：例如通話結(jié)束，用此方法實(shí)現(xiàn)軟件掛機(jī)。 注意：僅對(duì) TA01R/M 型電話盒有效。 |
|
2.事件
teleAgent.js 封裝了各種狀態(tài)事件，以JSON回傳詳細(xì)信息，參見以下說明：
2.2.1 OnWSConnectState (jsonData)
功能： WebSocket服務(wù)連接狀態(tài)事件。
jsonData: {conState: "open"}
conState: open為連接成功，Error為出現(xiàn)錯(cuò)誤，close為連接關(guān)閉。
實(shí)例：
teleAgent. OnWSConnectState(function (jsonData) {
//處理事件響應(yīng)的業(yè)務(wù)邏輯，
}
實(shí)例：
teleAgent. OnWSConnectState(function (jsonData) {
//處理事件響應(yīng)的業(yè)務(wù)邏輯，
}
2.2.2 onDeviceState (jsonData)
功能： 話務(wù)設(shè)備狀態(tài)事件
jsonData:
{"EVENT":" DEVICE",“DEVTYPE”:”設(shè)備類型”,"DEVSTATE":"設(shè)備狀態(tài) ","DEVINFO":"狀態(tài)描述 "，“PHONESTATE”:”話機(jī)狀態(tài)”}
DEVTYPE: 3 錄音型.
2 外呼型
4 混合型
DEVSTATE ： -1 故障
0 正常初始化
1 OK
2 告警
PHONESTATE: --- 話機(jī)狀態(tài) --- 對(duì)應(yīng)主要信息
ST_INITDEV = 0; 初始化中
ST_IDLE = 1; 掛機(jī)
ST_CHEDKDIALTONE = 2; 摘機(jī)準(zhǔn)備呼出
ST_PRECALL = 3; // 檢測(cè)是否預(yù)撥號(hào) 內(nèi)線話機(jī)摘機(jī)準(zhǔn)備撥號(hào)
ST_CALLOUT = 4; // 已區(qū)分了撥叫內(nèi)線或外線 摘機(jī)呼出
ST_RING = 5; 振鈴
ST_TALK = 6; 通話
ST_DISCONNECT = 7; 電話線斷開
實(shí)例：
teleAgent.onDeviceState(function (data) {
//處理事件響應(yīng)的業(yè)務(wù)邏輯
});
2.2.3 onLoginState(jsonData)
功能： 聯(lián)傲云座席登錄狀態(tài)事件
jsonData:
{"EVENT":" LOGINSTATE ","COMPANY":"企業(yè)賬號(hào)","USER":"用戶賬號(hào)","ERRCODE":"狀態(tài)碼","ERRMSG":"描述"}
ERRCODE: 1000 表示登錄成功。其它值表示登錄失敗，原因參見ERRMSG描述。
實(shí)例：
teleAgent.onLoginState(function (jsonData) {
//處理事件響應(yīng)的業(yè)務(wù)邏輯
});
2.2.4 onCallState(jsonData)
功能： 呼叫狀態(tài)事件
修改： 所有呼叫相關(guān)事件均添加了 CALLTYPE 鍵值，
CALLTYPE 1: 接聽。 2： 呼出 。 0：空閑
STATE = 1 通話
{"EVENT":"CALLSTATE","TELNO":"%s","STATE":"1","STATEMSG":"通話","CALLTYPE":"%d"}
CallType : 1 接聽； 其它：呼出
STATE = 2 來電震鈴
{"EVENT":"CALLSTATE","STATE":"2","STATEMSG":"通話","TELNO":"來電號(hào)碼","RINGCOUNT":"振鈴計(jì)數(shù)"}
說明：RINGCOUNT=1表示是一次新的來電。
STATE = 3 收到按鍵
{"EVENT":"CALLSTATE","STATE":"3","STATEMSG":"按鍵","DTMF":"%s"}
STATE = 4 摘機(jī)
{"EVENT":"CALLSTATE","STATE":"4","STATEMSG":"摘機(jī)"}
STATE = 5 掛機(jī)
{"EVENT":"CALLSTATE","STATE":"5","STATEMSG":"掛機(jī)"}
STATE = 6 監(jiān)測(cè)到一個(gè)未應(yīng)答來電
{"EVENT":"CALLSTATE","STATE":"6","STATEMSG":"未應(yīng)答","TELNO":"%s"}
STATE = 7 開始錄音
{"EVENT":"CALLSTATE","STATE":"7","STATEMSG":"開始錄音","VOCID":"錄音ID"}
STATE = 8 停止錄音
{"EVENT":"CALLSTATE","STATE":"8","STATEMSG":"停止錄音"}
STATE = 10 呼叫失敗
{"EVENT":"CALLSTATE","TELNO":"139222888","STATE":"10","STATEMSG":"此狀態(tài)不能呼叫"}
對(duì)于客服型調(diào)用CALLOUT方法時(shí)話機(jī)未摘機(jī)
實(shí)例：
teleAgent.onCallState (function (jsonData) {
//處理事件響應(yīng)的業(yè)務(wù)邏輯
});
DEMO
1.DEMO
TAServer為聯(lián)傲云座席客戶端服務(wù)程序，安裝后開機(jī)自動(dòng)運(yùn)行。聯(lián)傲云座席提供WebSocket開發(fā)接口，封裝了完整的方法和事件，可方便地在應(yīng)用系統(tǒng)中實(shí)現(xiàn)外呼、彈屏、錄音等應(yīng)用。
詳情請(qǐng)參見下載中心：電話助理外呼版Demo
