华为云用户手册

三方通话成功 标示符 AgentEvent_Conference 作用 表示当前座席已进入三方通话状态。 附带信息 partner：字符串，通话方电话，如"7101，7102"。 callid：呼叫标识。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Conference","workNo":"49999","content":{"callid":"1456403570-17","partner":"49997，70093"}}} 父主题： 音视频通话事件

报文样例 场景描述：主动轮询座席侧发送给用户侧的消息 URL：Domain Address/apiaccess/ccmessaging/poll?receiverId=XXXXXXXXXXXXXXXXXXXXXXXX&channel=WEB 请求头: ccmessaging-token： XXXXXXXXX 响应参数: { "resultCode": "0", "resultDesc": "query user messages success.", "downlinkMessages": [{ "from": "1011577355744904195", "channel": "WEB", "to": "session_fixed_user_fixed", "controlType": "CHAT", "mediaType": "TEXT", "content": "欢迎欢迎，热列欢迎", "simQuestions": null, "senderNickname": "test", "senderAvatar": "1", "timestamp": 1619590480756, "sourceType": "ROBOT", "callId": null, "robotGender": "MALE" }, { "from": "1011577355744904195", "channel": "WEB", "to": "session_fixed_user_fixed", "controlType": "CHAT", "mediaType": "TEXT", "content": "转人工", "simQuestions": null, "senderNickname": "test", "senderAvatar": "1", "timestamp": 1619590482098, "sourceType": "ROBOT", "callId": null, "robotGender": "MALE" }, { "from": "1011577355744904195", "channel": "WEB", "to": "session_fixed_user_fixed", "controlType": "CHAT", "mediaType": "TEXT", "content": "已接通座席。", "simQuestions": null, "senderNickname": "系统", "senderAvatar": null, "timestamp": 1619590484115, "sourceType": "SYSTEM", "callId": null, "robotGender": null }] } 多媒体库文件场景下： { "downlinkMessages": [ { "callId": null, "simQuestions": null, "senderNickname": "agent", "handlerType": null, "isOfflineStatus": null, "channel": "WEB", "senderAvatar": "", "robotGender": null, "mediaType": "IMAGE", "associationContentId": null, "content": "1179725658739559425", "receiveTime": null, "controlType": "CHAT", "sourceType": "AGENT", "queueFlag": null, "messageCode": "1e1f2bf7-fd6e-4471-a45d-2b43d1eb6272", "from": "202201077401331370", "to": "1642643982282972758", "mediaFileType": "png", "contentType": null, "interIdx": null, "timestamp": 1648102235191 } ], "resultCode": "0", "resultDesc": "query user messages success." } 发送本地文件场景下： { "downlinkMessages": [ { "callId": null, "simQuestions": null, "senderNickname": "agent", "handlerType": null, "isOfflineStatus": null, "channel": "WEB", "senderAvatar": "", "robotGender": null, "mediaType": "IMAGE", "associationContentId": null, "content": "878e7d9a-8e2f-4893-8b54-352f8ecbf86c", "receiveTime": null, "controlType": "CHAT", "sourceType": "AGENT", "queueFlag": null, "messageCode": "9374d9c4-b8ee-4035-aab9-ad5ceddbb856", "from": "202201077401331370", "to": "1642643982282972758", "mediaFileType": "png", "contentType": "1", "interIdx": null, "timestamp": 1648102054235 } ], "resultCode": "0", "resultDesc": "query user messages success." }

请求说明 表1 查询参数 序号 名称 参数类型 是否必选 说明 1 receiverId string True 接收者Id，即applyToken里面的userId。 2 channel string True 接收者渠道类型，缺省值为WEB，且必须为WEB。 3 isNeedRead string False 是否需要READ座席已读用户消息的提示消息，true为需要，其余或者为空不需要该消息 表2 请求头参数 序号 名称 参数类型 是否必选 说明 1 ccmessaging-token string True applyToken接口返回的token值。 会话过程中接口Response Header中返回的ccmessaging-token的值。 2 x-app-key string True appKey字段，用户标识，在API Fabric上配置 3 Authorization string True 鉴权字段，内容格式为：Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格）

响应说明 响应状态码: 200 表3 pollRsp参数结构 序号 名称 参数类型 说明 1.1 resultDesc string 返回结果描述 成功时返回“query user messages success”，失败时无返回。 1.2 downlinkMessages downLIinkMsgArr 发送给用户的消息数组 1.3 resultCode string 客户端接收消息结果码，0表示成功，非0表示失败 表4 downLIinkMsgArr参数结构 序号 名称 参数类型 说明 1.1 channel string 消息渠道类型，当前固定为WEB，表示WEB渠道接入。 1.2 content string 发送给客户下行消息内容，最多500个字符。 根据mediaType不同，content有不同的格式。 如果是多媒体库文件，为多媒体库文件ID； 如果是本地文件，为obskey。 1.3 from string 消息发送方的id，一般为AICC侧渠道的“配置ID”。 1.4 mediaType string 消息媒体类型，如文本类型（TEXT）、图片（IMAGE）、视频（VIDEO）、语音（AUDIO）、位置（LOCATE）、文档（DOCUMENT） 1.5 senderNickname string 座席侧或机器人开启时配置的昵称。如果是系统消息，则返回“系统”（中文租间）或“system”（英文租间）。 1.6 sourceType string 消息发送方来源，如人工座席（AGENT）、机器人（ROBOT）、系统（SYSTEM） 1.7 timestamp string 消息发送时间戳 1.8 to string 消息接收方id，通常为企业侧客户端发送的userId。 1.9 simQuestions string 相似问内容 1.10 isOfflineStatus boolean 用于客户端判断下一步是否可以发送消息。 1.11 messageCode string 消息唯一编码，用来识别撤销或删除动作操作的消息 1.12 interIdx string 交互次数，直接取上一次ODFS返回的inter_idx值即可 1.13 contentType string 如果是多媒体库文件，返回值为null； 如果是本地文件，为"1"。 1.14 mediaFileType string 多媒体文件类型。支持jpg，png，bpm，mp3，aac，mp4，txt，csv，richtext，doc，docx，pdf，zip。 1.15 controlType string 如聊天(CHAT)，断开连接(DISCONNECT)，READ（已读） 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求消息 消息头 表2 消息头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True Guid的取值为C5 智能辅助类接口鉴权方式接口返回的guid。 3 service_token string True 鉴权token，通过订阅生成，例如：3320EA1E5E**********************7112A68E336ED638 最大长度256。

接口URI https://IP:Port/agentgateway/resource/config/subscribe/handshake/{serviceid} 表1 URI携带的参数说明 序号 名称 参数类型 是否必选 说明 1 serverid string True CTI平台已存在的订阅任务的编号，也就是订阅注册时CTI平台返回给第三方业务客户端的订阅任务编号。 不能设置为空或空白字符串。

响应消息 该接口的响应消息体举例如下： { "result": "0", "resultDatas": [{ "workno": 20011, "name": "20011", "status": 4, "ctiStatus": 1, "groupid": 1, "mediatype": 1, "vdnid": 1, "phonenumber": "70942", "currentstatetime": 1505, "logindate": 1501125758000 }] } 该接口的响应消息体参数说明请参见表3。 表3 消息体参数说明 参数名 数据类型 说明 result string 查询结果。取值如下： 0：成功 非0：失败 失败的原因说明请参见错误码参考。 resultDatas array 查询成功后，返回结果信息的数组。 该数组中对象的参数说明请参见表4。 表4 resultDatas对象参数说明 参数名 数据类型 说明 workno int 座席工号。 name string 座席名称。 status int 座席状态。请参见表5。 ctiStatus int 座席平台状态。请参考CTI平台座席状态码参考。 groupid int 座席班组ID。 mediatype int 座席媒体类型，请参见表1 vdnid int 所属VDN ID。 phonenumber string 座席电话号码。 currentstatetime long 当前状态时长。 logindate long 签入时间。 表5 座席状态 值 说明 0 未知。对应CTI平台状态的9。 2 表示调用该接口出现异常。 3 示忙状态。对应CTI平台状态的7。 4 空闲状态。对应CTI平台状态的1。 5 整理态。对应CTI平台状态的6。 7 通话态。对应CTI平台状态的2、3、4、5。 8 休息状态。对应CTI平台状态的8。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 消息头 Content-Type:application/json; charset=UTF-8 消息体 该接口的请求消息体举例如下： { "queryParam": { "ccId":1, "vdn":1, "skillId":1 } } 该接口的请求消息体参数说明请参见表2。 表2 消息体参数说明 参数名 数据类型 是否必选 说明 ccId int True 呼叫中心编号。 取值范围：1～65535 vdn int True 虚拟呼叫中心编号。 取值范围：1～5000 skillId Int True 技能队列编号。 取值范围：1～2000

响应说明 响应状态码: 200 表2 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 sipServicePort string False 软电话注册端口，1~65535 长度限制:string(5) 1.2 sipServiceIp string False 软电话注册地址，IPV4格式 长度限制:string(50) 1.3 agents array[object] False 座席集合 1.3.1 workNo integer True 座席工号，范围从101到59999 1.3.2 sipAccount string False SIP软电话号码 长度限制:string(24) 1.3.3 sipPwd string False SIP软电话加密前密码 长度限制:string(24) 1.3.4 accountCode string False 关联的Service Cloud登录账号 长度限制:string(100) 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 请求头: { "x-app-key": "f******************************f" "Authorization": "Bearer 0******************************8" } { "connection": "keep-alive" "content-type": "application/json;charset=UTF-8" } 响应头: 响应参数: { "sipServiceIp": "10.10.96.98", "sipServicePort": 5060, "agents": [ { "workNo": 1522, "accountCode": "aaaa", "sipAccount": "88881619", "sipPwd": "***" }, { "workNo": 1523, "sipAccount": "88881620", "sipPwd": "***" } ] }

响应说明 当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看表3。 表3 响应消息体参数说明 序号 名称 参数类型 说明 1 resultCode String 请求返回的结果码。取值范围： 0为成功 1为失败 2 description String 请求结果描述。 3 datas List 请求结果对象，参数说明详见表4 表4 datas对象参数说明 序号 名称 参数类型 说明 1 coluKngId String 栏目知识id。 2 coluKngName String 栏目知识名称。 3 coluKngType String 栏目知识类型。 4 beyondColuId Number 所属栏目ID。首层栏目的所属栏目ID为0 5 beyondColuPath Number 所属栏目路径。首层栏目所属路径为/ 6 coluType Number 栏目类型。 7 code Number 栏目编码。为栏目或者知识在栏目知识树上的节点编码。 8 superCode Number 栏目上级编码。 9 id String AppCube id。

报文样例 请求头 Content-Type: application/json;charset=UTF-8 X-TenantSpaceID：******** Authorization: ****************** 请求参数 { "beyondColuId": "0" } 响应参数 { "returnCode": "0", "description": "success", "datas": [ { "coluKngName": "lzd0916父栏目", "code": "001", "coluType": 1, "coluKngType": 1, "superCode": "-1", "id": "caBE000000wqY7oYeYPA", "beyondColuId": "0", "beyondColuPath": "/", "coluKngId": "63e3e4b42c94482b95e04e911f497fbb" } ] }

请求说明 表1 请求消息头参数说明 序号 名称 参数类型 是否必选 默认值 说明 1 Content-Type String True 无 固定填 application/json;charset=UTF-8（两种鉴权方式都填写）。 2 X-TenantSpaceID String True 无 租户id（SIA鉴权填写）。 3 X-Access-Token String True 无 生成方式参见SIA鉴权（SIA鉴权填写）。 4 Authorization String True 无 生成方式参见知识库类接口鉴权方式（AKSK鉴权填写）。 表2 请求消息体参数说明 序号 名称 参数类型 是否必选 默认值 说明 1 beyondColuId String True 无 所属栏目ID。首层栏目的所属栏目ID为0 2 ccId Number False 无 呼叫中心id。AKSK鉴权必填。 3 vdn Number False 无 vdnId。AKSK鉴权必填。

音视频切换 标示符 AgentEvent_MediaSwith 作用 音频呼叫切换视频呼叫场景中，座席调用音视频切换接口，选择媒体类型为视频，调用成功后呼叫从音频切换到视频时，座席会收到该事件，reason为0时表示从IVR返回成功。 附带信息 reason表示切换原因码，0代表成功，其余为失败。 caller表示主叫号码。 called表示被叫号码。 callId表示呼叫唯一标记。 mediaType表示媒体类型。 示例： {"eventType":"AgentEvent_MediaSwith","workNo":"111","content":{"callid":"1603286369-16773","reason":0,"caller":"","mediaType":3,"called":"88022","jsonKey":["callid","reason","caller","mediaType","called"]},"jsonKey":["eventType","workNo","content"]} 父主题： 音视频通话事件

接口URI https://ip:port/agentgateway/resource/recordplay/{agentid}/netplay 其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。

报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "fileName": "Y:/12/0/20211019/155/1406470.V3", "position": "0", "playTime": "1", "fileFormat": "0", "ccId": "1", "locationId": "-1" } 响应参数 { "result": {}, "message": "success", "retcode": "0" }

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 ccmessaging-token string True applyToken接口返回的token值。 会话过程中接口Response Header中返回的ccmessaging-token的值。 2 x-app-key string True appKey字段，用户标识，在API Fabric工具上配置 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 reqBody ReqBody True 请求体 表3 ReqBody参数结构 序号 名称 参数类型 是否必选 说明 1.1 fileId string True 文件下载的fileId，在poll接口中携带 fileId取值 "local/" + content（poll接口响应）时，判定为发送本地文件。若不携带，则判定发送多媒体库文件。 1.2 channel string True 下载渠道类型，当前固定为WEB。 1.3 fileType string True 下载的文件类型，支持jpg，png，bpm，mp3，aac，mp4，txt，csv，richtext，doc，docx，pdf，zip。 发送本地文件场景下，该参数为多媒体文件下行消息中mediaFileType字段。 1.4 multiMedia string False 如果文件为多媒体库文件时，该参数必填，并且需要配置为“multiMedia”。

响应说明 响应状态码: 200 表4 RspBody参数结构 序号 名称 参数类型 说明 1.1 fileStream string Base64编码后的文件流。 1.2 resultCode string 响应返回码，0表示成功，非0表示失败 0：成功，不反悔提示信息 401：objectKey is null! 13：param filetype Out of range!或empty file!或fsservice downloadFile is failed或downloadFileStream IOException或downloadFileStream exception 2：param channelId or userId or tenantId is null 1.3 resultDesc string 响应返回描述，0表示成功，非0表示失败。 1.4 fileUrl string 接收文件临时查看链接。默认保留24小时。 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：客户接收座席发送的多媒体库文件 请求参数: { "fileType": "jpg", "channel": "WEB", "fileId": "XXXXXXXXXXXXXXXX", "multiMedia":"multiMedia" } 响应参数: { "resultCode": "0", "fileUrl": "https://IP:PORT/ccmessaging/202307260369/agent/202307260369134944/1111111111114/e43f69a2-01ee-48ec-82cd-bdf8447492e0.png?AccessKeyId=5BKCLVUJC700HY9M51AT&Expires=1716445961&Signature=LDYl%2FfEpaLbpvlxfEnYxW8QdevY%3D", "fileStream": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsKCwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBT/wAARCAA9ADwDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcI" } 场景描述：客户接收座席发送的本地文件 请求参数: { "fileType": "png", "channel": "WEB", "fileId": "local/XXXXXXXXXXXXXXXX" } 响应参数: { "resultCode": "0", "fileUrl": "https://IP:PORT/ccmessaging/202307260369/agent/202307260369134944/1111111111114/e43f69a2-01ee-48ec-82cd-bdf8447492e0.png?AccessKeyId=5BKCLVUJC700HY9M51AT&Expires=1716445961&Signature=LDYl%2FfEpaLbpvlxfEnYxW8QdevY%3D", "fileStream": "iVBORw0KGgoAAAANSUhEUgAAACEAAAAnCAYAAACBvSFyAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAA7SURBVFhH7c6hEQAgDAAx1uj+gxbB/QyYiPicmdnfJCIRiUhEIhKRiEQkIhGJSEQiEpGIRCQiEYln9gJ7uXthjovHaAAAAABJRU5ErkJggg==" }

转出结果通知 标示符 AgentEvent_linkagePhoneTransferOut_Result 作用 表示话机联动转出的结果。 附带信息 result：0表示转出成功，其他表示失败。 callId：表示联动转出的呼叫唯一标记。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_linkagePhoneTransferOut_Result","workNo":"130","content":{"result":1138,"callId":"1481881644-21"}}} 父主题： 话机联动事件

样例报文 请求头： Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数： { "queryParam": { "ccId":1, "isCallin":"true", "callId":"1000000000-0001" } } 响应参数： { "result": "0", "resultCode": "0100000", "resultDatas": { "vdn": 1, "callId": "1000000000-0001", "callerNo": "10000", "calleeNo": "10001", "callType": 0, "agentId ": 100, "skillId": 1, "anonyCall": 0, "queueWaitTime": 10, "ivrCallTime": 0, "ackTime": 5, "callTime": 30, "releaseCause": 0 }, "resultDesc": { "vdn": 1, "callId": "1000000000-0001", "callerNo": "10000", "calleeNo": "10001", "callType": 0, "agentId ": 100, "skillId": 1, "anonyCall": 0, "queueWaitTime": 10, "ivrCallTime": 0, "ackTime": 5, "callTime": 30, "releaseCause": 0 } }

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表2 消息体参数说明。 序号 名称 参数类型 是否必选 说明 1 ccId int True 呼叫中心编号。 取值范围：1～65535 2 isCallin string True 是否呼入通话。 取值范围： "true"代表呼入， "false"代表呼出 3 callId string True 呼叫ID。

响应消息 表3 消息体参数说明 序号 名称 参数类型 说明 1 result String 查询结果。取值如下： 0：成功 其他：失败 失败的原因说明请参见错误码参考。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 3 resultDatas object 查询成功后，返回结果信息的对象。 该数组中对象的参数说明请参见表4。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultDesc object 查询成功后，返回结果信息的对象。 该数组中对象的参数说明请参见表4。 表4 resultDesc/resultDatas对象参数说明 序号 名称 参数类型 说明 2.1 vdn int 虚拟呼叫中心编号。 2.2 callId string 呼叫ID。 2.3 callerNo string 呼叫的主叫号码。 2.4 calleeNo string 呼叫的被叫号码。 2.5 callType int 呼叫类型，请参见表1 2.6 agentId int 座席工号。 2.7 skillId int 技能队列编号。 2.8 anonyCall int 匿名呼叫标识。(只有呼入时才有值) 2.9 queueWaitTime int 队列等待时长（秒）。 2.10 ivrCallTime int IVR通话时长(秒)。 2.11 ackTime int 应答时长(秒)。 2.12 callTime int 通话时长(秒)。 2.13 releaseCause int 呼叫释放原因码，请参见呼叫释放原因码 2.14 beginTime string 呼叫开始时间(预测外呼，预占用外呼时才有值) 格式：yyyy-MM-dd HH:mm:ss 2.15 endTime string 呼叫结束时间(预测外呼，预占用外呼时才有值) 格式：yyyy-MM-dd HH:mm:ss 2.16 result string 呼叫结果(预测外呼，预占用外呼时才有值) "0000"：OBS转自动前呼出成功 "0900"：OBS转人工前呼出成功 "0101"：呼出失败 "-1"：标识当前的任务没有号码可呼 "0601"：退回 2.17 resultCode string 呼叫结果码(预测外呼，预占用外呼时才有值) 失败的原因码对应的外显结果码。外显结果码可以自定义，失败原因码与外显结果码相互关联 2.18 busiResult string 外呼业务结果编码(预测外呼，预占用外呼时才有值) isales前台页面配置，如何配置请参见操作指南 2.19 busiSubStatus string 外呼业务结果子状态编码(预测外呼，预占用外呼时才有值) isales前台页面配置，如何配置请参见操作指南

接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/blocklist 其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数，取值范围为1～9999。

错误结果码 表4 错误原因码说明 序号 错误码 说明 1 0200001 参数异常，异常详情在resultDesc中描述。 2 0200006 数据库操作异常。 3 02000001 参数值为空 4 02000002 参数包含非法字符 5 02000003 参数长度不能大于规定长度 6 02000004 参数长度不能小于规定长度 7 02000005 参数长度需要介于规定长度之间 8 02000006 参数值类型不正确 9 02000007 参数值大小不正确 10 02000008 参数转换异常，请检查请求参数 11 02000009 参数组合不正确，请检查请求参数 12 02000010 hour和minute必须同时存在 13 02000011 参数个数不能大于规定个数

接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/failcategorystatistics?campaignId={campaignId}&startDate={startDate}&endDate={endDate} 其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数，取值范围为1～9999。 2 campaignId String True 外呼数据ID 3 startDate String False，该字段有值，则endDate必传。 查询开始时间 格式： yyyy-MM-dd 4 endDate String False，该字段有值，则startDate必传。 查询结束时间 格式： yyyy-MM-dd 结束时间-开始时间小于等于30天，

报文样例 该接口的请求消息体举例如下： 无 该接口的响应消息体举例如下： { "returnCode": "0200000", "data": [ { "statDate": "2022-10-14", "failData": { "01119": 1, "01153": 4, "01169": 2 } }, { "statDate": "2022-10-18", "failData": { "00701": 1 } } ], "resultCode": "0200000", "resultDesc": "query success", "returnDesc": "query success" }

错误结果码 表5 错误原因码说明 序号 错误码 说明 1 0200001 参数异常，异常详情在resultDesc中描述。 2 02000001 参数值为空 3 02000002 参数包含非法字符 4 02000003 参数长度不能大于规定长度 5 02000004 参数长度不能小于规定长度 6 02000005 参数长度需要介于规定长度之间 7 02000006 参数值类型不正确 8 02000007 参数值大小不正确 9 02000008 参数转换异常，请检查请求参数 10 02000009 参数组合不正确，请检查请求参数 11 02000010 hour和minute必须同时存在 12 02000011 参数个数不能大于规定个数

报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 无 响应参数 { "result": [ { "name": "defaultMediaSkill", "id": 1, "mediatype": 53 }, { "name": "defaultAudioSkill", "id": 3, "mediatype": 5 } ], "message": "success", "retcode": "0" }

接口URI https://ip:port/agentgateway/resource/onlineagent/{agentid}/agentskillsbyworkno/{workno} 其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。 2 workno string True 待查询的座席工号，取值范围为101～59999。 该座席工号必须与前面agentid为同一vdn下面的座席。