呼叫中心
智能化
营销协同
坐席状态与监控
分机置忙置闲接口
使用场景 对接系统向呼叫中心服务器发送HTTP请求，设置分机状态，用于网页等弹屏时在话务员录入客户信息时避免来电。 建议在弹屏时，调用该接口置忙当前话机，保存退出后调用该接口置闲话机。 实现流程 略 接口描述 分机在线状态设置接口完整URL：
http://x.x.x.x:12121/bridge/callctrl?extnum=801&state=busy&reason=LeaveSeat&opt=SET_EXT_PRESENCE_STATE
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| extnum | 呼叫中心分机号码 | 被设置状态的分机号 |
| state | 分机在线状态 | online: 在线正常接听来电, reducing:减少来电 busy:置忙 |
| reason | 原因 | 可选，用于配合对接系统出置忙原因显示使用 |
| opt | SET_EXT_PRESENCE_STATE | 默认不要修改 |
| x.x.x.x:12121 | 服务器IP通讯地址 | 12121默认端口，如果手动修改过端口号请使用修改后的端口 |
Http请求响应码解释：
- 200: 操作成功
- 400: 参数错误
- 404: 目标分机不存在
坐席状态监控接口
使用场景 利用该接口，可每隔2秒调用一次，用于监控坐席的通话状态。基于该接口可以实时获取到各个坐席的实时通话信息。可用于后续监控功能的开发。 实现流程 略 接口描述 外呼接口完整URL：
http://127.0.0.1:12121/bridge/jsoncfg?opt=EXTNUM_MONITOR&json=%7B%22starttime%22:%222008-06-02%2000:00:00%22,%22assisLogId%22:%22logind001%22,%22avoidCallPerform%22:1,%22extnums%22:%5B%22801%22,%223003%22%5D%7D
Json参数原格式如下：
{"starttime":"2008-06-02 00:00:00","assisLogId":"logind001","avoidCallPerform":1,"extnums":["801","3003"]}
查询参数：
| 参数名称 | 字段含义 | 描述 |
|---|---|---|
| json | 是一段经过URL编码的json格式数 | starttime: 统计起始时间注意格式2008-06-02%2000:00:00 注意：中间有个"%20"字符是空格编码 assisLogId: 登录账户，如果没有可随机填生成一个全局唯一的值，后续的刷新请求请保证assisLogId值不要变 avoidCallPerform: 0：统计相关坐席绩效（初始查询需要较长时间，请注意不要刷新太快导致系统卡顿影响通话。） 1：不统计（高性能） extnums：传入分机号，或者分组号码，不传入分机或分组号码，则获取所有分机状态 |
返回结果：
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| extnum | 分机号码 | |
| assisname | 当前坐席姓名 | |
| worknum | 使用接口设置的工号 | 参考：HTTP工号设置接口 |
| telRegState | 分机注册状态 | 0：未注册 1：已注册 |
| phoneType | 终端类型 | 不同类型的终端设备，此处值不一样 |
| state | 话机通话状态 | IDEL:空闲，BUSY_OUTGOING:外呼通话中，BUSY_INCOMING:接听来电通话中，OFFLINE：离线 |
| presence | 坐席手动设置的线状态 | Online: 在线， offline:离线，reducing:减少来电，busy：置忙，unkown:状态未知 |
| presencereason | 最近一次设置状态的原因 | 自由设置，配合对接业务使用，对呼叫中心没有实际意义 |
| remoteNum | 通话中客户号码 | 可选，没有通话时该字段不存在 |
| pickupTime | 接听时间 | 时:分:秒 |
| pickupDuration | 接听时常 | 单位: 秒 |
| x.x.x.x:12121 | 服务器IP通讯地址 | 12121默认端口，如果手动修改过端口号请使用修改后的端口 |
查询返回实例：
[{"assisname":"小张","extnumname":"分机6","worknum":"013","extnum":"806","department":"分机6","telRegState":1,"phoneType":"NewRock_NRP1000_2.3.1654.528","remoteNum":"15875566080","pickupTime":"17:49:00","pickupDuration":"8","state":"BUSY_INCOMING","presence":"online","presencereason":"","missingCallCount":0,"outgoingCallCount":0,"incomingCallCount":0,"incomingMissedCount":0,"complaintCount":0,"total":0}]
可实现如下效果：
通话监听接口
使用场景 坐席通话中，可利用此接口监听坐席的通话。该监听接口是一个触发接口，需要有主管分机配合使用。 实现流程
接口描述 完整URL：
http://x.x.x.x:12121/bridge/callctrl?leaderExtnum=803&wokerExtnum=801&opt=CALL_MONITOR
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| leaderExtnum | 主管的分机号码 | 参与监听主管的分机号码，用于收听坐席与客户之间的通话 |
| wokerExtnum | 被监听的分机号码 | |
| opt | CALL_MONITOR | 默认不要修改 |
| x.x.x.x:12121 | 服务器IP通讯地址 | 12121默认端口，如果手动修改过端口号请使用修改后的端口 |
Http请求响应码解释：
- 200: 操作成功
- 403: 主管分机权限不足。到后台分机管理中修改分机权限添加"坐席监控"
- 404: 被监听分机没有在通话
- 503: 系统资源不足
通话强插接口
使用场景
坐席通话中，主管坐席可利用此接口强插通话，直接替代坐席与客户进行沟通。该接口是一个触发接口，需要有主管分机配合使用。接口既可以强插坐席接听的电话，也可以操作外呼的电话。
实现流程
接口描述
完整URL：
http://x.x.x.x:12121/bridge/callctrl?leaderExtnum=803&wokerExtnum=801&opt=FORCE_PICKUP
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| leaderExtnum | 主管的分机号码 | 用于替代当前坐席与客户继续通话 |
| wokerExtnum | 被强插的分机号码 | |
| opt | FORCE_PICKUP | 默认不要修改 |
| x.x.x.x:12121 | 服务器IP通讯地址 | 12121默认端口，如果手动修改过端口号请使用修改后的端口 |
Http请求响应码解释：
- 200: 操作成功
- 403: 主管分机权限不足。到后台分机管理中修改分机权限添加"坐席监控"
- 404: 没有找到可强插的通话
- 503: 系统资源不足
通话强拆接口
使用场景
坐席通话中，主管坐席可利用此接口挂断坐席与客户的通话。
实现流程
接口描述
完整URL：
http://x.x.x.x:12121/bridge/callctrl?leaderExtnum=803&wokerExtnum=801&opt=FORCE_HUNGUP
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| leaderExtnum | 主管的分机号码 | 用于权限控制 |
| wokerExtnum | 被强拆的分机号码 | |
| opt | FORCE_HUNGUP | 默认不要修改 |
| x.x.x.x:12121 | 服务器IP通讯地址 | 12121默认端口，如果手动修改过端口号请使用修改后的端口 |
Http请求响应码解释：
- 200: 操作成功
- 403: 主管分机权限不足。到后台分机管理中修改分机权限添加"坐席监控"
- 404: 没有找到可强拆的通话
- 503: 系统资源不足