### **坐席服务控制** ~~~ instance.agentServiceCtrl({ ctrlCode:xxxx, strJson:xxxx, done: onServiceCtrlDone, onAgentStatusChanged: onAgentStatusChanged, onAgentServiceInfoNotify: onAgentServiceInfoNotify }); ~~~ **接口说明** 坐席服务状态变化时调用 **返回值** 0表示成功，其他表示错误代号 **接口参数简介** | 名称 | 类型 | 说明 | 是否必须 | | --- | --- | --- | --- | | ctrlCode | number | 坐席操作（0--开始服务, 1--结束服务, 2--暂停服务,3--转移下一个坐席） | 是 | | strJson| object| 坐席状态控制拓展参数 | 否 | | done | function | 坐席状态操作结果通知回调 | 是 | | onAgentStatusChanged | function | 坐席状态变化通知回调 | 是 | | onAgentServiceInfoNotify | function | 坐席服务信息变化通知回调 | 是 | **回调说明** | 名称 | 参数说明 | 接口说明 | 备注 | | --- | --- | --- | --- | | onServiceCtrlDone | result(执行结果) | 坐席状态操作结果通知回调 |result.code 0表示成功，其他表示错误代号<br>result.msg 结果描述<br> | | onAgentStatusChanged | data(返回数据)| 坐席状态变化通知回调 | data.status 坐席状态（0--关闭，不对外提供服务<br>1--等待中，可随时接受用户服务<br>2--工作中，正在为用户服务<br>3--暂停服务）<br> | | onAgentServiceInfoNotify | data(返回数据) | 坐席服务信息变化通知回调 |data.serviceBeginTime 当前服务的开始时间<br> data.serviceTotalTime 服务累计时间<br>data.serviceUserCount 累计服务的用户数<br> | **示例代码** ~~~ // 坐席状态变化通知 function onAgentStatusChanged(event) { //result.status: //0--关闭，不对外提供服务, //1--等待中，可随时接受用户服务, //2--工作中，正在为用户服务 //3--暂停服务 }; ~~~ ~~~ // 坐席服务信息 function onAgentServiceInfoNotify(event){ //event.serviceBeginTime 当前服务的开始时间 //event.serviceTotalTime 服务累计时间 //event.serviceUserCount 累计服务的用户数 } ~~~ ~~~ // 主动查询坐席服务状态数据 var result = instance.getAgentStatus(); //result.serviceBeginTime 当前服务的开始时间 //result.serviceTotalTime 服务累计时间 //result.serviceUserCount 累计服务的用户数 ~~~