挂断呼叫
前置条件
- 座席已签入
 - 座席有正在通话中的呼叫
 
场景描述
座席对正在通话中的呼叫进行挂断操作,只支持挂断当前通话,需要指定 callid 参考拆除指定callid呼叫。
接口方法
设置成“DELETE”。该接口仅支持DELETE方法,不支持PUT、POST和GET等方法。
接口URI
1.https://ip:port/agentgateway/resource/voicecall/{agentid}/release
2.https://ip:port/agentgateway/resource/voicecall/{agentid}
 
   第2个接口为了兼容老版本提供,不推荐使用该接口。
其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。
| 
        序号  | 
      
        参数名  | 
      
        数据类型  | 
      
        选取原则  | 
      
        说明  | 
     
|---|---|---|---|---|
| 
        1  | 
      
        agentid  | 
      
        string  | 
      
        True  | 
      
        座席的工号,取值范围:101~59999。  | 
     
日志中的方法名
1.https://ip:port/agentgateway/resource/voicecall/{agentid}/release 对应的方法名为:release
2.https://ip:port/agentgateway/resource/voicecall/{agentid} 对应的方法名为:releaseEx
请求说明
- 消息头 
    
表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-017
 
报文样例
- 消息头
    
Content-Type:application/json; charset=UTF-8 Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
 - 请求参数
    
无
 - 响应参数
    
{ "result": {}, "message": "success", "retcode": "0" }