中通天鸿对接快速入门

安装

当前支持通过<script>标签和npm模块两种方式来加载Wincall sdk，{version}表示版本号

npm安装方式

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	可选	指定主叫列表 选取的对象必须是在默认主叫列表中本身就存在的对象。例： callNums:[{name:'01058545832',value:'01058545832'}]
default_caller	String	String	指定默认的主叫 值是主叫对象展示的name。
autoCall	Boolean	可选	自动外呼功能 特定场景使用，会先呼入后台导入的指定号码，呼叫成功后再给坐席来电。