# 呼叫转移 #### 前置条件 - 座席已签入 - 座席有正在通话中的语音呼叫 - 呼出在转外呼号码时（Devicetype为5）不支持释放转。 - 呼入进行释放转时，由于送的是原始主叫号码，可能被运营商限制呼出，导致转移失败。 #### 场景描述 座席对已经建立的通话进行呼叫转移。 ![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png) 视频呼叫暂不支持以下场景： 通过释放转的方式转移至外部号码 #### 接口方法 设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。 #### 接口URI https://ip:port/agentgateway/resource/voicecall/{agentid}/transfer ![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png) 如果CC-Gateway单机部署，IP地址为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号，默认值为8043；如果CC-Gateway采用集群模式部署，IP请配置为NSLB地址， Port请配置为默认值8043。 NSLB上的CC-Gateway端口号，请以nslb用户登录任意一个NSLB节点，执行./nslbctl l查询，查询结果中，如下端口表示CC-Gateway通过NSLB面向第三方系统开放的端口。 ![](https://support.huaweicloud.com/api-ccfs-cec/figure/zh-cn_image_0000002204207349.png) SaaS场景下请咨询运维人员获取IP和Port。 表1URI中携带的参数说明 | 序号 | 参数名 | 数据类型 | 选取原则 | 说明 | |:---|:---|:---|:---|:---| | 1 | agentid | string | True | 座席的工号，取值范围：101～999999。 | #### 日志中的方法名 transfer #### 请求说明 - 消息头 表2请求头参数说明 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | Content-Type | string | True | 消息主体编码方式，缺省值：application/json;charset=UTF-8 | | 2 | Guid | string | True | 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 | - 消息体 表3消息体参数说明 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | devicetype | int | True | 转移设备类型，技能队列为1，业务代表为2，IVR设备为3，系统接入码为4，外呼号码为5。 | | 2 | address | string | True | 转移地址，最大长度24。取值范围： - 当devicetype为1时，配置技能队列的编号ID，只允许配置数字。 - 当devicetype为2时，配置待转移座席的座席工号，只允许配置数字。 - 当devicetype为3时，配置IVR流程接入码，只允许配置数字。 - 当devicetype为4时，配置系统接入码，只允许配置数字。 - 当devicetype为5时，配置外呼号码，允许配置范围：0\~9、A\~E、a\~e、\*、#。 | | 3 | mode | int | True | 转移模式。 当devicetype值为1时取值： 0：释放转 2：成功转 当devicetype值为2时取值： 0：释放转 2：成功转 3：指定转（转移到座席的私有技能队列：暂时转移方式不对外开放） 当devicetype值为3时取值： 0：释放转 1：挂起转 说明： 挂起转可以转音视频IVR流程，不能转座席。 当devicetype值为4时取值： 0：释放转 2：成功转 当devicetype值为5时取值： 1：释放转（呼出时不支持向指定外呼号码释放转） 2：成功转 3：通话转 4：三方转 | | 4 | callappdata | string | False | 需设置的随路数据。内容可为空，最大长度为16k。 说明： 转外呼号码时，不支持设置随路数据。 | | 5 | caller | string | False | 主叫号码。（内容可为空，为空时为平台默认主叫号码，0-24位数字）。在转外部号码时有效。并且当转出方式为"释放转"时，该参数值无效，即不能携带指定的主叫号码。 | | 6 | mediaability | int | False | 媒体能力。（默认为0。0：音频，1：视频，2：以最大能力呼叫，由主机与终端进行协商。在转外部号码时有效，其他方式的转移根据座席的类型来判断是否带媒体能力） | | 7 | holdflag | boolean | False | 三方转时是否保持呼叫，取值为false时不保持，true为保持，默认为true | | 8 | skillId | Integer | 可选 | 技能ID。当devicetype为业务代表为2时，设置该字段才有效。 | #### 响应说明 表4消息体参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 1 | message | string | 描述 | | 2 | retcode | string | 错误码。取值如下： 0：成功 非0：失败 | | 3 | result | object | 预留字段 | #### 触发事件 - 对方振铃（AgentEvent_Customer_Alerting） - 座席进入（AgentEvent_Talking） - 连接失败（AgentEvent_Connect_Fail） - 座席挂断呼叫（AgentEvent_Call_Release） - 转移模式为成功转时： 成功转结果通知（AgentEvent_SuccTransResult） 停止录音成功（AgentMediaEvent_StopRecordDone） - 转移模式为三方转时： 三方通话成功（AgentEvent_Conference） - 转移模式为挂起转 从IVR返回（AgentEvent_ReturnFromIvr） #### 错误结果码 - 000-002 - 100-006 - 100-007 - 200-012 #### 报文样例 - 消息头 ``` Content-Type:application/json;charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 ``` - 请求参数 ``` { "devicetype": 2, "mode": 3, "address": "49998", "callappdata": "", "caller": "40040", "mediaability": 0, "holdflag": "true" } ``` - 响应参数 ``` { "result": {}, "message": "success", "retcode": "0" } ```