联傲云电话录音外呼系统二次开发
首页>联傲云电话录音外呼系统二次开发>概述
1.概述
TAServer为联傲云座席客户端服务程序，安装后开机自动运行。联傲云座席提供WebSocket开发接口，封装了完整的方法和事件，可方便地在应用系统中实现外呼、弹屏、录音等应用。
联傲电讯已将接口再次封装成teleAgent.js对象,集成商在项目中引用teleAgent.js对象就可以。
话务员直接使用企业CRM或定制的应用，实现软件外呼，来电弹屏，通话录音功能。
teleAgent.js接口
1.方法
1. Connect ( Socket_port)
功能：连接联傲云座席服务
参数：Socket_port： WebSocket 服务端口。
注意：每个座席只允许连接一个客户端。如果已有一个客户端连接，则不允许其它的客户端连接。
2. Disconnect
功能：断开联傲云座席服务
3. Login (CompanyAccount, AgentNo, Password,)
功能：连接并登陆账号
参数：CompanyAccount： 该企业在联傲云注册的企业账号 AgentNo： 用户在联傲云的账号 Password： 用户在联傲云的密码
说明：业务系统和联傲云各自有自己的账号体系，业务方要建立一个业务系统账号到联傲云账号的映射表，例如某用户在业务系统中的账号密码是：张三、123, 对应在联傲云的账号密码是：李四、456；企业账号的：ABC.
系统集成完成后，用户打开业务系统，在业务系统中用：张三、123 完成登录验证，然后调用Login接口用：ABC、李四、456 向联傲云完成座席登录.
4. Logout
功能：话务员签出
5. DoAction(action, param)
功能：通讯控制功能。
参数： action 指具体要使用的功能名，大写字符串表示，参见下表
|
action |
Param |
|
呼叫 ‘CALLOUT’ |
呼叫的目标号码 |
|
功能：软件呼叫。 示例: teleAgent.DoAction(‘CALLOUT’,’13912345678’) 应用：点击呼叫、自动呼叫。 注意： 采用TA01T 型电话盒：无需摘起话机，可以直接调用此方法呼叫。 采用TA01R/M 型电话盒：必须摘机后才可以掉用此方法呼叫. |
|
|
发码‘SENDDTMF’ |
DTMF码 |
|
功能：效果相当于手动按电话机按键 示例：teleAgent.DoAction(‘SENDDTMF’,’1’) 应用：例如软件呼叫对方接通的是呼叫中心或总机，需要二次按键，则可以用此方法模拟手拨按键。 |
|
|
摘机‘OFFHOOK’ |
|
|
功能：软件摘机 示例： teleAgent.DoAction(‘OFFHOOK’) 应用：例如客户来电，用此方法实现软件接听。 注意：仅对 TA01R/M 型电话盒有效。 |
|
|
挂机‘ONHOOK’ |
|
|
功能：软件挂机 示例：teleAgent.DoAction(‘ONOOK’) 应用：例如通话结束，用此方法实现软件挂机。 注意：仅对 TA01R/M 型电话盒有效。 |
|
2.事件
teleAgent.js 封装了各种状态事件，以JSON回传详细信息，参见以下说明：
2.2.1 OnWSConnectState (jsonData)
功能： WebSocket服务连接状态事件。
jsonData: {conState: "open"}
conState: open为连接成功，Error为出现错误，close为连接关闭。
实例：
teleAgent. OnWSConnectState(function (jsonData) {
//处理事件响应的业务逻辑，
}
实例：
teleAgent. OnWSConnectState(function (jsonData) {
//处理事件响应的业务逻辑，
}
2.2.2 onDeviceState (jsonData)
功能： 话务设备状态事件
jsonData:
{"EVENT":" DEVICE",“DEVTYPE”:”设备类型”,"DEVSTATE":"设备状态 ","DEVINFO":"状态描述 "，“PHONESTATE”:”话机状态”}
DEVTYPE: 3 录音型.
2 外呼型
4 混合型
DEVSTATE ： -1 故障
0 正常初始化
1 OK
2 告警
PHONESTATE: --- 话机状态 --- 对应主要信息
ST_INITDEV = 0; 初始化中
ST_IDLE = 1; 挂机
ST_CHEDKDIALTONE = 2; 摘机准备呼出
ST_PRECALL = 3; // 检测是否预拨号 内线话机摘机准备拨号
ST_CALLOUT = 4; // 已区分了拨叫内线或外线 摘机呼出
ST_RING = 5; 振铃
ST_TALK = 6; 通话
ST_DISCONNECT = 7; 电话线断开
实例：
teleAgent.onDeviceState(function (data) {
//处理事件响应的业务逻辑
});
2.2.3 onLoginState(jsonData)
功能： 联傲云座席登录状态事件
jsonData:
{"EVENT":" LOGINSTATE ","COMPANY":"企业账号","USER":"用户账号","ERRCODE":"状态码","ERRMSG":"描述"}
ERRCODE: 1000 表示登录成功。其它值表示登录失败，原因参见ERRMSG描述。
实例：
teleAgent.onLoginState(function (jsonData) {
//处理事件响应的业务逻辑
});
2.2.4 onCallState(jsonData)
功能： 呼叫状态事件
修改： 所有呼叫相关事件均添加了 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":"来电号码","RINGCOUNT":"振铃计数"}
说明：RINGCOUNT=1表示是一次新的来电。
STATE = 3 收到按键
{"EVENT":"CALLSTATE","STATE":"3","STATEMSG":"按键","DTMF":"%s"}
STATE = 4 摘机
{"EVENT":"CALLSTATE","STATE":"4","STATEMSG":"摘机"}
STATE = 5 挂机
{"EVENT":"CALLSTATE","STATE":"5","STATEMSG":"挂机"}
STATE = 6 监测到一个未应答来电
{"EVENT":"CALLSTATE","STATE":"6","STATEMSG":"未应答","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":"此状态不能呼叫"}
对于客服型调用CALLOUT方法时话机未摘机
实例：
teleAgent.onCallState (function (jsonData) {
//处理事件响应的业务逻辑
});
DEMO
1.DEMO
TAServer为联傲云座席客户端服务程序，安装后开机自动运行。联傲云座席提供WebSocket开发接口，封装了完整的方法和事件，可方便地在应用系统中实现外呼、弹屏、录音等应用。
详情请参见下载列表：电话助理外呼版Demo
