坐席管理

街机捕鱼大富翁破解版 www.ywfxb.tw 若您初次使用智齿呼叫中心PAAS对接接口,请在使用前阅读说明文档

调用说明

请求及响应报文格式采用JSON格式。

SoftVersion是当前使用的REST API版本,不同版本会有差异,智齿api版本规范为:v1代表第一版,v2代表第二版,当前最新的版本为v1,在开发时需要注意填写正确。

对接URL

当前云通信平台对接地址为://www.ywfxb.tw/comm/

一、坐席上班

说明:座席在指定技能组上班,上班后状态变为准备就绪才可接听电话。

请求地址

POST:

/api/{softVersion}/call/agentOnWork

请求包体

属性 类型 约束 说明 举例
companyId String 必选 公司id -
appId String 必选 应用id节点 -
number String 必选 座席号码,手机号或座机号或voip账号,如果需要动态指定voip号码上班,则指定的voip账号当前不能有坐席正在使用,需要先将之前使用该voip账号的坐席下班(为了保证已经在使用该voip账号的坐席通话不受影响,请先调用查看坐席是否可以下班的接口)。 80034813210002
agentId String 必选 坐席id -
displayNumber String 必选 外呼时使用的外显号码,可通过查询所有外显号码查询到号码列表 01086357692
agentPhoneNum String 可选 只针对后台特殊配置的app,此字段代表呼入时转到坐席的指定的手机号,呼出时使用voip账号呼出 18515234567
callWay String 必选 Sip登录方式 2sip话机,3手机
agentState String 可选 座席状态:1空闲 0忙碌,或其他自定义的状态码 0,1,11
isRecordStereo Bool 可选 是否设置为双声道录音(如果您有语音识别需求请开启此选项) false
groupId String 可选 技能组id -
empNo String 可选 坐席的工号(建议是数字) -

请求示例

{
  "companyId": "36a7403308f74eaca63c32184cc31b09",
  "appId": "d3576afb24904b44a6e74a6cb6ea9ea1",
  "number":"123500000",
  "agentId":"532db74507b344f2bb41ee34f82c6b88",
  "agentState":"1",
  "callWay":"2",
  "displayNumber":"01086392252",
  "agentPhoneNum":"18515239792",
  "groupId":"f582fe8814a94ad1b6a210bdf794cfe4_4"
}

响应包体

属性 类型 说明
retCode String 请求状态码,取值000000(成功)
retMsg String 请求状态描述

响应示例

{
    "retCode": "000000",
    "retMsg": "成功"
}

二、坐席下班

说明:座席从所有技能组中下班,座席退出技能组,不会再接入用户。

请求地址

POST:

/api/{softVersion}/call/agentOffWork

请求包体

属性 类型 约束 说明 举例
companyId String 必选 公司id -
appId String 必选 应用id节点 -
agentId String 必选 座席ID,即serviceId -

请求示例

{
  "companyId": "3bc989fa393b40b8b6208a539cc0e8ed",
  "appId": "286636dc58d645288db74f2601799b05",
  "agentId":"3503f305d991406aab746ddfbece4716",
}

响应包体

属性 类型 说明
retCode String 请求状态码,取值000000(成功)
retMsg String 请求状态描述

响应示例

{
    "retCode": "000000",
    "retMsg": "成功"
}

三、查询坐席是否允许下班

说明:当您的app在后台设置为坐席和话机动态绑定模式时,为了避免因坐席上班使用的voip账号和已经使用该voip账号上班的坐席冲突,您应当先查询该voip账号对应的坐席是否允许下班操作,否则会影响正在使用中的坐席。

请求地址

GET:

/api/{softVersion}/call/agentGetOffWorkState/{voipNumber}

请求包体

属性 类型 约束 说明 举例
voipNumber String 必选 需要查询的被占用的voip号码 12540000

请求示例

https://sobot.com/comm/api/{softVersion}call/agentGetOffWorkState/12540000

响应包体

属性 类型 说明
agentId String 如果已经被占用,则为当前占用的坐席ID未占用无此字段
retCode String 请求状态码,当且仅当返回值为000000 时可以根据agentId将此agentId下线并释放该voipnumber
retMsg String 请求状态描述

响应示例

{
  "agentId": “cb266f9cff7b-41d883cbe5da321e9b1c”, 
  "retCode": "000000",
  "retMsg": "成功"
}

results matching ""

    No results matching ""