en
zh这是本文档旧的修订版！
挂断接口
- 接口原型:
hangup(uniqueid,targetagent,target,pwdtype,password,usertype,user,orgidentity)
- 作用说明:
在当前通话状态时完成挂断动作
- 参数说明:
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
| uniqueid | String | 要挂断通话的uniqueid列表，多个uniqueid以逗号分割。非必填项，可以为空。必填情况请参照target参数。 |
| targetagent | String | |
| target | String | 挂机对象(channel,agent,caller,consult,all),channel必须传uniqueid，挂断相应uniqueid的通话,agent挂断目标坐席通话,caller挂断客户,consult如果传了uniqueid 则只挂uniqueid 相应的咨询方，如果没传，就按从旧到新的顺序挂断所有咨询方的通话,all挂断目标坐席相关所有通话，如果被监听，强插，同时挂断组长通话,groupadmin当目标坐席被监听，强插，密语时，用于挂断组长的通话，即结束组长的监听，强插，密语状态。 |
| pwdtype | String | 密码类型 明文(plaintext) / MD5加密(md5) |
| password | String | 密码 |
| usertype | String | agent(坐席) / account(帐号) |
| user | String | 坐席工号 / 用户名 |
| orgidentity | String | 团队唯一标识 |
- 返回结果：
|Return|code|Return|message
- 返回值类型:String
- 返回值：
| 返回值 | 描述信息 |
|---|---|
|Return|1|Return|message | |Return|成功|Return|信息描述 当uniqueid不为空时，message为每个uniqueid执行挂断的结果，举例 |Return|1|Return|4781:success,4782:failed success代表挂断成功 failed代表挂断失败 |
|Return|2|Return|message | |Return|失败|Return|信息描述 |
