~~NOTOC~~

======呼转======

  * [[#呼叫转接/呼叫咨询对象|呼叫转接/呼叫咨询对象]]
  * [[#呼叫保持对象|呼叫保持对象]]
  * [[#呼叫保持恢复/呼叫咨询恢复对象|呼叫保持恢复/呼叫咨询恢复对象]]
包含以下接口：
  * [[#呼叫转接|呼叫转接]]
  * [[#呼叫保持|呼叫保持]]
  * [[#呼叫保持恢复|呼叫保持恢复]]
  * [[#呼叫咨询|呼叫咨询]]
  * [[#呼叫咨询恢复|呼叫咨询恢复]]


  
===== 数据结构说明 =====
==== 呼叫转接/呼叫咨询对象 ====

{| style="width:90%;"
! colspan="2"|属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|rowspan="14" style="vertical-align: middle;" | ivr
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|called
|String
|style="text-align:center;"|可选
|Client账号或PSTN账号
|-
|queueId
|String
|style="text-align:center;"|可选
|技能组ID，只能为数字，只能为数字，范围1--65535（不能和called同时为空）
|-
|fileName
|String
|style="text-align:center;"|可选
|放音文件名(已上传)，如果不传此参数，则播放默认的放音文件
|-
|data
|String
|style="text-align:center;"|可选
|用户透传数据
|}

----


<hidden JSON示例>
<code javascript>
{
    "ivr":{
           "appId":"247e35ff320a4142a105024055c367cf",
           "callId":"77a18fb0-bdde-11e5-b810-77c743ca5c3a",
           "called":"66052154258956",
           "fileName":"myvoice.wav",
           "data":""
    }
}</code>
</hidden>

----

<hidden XML示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ivr>
	<appId>247e35ff320a4142a105024055c367cf</appId>
        <callId>77a18fb0-bdde-11e5-b810-77c743ca5c3a</callId>
        <called>66052154258956</called>
        <fileName>myvoice.wav</fileName>
        <data></data>
</ivr></code>
</hidden>

----

==== 呼叫保持对象 ====

{| style="width:90%;"
! colspan="2"|属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|rowspan="14" style="vertical-align: middle;" | ivr
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|fileName
|String
|style="text-align:center;"|可选
|放音文件名称（已上传），如果不传此参数，则播放默认的放音文件
|-
|data
|String
|style="text-align:center;"|可选
|用户透传数据
|}

<hidden JSON示例>
<code javascript>
{
    "ivr":{
            "appId":"247e35ff320a4142a105024055c367cf",
            "callId":"77a18fb0-bdde-11e5-b810-77c743ca5c3a",
            "fileName":"myvoice.wav",
            "data":""
    }
}
</code>
</hidden>
----
<hidden XML示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ivr>
	<appId>247e35ff320a4142a105024055c367cf</appId>
        <callId>77a18fb0-bdde-11e5-b810-77c743ca5c3a</callId>
        <fileName>myvoice.wav</fileName>
        <data></data>
</ivr>
</code>
</hidden>
----
==== 呼叫保持恢复/呼叫咨询恢复对象 ====

{| style="width:90%;"
! colspan="2"|属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|rowspan="14" style="vertical-align: middle;" | ivr
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|data
|String
|style="text-align:center;"|可选
|用户透传数据
|}

<hidden JSON示例>
<code javascript>
{
    "ivr":{
          "appId":"247e35ff320a4142a105024055c367cf",
          "callId":"77a18fb0-bdde-11e5-b810-77c743ca5c3a",
          "data":""
    }
}
</code>
</hidden>
----
<hidden XML示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ivr>
      <appId>247e35ff320a4142a105024055c367cf</appId>
      <callId>77a18fb0-bdde-11e5-b810-77c743ca5c3a</callId>
      <data></data>
</ivr>
</code>
</hidden>

----
==== 一般响应对象 ====
{| style="width:90%;"
! colspan="3" | 属性
! 类型
!style="text-align:center;width:3em;"|约束
! 说明
|-
| rowspan="3" style="vertical-align: middle;"| resp
| colspan="2" |respCode
| String
|style="text-align:center;"|必选
|参见[[:呼叫中心:errorcode_ipcc| 响应码说明]]
|-
| rowspan="2" style="vertical-align: middle;"|ivr
|appId
|String
|style="text-align:center;"|必选
|应用ID
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|}

<hidden JSON示例>
<code javascript>
{
    "resp": {
        "respCode": "000000",
        "ivr": {
            "appId": "8230e48a30864a50a5ad5919d0b30dd1",
            "callId":"2015102614502300261CTI"
        }
    }
}
</code>
</hidden>

----
<hidden XML示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<resp>
    <respCode>000000</respCode>
    <ivr>
        <appId>8230e48a30864a50a5ad5919d0b30dd1</appId>
        <callId>2015102614502300261CTI</callId>
    </ivr>
</resp></code>
</hidden>

----

===== 接口说明 =====
==== 呼叫转接 ====
{| style="width:90%;" 
!功能
|呼叫转接-A坐席转接坐席B, 坐席B接听后会自动挂断A
|-
! | URL 
| %%https://api.ucpaas.com/{SoftVersion}/Accounts/{AccountSid}/ipcc/call/callTransfer?sig={SigParameter}%%
|-
! |Method
| POST
|-
! |Headers
|参考REST介绍中[[..rest_api介绍及接入#统一请求包头 | HTTP Headers ]]的说明
|-
! Body
| [[#呼叫转接/呼叫咨询对象|呼叫转接对象]]
|-
! Response
| [[#一般响应对象| 一般响应对象]]
|}





==== 呼叫保持 ====

{| style="width:90%;"
!功能
|将通话保持，用户侧听到保持音（用户已上传或者系统默认），通话可恢复
|-
! | URL 
|%%https://api.ucpaas.com/{SoftVersion}/Accounts/{AccountSid}/ipcc/call/callHold?sig={SigParameter}%%
|-
! |Method
| POST
|-
! |Headers
|参考REST介绍中[[..rest_api介绍及接入#统一请求包头 | HTTP Headers ]]的说明
|-
! Body
| [[#呼叫保持对象|呼叫保持对象]]
|-
! Response
| [[#一般响应对象| 一般响应对象]]
|}



==== 呼叫保持恢复 ====

{| style="width:90%;"
!功能
|恢复已保持的通话
|-
! | URL 
| %%https://api.ucpaas.com/{SoftVersion}/Accounts/{AccountSid}/ipcc/call/callHoldRescue?sig={SigParameter}%%
|-
! |Method
| POST
|-
! |Headers
|参考REST介绍中[[..rest_api介绍及接入#统一请求包头| HTTP Headers ]]的说明
|-
! Body
| [[#呼叫保持恢复/呼叫咨询恢复对象|会叫保持恢复对象]]
|-
! Response
| [[#一般响应对象| 一般响应对象]]
|}


==== 呼叫咨询 ====

{| style="width:90%;" 
!功能
|通话过程中，发起一路咨询通话，当前通话被保持，咨询结束后，可选择恢复当前通话
|-
! | URL 
| %%https://api.ucpaas.com/{SoftVersion}/Accounts/{AccountSid}/ipcc/call/callConsult?sig={SigParameter}%%
|-
! |Method
| POST
|-
! |Headers
|参考REST介绍中[[..rest_api介绍及接入#统一请求包头| HTTP Headers ]]的说明
|-
! Body
| [[#呼叫转接/呼叫咨询对象|呼叫咨询对象]]
|-
! Response
| [[#一般响应对象| 一般响应对象]]
|}

==== 呼叫咨询恢复 ====

{| style="width:90%;" 
!功能
|咨询结束后，恢复呼叫咨询的该路通话
|-
! | URL 
| %%https://api.ucpaas.com/{SoftVersion}/Accounts/{AccountSid}/ipcc/call/callConsultRescue?sig={SigParameter}%%
|-
! |Method
| POST
|-
! |Headers
|参考REST介绍中[[..rest_api介绍及接入#统一请求包头 | HTTP Headers ]]的说明
|-
! Body
| [[#呼叫保持恢复/呼叫咨询恢复对象|呼叫咨询恢复对象]]
|-
! Response
| [[#一般响应对象| 一般响应对象]]
|}