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

修改记录

Issue 13(2023-06-12)

本次随MicroService 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)

本次随MicroService 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)

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

表2 接口修改记录

序号

接口

类型

备注

1

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

增加

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

Issue 10(2023-03-07)

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

表3 接口修改记录

序号

接口

类型

备注

Issue 09(2022-12-05)

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

表4 接口修改记录

序号

接口

类型

备注

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)

本次随MicroService 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)

本次随MicroService 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)

本次随MicroService 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)

本次随MicroService 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)

本次随MicroService 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)

本次随MicroService 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)

本次随MicroService 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 (每通通话计费总时长(分钟))