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

静默座席改变流程状态

接口方法

设置成“POST”。

URL

https://IP:PORT/oifde/rest/api/flow/changeWorkMode

请求说明

表1 请求体参数

参数名称

数据类型

参数位置

必选/可选

描述

tenantId

String

body

True

租戶ID

callId

String

body

True

会话ID

agentId

String

body

True

座席ID

workMode

String

body

True

会话状态,要切换的流程状态

0:普通

1:监察

2:插入

3:转移

说明:

只有在监察/插入状态下才能调用此接口切换状态。传入的新状态会和当前会话的状态比较:

  • 监察和插入状态之间互相转换,会话根据新状态决定静默座席如何控制会话
  • 当前监察/插入->普通:会话不再由静默座席控制
  • 当前监察/插入->转移:会话进行呼叫转移

callTransferRequest

Object

body

当workMode=3时,必填

呼叫转移参数请参考表2

authToken

String

body

True

认证token。

请参见C3 智能助手平台接口鉴权方式

表2 callTransferRequest参数说明

参数

数据类型

参数位置

必选/可选

描述

callTransferType

String

body

True

呼叫转移类型。

1:转人工(通过路由码方式转技能队列)

2:转IVR

3:转人工(通过技能队列名称方式转技能队列)

4:转人工(转座席工号)

5:转接第三方号码

6:在线数字辅助

7:转人工(转熟客,目前仅支持多媒体)

8:转人工(转座席所在技能队列,目前仅支持多媒体)

31:转多媒体留言(转熟客)

32:转多媒体留言(转技能队列)

33:转多媒体留言(转座席)

callTransferRouteValue

String

body

True

呼叫转移路由值。

  • 如果“呼叫转移类型”设置为“1”,则设置为转技能队列的路由码。该配置项需确保人工流程与当前流程在同一个系统接入码下,人工技能队列通过被叫配置中的扩展码进行转接。
  • 如果“呼叫转移类型”设置为“2”,则设置为IVR的流程接入码。
  • 在与云联络中心集成模式部署模式下,IVR的流程接入码如图所示。
  • 如果“呼叫转移类型”设置为“3”,则设置为需要转移到的座席所属技能队列的名称,例如“话务1组”。
  • 如果“呼叫转移类型”设置为“4”,则设置为需要转移到的座席对应的平台工号。
  • 如果“呼叫转移类型”设置为“5”,则直接填写第三方号码。
  • 如果“呼叫转移类型”设置为“6”,则配置为与第三方智能化系统约定的流程路由码。
  • 如果“呼叫转移类型”设置为“7”,无需配置
  • 如果“呼叫转移类型”设置为“8”,则设置为需要转移到的座席对应的平台工号或对应的变量。
  • 如果“呼叫转移类型”设置为“31”,无需配置。
  • 如果“呼叫转移类型”设置为“32”,则设置为需要转移到的座席所属技能队列的名称或者接入码。
  • 如果“呼叫转移类型”设置为“33”,则设置为需要转移到的座席对应的平台工号或对应的变量。

callTransferTransData

String

body

False

随路数据

callTransferNumber

String

body

False

主叫号码

响应说明

参数名称

数据类型

参数位置

必选/可选

描述

errorCode

String

body

False

错误码

  • 0:成功
  • 非0表示失败

errorMsg

String

body

False

响应描述

报文样例

  • 请求消息样例
    { 
        "tenantId":"XXX",
        "callId":"123123412300030010",
        "agentId":"88880002",
        "workMode":"3",
        "authToken": "t***********************",
        "callTransferRequest"{
             "callTransferType":"5",
             "callTransferRouteValue":"88880006",
             "callTransferTransData":"",
             "callTransferNumber":""
         }
     }
  • 响应消息样例
    { 
         "errorCode" : "0",
         "errorMsg" : "" 
     }