文档首页/ 云客服/ API参考/ 机器人管理/ 静默座席专有接口/ 静默座席改变流程状态
更新时间：2023-09-27 GMT+08:00
查看PDF
分享

静默座席改变流程状态

接口方法

设置成“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" : "" 
 }