-
接口URI https://ip:port/agentgateway/resource/voicecall/{agentid}/transfer 其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。
-
报文样例 消息头 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"
}
-
触发事件 对方振铃（AgentEvent_Customer_Alerting） 座席进入（AgentEvent_Talking） 连接失败（AgentEvent_Connect_Fail） 座席挂断呼叫（AgentEvent_Call_Release） 转移模式为成功转时： 成功转结果通知（AgentEvent_SuccTransResult） 停止录音成功（AgentMediaEvent_StopRecordDone） 转移模式为三方转时： 三方通话成功（AgentEvent_Conference） 转移模式为挂起转 从IVR返回（AgentEvent_ReturnFromIvr）
-
请求说明 消息头 表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时，设置该字段才有效。
-
报文样例 请求头: Content-Type:application/jsonX-APP-KEY:*********************Authorization:Bearer ********************* 请求参数: {"workNo":107} 响应参数: { "returnCode": "0", "data": false, "description": "success"}
-
请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-KEY string False appKey字段，用户标识，请联系运营人员获取appKey 2 Authorization string True 鉴权信息，值为Bearer + tokenByAKSK接口的返回值中的AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 workNo number True 座席工号
-
响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 returnCode string True 操作结果。0：成功，非0为失败 1.2 description string False 提示信息 1.3 data boolean False 是否是手机接听（true：是，false：否） 响应状态码: 401 鉴权失败 响应状态码: 404 请求资源不存在 响应状态码: 500 服务器内部异常
