安装
当前支持通过<script>标签和npm模块两种方式来加载Wincall sdk,{version}表示版本号
npm install cti-js-sdk
脚本引入方式latest始终指向使用最新版本,可以通过这种方式获取最新版本
<script type="text/javascript" src="//ctiplus-js.icsoc.net/wincall/v2/wincall-latest.js"></script>
初始化
库加载后,会在全局注入一个对象window.CTIPlus,通过CTIPlus构造函数可以获得一个CTIPlus实例对象。
var cti = new CTIPlus(paramObj)
paramObj是一个参数对象,例如:{ws:false,webrtc:false,debug:false} 使用ui版本需要设置renderHtml属性
参数 | 类型 | 默认 | 可选 | 描述 |
---|---|---|---|---|
token | String | - | 必填 | 用户中心token |
agentPhone | String | _ | 必填 | 软电话号码 |
agNo | string | - | 必填 | 坐席工号 |
webrtc | Boolean | true | 可选 | 是否使用webrtc |
renderHtml | Object | _ | 可选 | 是否带ui渲染 |
initWithLogin | Boolean | false | 可选 | 初始化会自动签入,在没有renderHtml配置的情况下才生效,传true会在init的时候调用login方法签入 |
autoForceLogin | Boolean | false | 可选 | 在其他地方登录时,直接签入不会提示已在别地儿签入 |
websocket | Boolean | true | 可选 | 是否使用websocket |
debug | Boolean | false | 可选 | 是否使用debug |
busy | Boolean | false | 可选 | 登录后默认闲忙 |
check | Boolean | false | 可选 | 是否带上监控检测功能 |
sipUri | String | _ | 可选 | sip的uri地址(非单独部署项目不用关心) |
sipWsServer | String | _ | 可选 | sip服务的完整地址(带端口)(非单独部署项目不用关心) |
autoQueue | Boolean | false | 可选 | 外呼是否自动添加技能组 |
tokenCallBack | Function | _ | 可选 | token过期时的回调 |
tokenCallBackTime | Number | 30*60*1000 | 可选 | 过期前提前多久回调,默认30分钟,单位为毫秒 |
wsReconnectTime | Number | 3*60*60*1000 | 可选 | 坐席已经正常签入成功的状态下,ws断线尝试重连的最大时间(在该时间内ws会一直进行重连,超过该时间后则不进行重连),默认配置3小时,配置为0则不重连,即断线后SDK不会主动进行重连,单位为毫秒 |
renderHtml对象属性说明
属性 | 类型 | 默认值 | 作用 |
domId | String | "PHONE_BAR" | 指定页面上渲染电话条的dom元素id值 |
themeColor | String | "#485566" | 指定电话条的颜色 |
prefix | String | "phone_bar" | 电话条内部用来绑定事件的dom元素的id前缀。当电话条事件与页面其他事件产生冲突时,你需要设置该值。 |
autoLogin | Boolean | true | 调用init方法初始化电话条时,是否需要同时自动签入电话。 *如果设置了该参数,你可能需要在浏览器本地维护这个值,从而可以根据业务需求决定页面刷新再次初始化时是否需要电话签入 |
callNums | Array | 可选 | 指定主叫列表 选取的对象必须是在默认主叫列表中本身就存在的对象。例: |
default_caller | String | String | 指定默认的主叫 值是主叫对象展示的name。 |
autoCall | Boolean | 可选 | 自动外呼功能 特定场景使用,会先呼入后台导入的指定号码,呼叫成功后再给坐席来电。 |