✎ zh:二次开发者指南:接口开发手册_v2.0:webservice接口:挂断接口 [asterCC, hosted call center solution based asterisk]

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。

====== 挂断接口 ======

  * 接口原型:
<code>hangup(uniqueid,targetagent,target,pwdtype,password,usertype,user,orgidentity)</code>
  * 作用说明:
在当前通话状态时完成挂断动作
  * 参数说明:

^ 参数名称      ^ 类型       ^ 描述信息          ^
|uniqueid|String|要挂断通话的uniqueid列表，多个uniqueid以逗号分割。非必填项，可以为空。必填情况请参照target参数。|
|targetagent|String|目标坐席工号，要操作哪个坐席的通话。uniqueid为空时，此项必填。uniqueid不为空时，此项可为空。如果挂断监听，强插，密语中的坐席组长(target=groupadmin)，此处需要填写被监听，强插，密语的坐席工号。如2227组长监听1986，欲挂断2227，此处需要填写1986。
|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|团队唯一标识|



  * 返回结果：

<code>
|Return|code|Return|message
</code>

  * 返回值类型:String
  * 返回值：

^ 返回值      ^ 描述信息       ^
|<code>|Return|1|Return|message</code>|<code>|Return|成功|Return|信息描述
当uniqueid不为空时，message为每个uniqueid执行挂断的结果，举例
|Return|1|Return|4781:success,4782:failed
success代表挂断成功
failed代表挂断失败
</code>|
|<code>|Return|2|Return|message</code> |	<code>|Return|失败|Return|信息描述</code>|