更新时间:2023-09-27 GMT+08:00

呼叫转移

前置条件

  • 座席已签入
  • 座席有正在通话中的语音呼叫
  • 呼出在转外呼号码时(Devicetype为5)不支持释放转。
  • 呼入进行释放转时,由于送的是原始主叫号码,可能被运营商限制呼出,导致转移失败。

场景描述

座席对已经建立的通话进行呼叫转移。

视频呼叫暂不支持以下场景:

通过释放转的方式转移至外部号码

接口方法

设置成“POST”。该接口仅支持POST方法,不支持PUT、GET和DELETE等方法。

接口URI

https://ip:port/agentgateway/resource/voicecall/{agentid}/transfer

其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。

表1 URI中携带的参数说明

序号

参数名

数据类型

选取原则

说明

1

agentid

string

True

座席的工号,取值范围:101~59999。

日志中的方法名

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时,配置外呼号码。

    3

    mode

    int

    True

    转移模式。

    当devicetype值为1时取值:

    0:释放转

    2:成功转

    当devicetype值为2时取值:

    0:释放转

    2:成功转

    当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_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"
    }