文档首页/ 云客服/ API参考/ 修改记录
更新时间:2024-09-24 GMT+08:00
分享

修改记录

Issue 15(2024-07-31)

本次随SCMicroService3.6.0 版本发布,变更如下接口。

序号

接口

类型

备注

1

https://ip:port/rest/cmsapp/v1/openapi/hisindex/agent

https://ip:port/rest/cmsapp/v1/openapi/hisindex/vdn

https://ip:port/rest/cmsapp/v1/openapi/hisindex/ivr

https://ip:port/rest/cmsapp/v1/openapi/hisindex/skill

修改

由于性能受限,修改为默认不查实时缓存数据,只能查看当前时间的前整5分钟数据,例如:当前时间为14:32,当前接口只能获取14点30以前数据

2

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

修改

修改参数address的校验,只允许配置数字。

3

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

修改

新增请求参数:userVideoDirection

4

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

修改

新增请求参数:videoDirection

Issue 14(2023-08-30)

本次随SCMicroService 2.6.0.0 版本发布,变更如下接口。

序号

接口

类型

备注

1

https://域名/apiaccess/rest/ipccprovision/v1/operations/queryTenantForOperations,例如域名是service.besclouds.com

新增

新增租户查询接口

2

https://域名/apiaccess/rest/cmsapp/v1/operations/callbill/queryTotalDuration,例如域名是service.besclouds.com

新增

新增呼入与呼出时长统计接口

3

https://域名/apiaccess/rest/cmsapp/v1/operations/calloutdetail/queryCallOutBillByVdn,例如域名是service.besclouds.com

新增

新增呼出详单查询接口

4

https://域名/apiaccess/rest/cmsapp/v1/operations/callindetail/queryCallInBillByVdn,例如域名是service.besclouds.com

新增

新增呼入详单查询接口

5

https://域名/apiaccess/rest/cc-management/v1/operations/queryApiStatistic,例如域名是service.besclouds.com

新增

提供语音通知与一键双呼的API统计接口。

6

https://域名/apiaccess/rest/isales/v1/operations/queryCountByVdn,例如域名是service.besclouds.com

新增

提供智能自动外呼的API调用统计接口。

7

https://域名/apiaccess/rest/cmsapp/v1/operations/queryRealCallCount,例如域名是service.besclouds.com

新增

提供实时通话统计接口,支持查询座席呼入以及呼出的总次数。

8

https://域名/apiaccess/rest/cmsapp/v1/operations/queryLoadCount,例如域名是service.besclouds.com

新增

提供用户接口登录数查询接口,支持查询座席签入次数和页面登录次数。

9

https://域名/apiacces /rest/sum/v1/tenantSpaces/users,例如域名是service.besclouds.com。

新增

增加AppCube租户下业务用户。

10

https://域名/apiaccess/rest/sum/v1/tenantSpaces/users/{userId},例如域名是service.besclouds.com

新增

修改AppCube租户下业务用户。

11

https://域名/apiaccess/rest/sum/v1/tenantSpaces/users/{userIds},例如域名是service.besclouds.com。

新增

删除AppCube租户下某一业务用户或者多个业务用户。

Issue 13(2023-06-12)

本次随SCMicroService 2.3.0.0 版本发布,变更如下接口。

序号

接口

类型

备注

1

https://域名/apiaccess/rest/cc-management/v1/agentAccount/create,例如域名是service.besclouds.com

https://域名/apiaccess/rest/cc-management/v1/agentAccount/delete,例如域名是service.besclouds.com

https://域名/apiaccess/rest/cc-management/v1/agentAccount/update,例如域名是service.besclouds.com

https://域名/apiaccess/rest/cc-management/v1/agentAccount/query,例如域名是service.besclouds.com

修改

修改userAccount、userName、password、oldPassWord、newPassWord字段的说明

Issue 12(2023-05-13)

本次随SCMicroService 2.2.0.0 版本发布,变更如下接口。

表1 接口修改记录

序号

接口

类型

备注

1

华为工业云平台IMC回调接口https://域名/apiaccess/rest/oma/v1/imcopenapi/callback

新增

华为工业云平台IMC回调接口

2

软件云查询试用租户基本信息https://域名/rest/oma/softwareconsole/trialtenant/querytenantinfo

新增

软件云查询试用租户基本信息

3

软件云查询系统参数

新增

查询系统参数,该接口开放给软件云官网调用。

4

客户信息查询接口

修改

响应体增加四个参数vdn、createDate、tenantSpaceStatus、portalUrl

Issue 11(2023-04-07)

本次随SCMicroService 2.1.0.0 版本发布,变更如下接口。

表2 接口修改记录

序号

接口

类型

备注

1

https://域名/rest/oma/softwareconsole/tenant/queryresource

增加

提供给软件云调用,查询OMA侧保存的软件云订购信息。

Issue 10(2023-03-07)

本次随SCMicroService 2.0.0.0 版本发布,变更如下接口。

表3 接口修改记录

序号

接口

类型

备注

1

https://域名/apiaccess/rest/new_case/v2/cases

修改

新增字段thirdCreatorId、删除字段creatorId和createname

Issue 09(2022-12-05)

本次随SCMicroService 1.11.0 版本发布,变更如下接口。

表4 接口修改记录

序号

接口

类型

备注

1

https://域名/apiaccess/rest/new_case/v2/cases

新增

创建工单

2

https://域名/apiaccess/rest/new_case/v2/cases/modify

新增

修改工单属性

3

https://域名/apiaccess/rest/new_case/v2/cases/casetypes

新增

查询工单类型信息

4

https://域名/apiaccess/rest/new_case/v2/cases/casedetails

新增

查询工单详情

5

https://域名/apiaccess/rest/new_case/v2/cases/dealCase

新增

处理工单操作

6

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/create

新增

创建任务

7

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/queryByTaskItemId

新增

查询任务项信息

8

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/queryByTaskId

新增

根据任务id查询任务信息

9

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/dynamicCondition/query?mode=all

新增

根据条件查询任务信息

10

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/transfer

新增

任务转派

11

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/release

新增

任务释放

12

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/claim

新增

任务认领

13

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/done

新增

任务处理

14

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/recall

新增

任务撤回

15

https://域名/apiaccess/service-cloud/rest/new_case/v2/task/return

新增

任务退回

16

https://域名/oifde/rest/crs/process

修改

对话交互后接口V1(inaction=9)

17

https://域名/oifde/rest/crs/process

修改

对话交互后接口V2(inaction=9)

18

释放事件回调接口

修改

新增请求体参数的releaseReason

Issue 08(2022-10-20)

本次随SCMicroService 1.10.0 版本发布,变更如下接口。

表5 接口修改记录

序号

接口

类型

备注

1

https://域名/apiaccess/rest/cc-management/v1/agentAccount/create

修改

请求体参数phone长度改为不超过25位

2

https://域名/apiaccess/rest/cc-management/v1/agentAccount/update

新增

请求体参数phone长度改为不超过25位

3

https://域名/apiaccess/ccmessaging/queryHistoryChatMessage

新增

查询历史消息

4

https://域名/apiaccess/ccmessaging/send,例如域名是https://service.besclouds.com

修改

请求参数mediaType支持位置消息(LOCATE)。

Issue 07(2022-08-31)

本次随SCMicroService 1.0.9 版本发布,变更如下接口。

表6 接口修改记录

序号

接口

类型

备注

1

https://域名/apiaccess/CC-Management/v1/mobileAgent/createCall

修改

创建双呼呼叫 (V1.0.0)接口,新增请求参数:agentWorkNo

2

https://域名/apiaccess/CC-Management/v1/openapp/agentsettings/create

新增

创建APP个人设置(create)

3

https://域名/apiaccess/CC-Management/v1/openapp/agentsettings/update

新增

更新app个人设置(update)

4

https://域名/apiaccess/CC-Management/v1/openapp/agentsettings/query

新增

查询app个人设置 (query)

5

https://域名/apiaccess/CC-Management/v1/openapp/agentsettings/delete

新增

删除app个人设置 (delete)

6

https://域名/service-cloud/rest/isales/v1/openapi/campaigns/{vdnId}/callresult/{campaignId}

修改

查询外呼结果接口,新增请求参数:beginTime、endTime

Issue 06(2022-07-31)

本次随SCMicroService 1.0.8 版本发布,变更如下接口。

表7 接口修改记录

序号

接口

类型

备注

1

https://IP:PORT/oifde/rest/api/queryRecordHistory

修改

会话记录查询接口,响应参数businessInfoStr的JSON串中新增locationId(节点Id)

2

https://ip:port/CCFS/resource/ccfs/downloadOiapRecord?locationId=xx

修改

下载智能IVR录音文件接口,请求URL中的locationId由CTI POOL模式下必选改为可选

3

https://ip:port/CCFS/resource/ccfs/downloadIVRRecordFile?locationId=xx

修改

下载IVR留言接口,请求URL中的locationId由CTI POOL模式下必选改为可选

4

https://域名/apiaccess/rest/cc-management/v1/ita/twopartiescall/statusnotify

新增

ITA双呼结果通知接口

Issue 05(2022-05-30)

本次随SCMicroService 1.0.7 版本发布,变更如下接口。

表8 接口修改记录

序号

接口

类型

备注

1

https://域名/apiaccess/rest/voiceNotification/v2/createVoiceNotification

修改

创建语音通知(V2)接口,请求参数新增可选参数:

voiceFileName(IVR语音名称)

2

https://域名/apiaccess/rest/cc-management/v1/importVoiceFile/upload

修改

上传IVR语音文件接口,请求参数新增可选参数:

voiceFileName(IVR语音名称)

3

https://域名/apiaccess/rest/cc-management/v1/createVoiceTemplate

新增

上传语音通知的文字转语音模板文件接口

4

https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/callRecord

新增

查询自动外呼和智能外呼的通话记录接口

Issue 04(2022-04-30)

本次随SCMicroService 1.0.6 版本发布,变更如下接口。

表9 接口修改记录

序号

接口

类型

备注

1

https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/blocklist/add

修改

新增外呼黑名单接口,请求参数新增可选参数:

restrictTimes (限制次数)

restrictPeriod (限制周期)

2

https://ip:port/oifde/rest/api/tts/texttovoice

新增

依据文本生成TTS语音接口

3

https://域名/apiaccess/rest/voiceNotification/v2/createVoiceNotification

新增

创建语音通知(V2)接口

4

https://域名/apiaccess/rest/cc-management/v1/satisfactionconfig/querySatisfactionConfig

修改

查询满意度调查的IVR流程,响应参数新增可选参数:

accessCode (流程接入码)

5

https://ip:port/rest/cmsapp/v1/openapi/hisindex/skill

https://ip:port/rest/cmsapp/v1/openapi/hisindex/skillforday

https://ip:port/rest/cmsapp/v1/openapi/hisindex/skillformonth

修改

获取技能维度的历史监控指标接口

获取指定日期内的技能维度的历史监控指标接口

获取指定月份内的技能维度的历史监控指标接口

修改以上三个接口的IDX_COUNT_SKILL_INCOMING_CALL(人工呼入请求服务数)参数的计算逻辑。

Issue 03(2022-03-31)

本次随SCMicroService 1.0.5 版本发布,变更如下接口。

表10 接口修改记录

序号

接口

类型

备注

1

https://ip:port/CCFS/resource/ccfs/queryBillData

https://ip:port/CCFS/resource/ccfs/downloadBillFile

修改

通过生成话单和录音索引接口、下载话单和录音索引接口下载的话单和录音索引文件新增参数。

话单索引文件新增参数:

  • vdn (虚拟呼叫中心编号)
  • pre_device_type(呼叫经历的上一个设备的设备类型)
  • pre_device_no (呼叫经历的上一个设备的设备标号)
  • skill_id(呼叫所属技能队列的ID)
  • current_skill_id(当前处理呼叫的技能队列的编号)

录音索引文件新增参数:

  • vdn(虚拟呼叫中心编号)
  • call_type (呼叫类型)
  • media_type (媒体类型)
  • user_wanted_skill_id(引导技能)
  • current_skill_id(当前处理呼叫的技能队列的编号)

2

https://域名/apiaccess/rest/cc-management/v1/importVoiceFile/upload

修改

上传IVR语音文件接口,请求参数 fileType(文件类型)新增支持MP3格式的音频文件。

3

https://ip:port/rest/cmsapp/v1/openapi/agent/agentoprinfo

修改

获取座席操作详情接口,请求参数operateType(操作类型)由必填改为选填。

4

https://域名/apiaccess/ccmessaging/send

修改

网页客户端接入的发送消息接口,请求参数mediaType(消息媒体类型)新增网页卡片消息(WEBCARD)

5

https://ip:port/rest/cmsapp/v1/openapi/hisindex/skill

https://ip:port/rest/cmsapp/v1/openapi/hisindex/skillforday

https://ip:port/rest/cmsapp/v1/openapi/hisindex/skillformonth

修改

获取技能维度的历史监控指标接口

获取指定日期内的技能维度的历史监控指标接口

获取指定月份内的技能维度的历史监控指标接口

以上三个接口新增监控指标:

IDX_COUNT_SKILL_INCOMING_CALL(人工呼入请求服务数)

6

https://域名/apiaccess/rest/cc-management/v1/satisfaction/query

新增

查询满意度调查结果接口

7

https://域名/apiaccess/rest/service-pub/authentication

新增

认证Token信息接口

Issue 02(2022-02-11)

本次随SCMicroService 1.0.4 版本发布,变更如下接口。

序号

接口

类型

备注

1

https://域名/apiaccess/rest/cc-management/v1/agentAccount/query

修改

查询座席账号信息接口,请求参数、响应参数均新增:transparentDisplayFlag(座席透显特性标记)

2

https://域名/apiaccess/rest/cc-management/v1/importVoiceFile/upload

新增

上传IVR语音文件

3

https://域名/apiaccess/rest/voiceNotification/v1/queryVoiceNotificationRecording

新增

查询语音通知的录音文件

4

https://域名/apiaccess/rest/voiceNotification/v1/createVoiceNotification

新增

创建语音通知

5

https://域名/apiaccess/CC-Management/v1/mobileAgent/createCall

修改

创建双呼呼叫 (V1.0.0)接口,新增请求参数:callBackUrl(回调URL)

6

https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/callresultdetail/{callId}

新增

查询单个外呼结果详情

7

https://ip:port/CCFS/resource/ccfs/getRecordFileUrlFromObs

修改

录音下载和播放URL的接口,响应参数url支持如果一个callid有多个录音文件,将会返回多个录音文件的播放和下载路径。

Issue 01(2021-12-15)

本次随Service Cloud 8.21.0 版本发布,变更如下接口。

序号

接口

类型

备注

1

https://域名/apiaccess/rest/cc-management/v1/agentAccount/create

新增

创建座席账号

2

https://域名/apiaccess/rest/cc-management/v1/agentAccount/delete

新增

删除指定座席账号

3

https://域名/apiaccess/rest/cc-management/v1/agentAccount/update

新增

修改座席账号信息

4

https://域名/apiaccess/rest/cc-management/v1/agentAccount/query

新增

查询座席账号信息

5

https://域名/apiaccess/rest/cc-management/v1/agentAccount/addSkillsToAgent

新增

绑定座席和技能队列

6

https://域名/apiaccess/rest/cc-management/v1/agentAccount/releaseAgentBySkillId

新增

解绑座席和技能队列

7

https://域名/apiaccess/rest/cc-management/v1/sipPhone/updateSipPhonePassword

新增

修改座席软电话号码登录密码

8

https://域名/apiaccess/rest/cc-management/v1/agentAccount/queryAgentInfoBySkillId

新增

依据技能队列ID查询座席信息

9

https://域名/apiaccess/rest/cc-management/v1/skill/createSkill

新增

创建技能队列

10

https://域名/apiaccess/rest/cc-management/v1/skill/deleteSkill

新增

删除技能队列

11

https://域名/apiaccess/rest/cc-management/v1/skill/modifySkill

新增

修改技能队列

12

https://域名/apiaccess/rest/cc-management/v1/skill/querySkills

新增

查询技能队列

13

https://域名/apiaccess/rest/cc-management/v1/accessCodeInfo/queryAccessCodeList

新增

查询指定租间的接入码

14

https://域名/apiaccess/rest/cc-management/v1/calledRoute/createCalledRoute

新增

单个创建接入码与技能队列、IVR绑定关系的接口

15

https://域名/apiaccess/rest/cc-management/v1/calledRoute/deleteCalledRoute

新增

删除接入码与技能队列、IVR绑定关系的接口

16

https://域名/apiaccess/rest/cc-management/v1/calledRoute/modifyCalledRoute

新增

单个修改接入码与技能队列、IVR绑定关系的接口

17

https://域名/apiaccess/rest/cc-management/v1/calledRoute/queryCalledRoute

新增

查询接入码与技能队列、IVR绑定关系的接口

18

https://域名/apiaccess/rest/cc-management/v1/phonearea/getPhoneNoRegionInfo

新增

查询号码归属地

19

https://域名/apiaccess/rest/cc-management/v1/ivrFlow/queryIVRFlowList

新增

查询指定租间的所有IVR流程

20

https://域名/apiaccess/rest/cc-management/v1/satisfactionconfig/querySatifyConfig

新增

查询满意度调查的IVR流程

21

https://域名/apiaccess/rest/cc-management/v1/offline/agent/login

新增

手机接听

22

https://域名/apiaccess/rest/cc-management/v1/offline/agent/logout

新增

退出手机接听

23

https://域名/apiaccess/rest/cc-management/v1/offline/agent/isOfflineAgent

新增

查询指定座席是否为手机接听状态

24

https://ip:port/rest/cmsapp/v2/openapi/vdn/querycalls

新增

查询指定VDN下的呼叫信息(v2)

25

https://ip:port/rest/cmsapp/v1/openapi/vdn/queryAgentByStatus

新增

根据座席状态分页查询座席信息

26

https://ip:port/CCFS/resource/ccfs/getRecordFileUrlFromObs

新增

录音下载和播放URL接口

27

https://ip:port/rest/cmsapp/v1/openapi/hisindex/agent

修改

新增两个监控指标:

IDX_COUNT_TOTAL_AGENT_CALL_OUT(呼出总次数)

IDX_RATE_AGENT_SUCC_CALL_OUT

(呼出成功通话率)

28

https://ip:port/rest/cmsapp/v1/openapi/hisindex/agentforday

修改

新增两个监控指标:

IDX_COUNT_TOTAL_AGENT_CALL_OUT(呼出总次数)

IDX_RATE_AGENT_SUCC_CALL_OUT

(呼出成功通话率)

29

https://ip:port/rest/cmsapp/v1/openapi/hisindex/agentformonth

修改

新增两个监控指标:

IDX_COUNT_TOTAL_AGENT_CALL_OUT(呼出总次数)

IDX_RATE_AGENT_SUCC_CALL_OUT

(呼出成功通话率)

30

https://ip:port/rest/cmsapp/v1/callinday/querymanualindexesbycondition

修改

新增响应参数:

inCallAllCostMinute (每通通话计费总时长(分钟))

31

https://ip:port/rest/cmsapp/v1/calloutday/querymanualindexesbycondition

修改

新增响应参数:

outCallAllCostMinute (每通通话计费总时长(分钟))

相关文档