释放指定号码连接
前置条件
- 座席已签入。
- 座席有正在通话中的呼叫。
场景描述
座席释放指定电话号码的连接,一般用于内部求助和三方通话。
可以挂断在最后一通通话中的号码,例如:两方求助,用户保持中,挂断用户是会报错200-204(目前保持这种处理),是因为保持的用户不包含在最后一通callid中,如果是外呼+保持的场景,挂断保持中用户,是可以正常挂断的,因为保持的用户是最后一通通话callid。
接口方法
设置成“POST”。该接口仅支持POST方法,不支持PUT、GET和DELETE等方法。
接口URI
https://ip:port/agentgateway/resource/voicecall/{agentid}/disconnect/{number}
其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。
序号 |
参数名 |
数据类型 |
选取原则 |
说明 |
---|---|---|---|---|
1 |
agentid |
string |
True |
座席的工号,取值范围:101~59999。 |
2 |
number |
string |
True |
待释放的电话号码,取值范围:1-24位数字。 内部求助时,座席操作挂断被求助座席{number}为座席工号,挂断座席本身{number}为该座席的软电话号码。被求助方只可主动挂断自己,不允许操作座席和用户。 |
日志中的方法名
disconnect
请求说明
- 消息头
表2 请求头参数说明 序号
名称
参数类型
是否必选
说明
1
Content-Type
string
True
消息主体编码方式,缺省值:application/json; charset=UTF-8
2
Guid
string
True
静态鉴权(AUTHMODE = 1)签入接口返回的Guid;动态鉴权(AUTHMODE = 2)轮询事件接口返回的Guid。
- 消息体
无
响应说明
序号 |
名称 |
参数类型 |
说明 |
---|---|---|---|
1 |
message |
string |
描述 |
2 |
retcode |
string |
错误码。取值如下: 0:成功 非0:失败 |
3 |
result |
object |
预留字段 |
触发事件
- 座席退出呼叫(AgentEvent_Call_Release)
- 客户退出呼叫(AgentEvent_Customer_Release)
错误结果码
- 100-006
- 100-007
- 200-023
- 200-024
报文样例
- 消息头
Content-Type:application/json; charset=UTF-8 Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
- 请求参数
无
- 响应参数
{ "result": {}, "message": "success", "retcode": "0" }