坐席操作
签入
CTI.Agent.login(params,callback)
参数对象params
| 参数 | 类型 | 可选 | 描述 |
|---|
| bindTel | String | 必选 | 绑定电话 |
| loginType | Int | 可选 | 签入模式类型 取值1.动态模式，2静态模式，默认为动态模式 |
| state | Int | 可选 | 签入状态 取值1.置闲，2置忙，默认为置闲 |
| notReadyReason | Int | 可选 | 置忙原因 |
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
签出
CTI.Agent.logout(params,callback)
参数对象params
| 参数 | 类型 | 可选 | 描述 |
|---|
| logoutType | Int | 可选 | 签出类型 枚举值 1 : 完全退出 2：仅退出动态模式（默认） |
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
置闲
CTI.Agent.ready(callback)
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
置忙
CTI.Agent.unready(params,callback)
参数对象params
| 参数 | 类型 | 可选 | 描述 |
|---|
| reason | Int | 可选 | 置忙类型 取值说明：置忙原因id，可以通过CTI.Info.getBusyReason获得 |
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
外呼
CTI.Agent.callOut(params,callback)
参数对象params
| 参数 | 类型 | 可选 | 描述 |
|---|
| agPho | string | 可选 | 坐席分机 |
| tel | String | 必选 | 外呼号码。支持编码，例如base64格式:B64:+ 具体base64编码的电话号码 |
| callerID | String | 可选 | 客户侧外显号码 |
| agCallerID | String | 可选 | 坐席侧显示号码 |
| encryption | int | 可选 | 0不加密，1加密，默认0 |
| queueId | int | 可选 | 呼出所属技能组 |
| userData | String | 可选 | 自定义字段 json格式字符串,传入的值会打入通道变量,格式：json字符串{"key":"value"} |
如果需要加密，即 encryption 设置为 1 时，请先到管理后台配置具体的加密算法（目前仅支持 ECB 类型加密方式，包括 AES-ECB 类型）和秘钥。
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
呼叫坐席
CTI.Agent.callInner(params,callback)
参数对象params
| 参数 | 类型 | 可选 | 描述 |
|---|
| calledAgNo | String | 必选 | 被叫坐席工号 |
| callerID | String | 可选 | 主叫号码（中继号） |
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
修改绑定电话
CTI.Agent.changeBindTel(params,callback)
参数对象params
| 参数 | 类型 | 可选 | 描述 |
|---|
| bindTel | String | 必选 | 绑定电话 |
| isWebrtc | Boolean | 可选 | 切换的电话是否使用webrtc |
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
*isWebrtc属性会在切换号码时，自动维护当前webrtc状态（注销、重新注册）。如果不加上该参数，默认是不会做任何webrtc处理操作的。
获取主叫列表
CTI.Agent.getCallList(callback)
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码（0为成功，其他为失败，具体失败原因见message） |
| message | string | 返回结果描述 |
| data | object | 主叫列表信息 |
响应结果示例
{
"code": 0,
"message": "成功",
"data": {
"num": [
{
"name": "自动选择",
"value": "",
"type": "auto"
},
{
"name": "呼入号码组",
"value": "g:132",
"type": "group"
},
{
"name": "01012345678",
"value": "01012345678",
"type": "phone"
}
]
}
}
进入自动外呼
CTI.Agent.agentAtIn(params,callback)
参数对象params
| 参数 | 类型 | 可选 | 描述 |
|---|
| agNo | String | 必选 | 座席工号（取值3-20位数字或字母） |
| proID | int | 必选 |
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
退出自动外呼
CTI.Agent.agentAtOut(params,callback)
参数对象params
| 参数 | 类型 | 可选 | 描述 |
|---|
| agNo | String | 必选 | 座席工号（取值3-20位数字或字母） |
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
获取坐席项目列表
CTI.Agent.getPro(params,callback)
参数对象params
| 参数 | 类型 | 可选 | 描述 |
|---|
| agNo | String | 必选 | 座席工号（取值3-20位数字或字母） |
返回字段说明
| 参数 | 类型 | 说明 |
|---|
| code | int | 结果码 |
| message | string | 返回结果描述 |
响应结果示例
{
"code": 0,
"message": "成功",
"data": [
{
"pro_id": "620",
"pro_name": "预测试外呼",
"pro_state": "1"
}
]
}
结果说明
根据收到的结果，将data中的num数组作为下拉选择的项来显示即可，name为显示的值，value为外呼时传递的主叫号码的值，type为类型说明，说明如下
- auto-自动选择：自动选择为一个固定值，外呼时传递的主叫号码为空，这样后端将在分配给企业的号码列表中随机选择一个号码
- group-号码组：号码组为在后台配置的号码组，一个号码组可以包含多个号码，如果外呼时传递的主叫为号码组的话，那么会从该号码组中随机选择一个号码来外呼
- phone-中继号码：phone为实际的中继号码，外呼时直接传递即可
