华为云用户手册

  • 报文样例 场景描述:主动轮询座席侧发送给用户侧的消息 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后有空格)
  • 响应说明 表3 消息体参数说明 序号 参数名 参数类型 说明 1 resultCode String 原因码。0200000表示成功,其他表示失败。 具体见表5。 2 resultDesc String 描述。 3 totalCount int OBS外呼服务器的结果码的总数 4 obsCodes LIST 外呼结果码集合 5 returnCode String 原因码。0200000表示成功,其他表示失败。 具体见表5。 6 returnDesc String 描述。 表4 obsCodes 序号 参数名 参数类型 说明 1 obsCodeDesc String OBS外呼结果码描述 2 obsCode String OBS外呼结果码。
  • 报文样例 该接口的响应消息体举例如下: { "obsCodes": [ { "obsCodeDesc": "The switch is busy.", "obsCode": "00605" }, { "obsCodeDesc": "The call is rejected.", "obsCode": "00604" }, { "obsCodeDesc": "The called party does not answer the call.", "obsCode": "00603" }, { "obsCodeDesc": "No resource available on the ACD.", "obsCode": "00602" }, { "obsCodeDesc": "The ACD times out.", "obsCode": "00606" } ], "returnCode": "0200000", "resultCode": "0200000", "resultDesc": "query queryOBSResultCode Success!", "totalCount": 120, "returnDesc": "query queryOBSResultCode 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 参数个数不能大于规定个数
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/queryOBSResultCode?pageSize={pageSize}&pageNum={pageNum} 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。 2 pageNum int True 页码,取值大于0 3 pageSize int True 表示每页的查询数量。 取值范围:1~50
  • 接口URI https://IP:Port/agentgateway/resource/config/subscribe/handshake/{serviceid} 表1 URI携带的参数说明 序号 名称 参数类型 是否必选 说明 1 serverid string True CTI平台已存在的订阅任务的编号,也就是订阅注册时CTI平台返回给第三方业务客户端的订阅任务编号。 不能设置为空或空白字符串。
  • 请求消息 消息头 表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。
  • 响应消息 该接口的响应消息体举例如下: { "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
  • 报文样例 请求头: x-app-key:9******************************3 Authorization:Bearer e******************************e Content-Type:application/json 请求参数: { "callSerialNo": "645735364434067472" } 响应头: { "connection": "keep-alive", "content-type": "application/json;charset=UTF-8" } 响应参数: { "retMsg": "Query call state successfully", "retCode": "0", "result": { "caller": "88889050", "called": "88889060", "callerPresent": "640003", "startTime": 1621823865000, "state": 3, "reasonCode": 0, "agentPresent": "640060", "endTime": 1621823872000 } }
  • 请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段,用户标识 2 Authorization string True 鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 callSerialNo string True 呼叫流水号 长度限制:string(50)
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 retCode string True 返回码。0表示成功,其他为失败。 1:查询状态失败 3:呼叫流水号格式不符 1.2 retMsg string True 失败原因的描述 1.3 result object False 返回结果 1.3.1 state number False 呼叫状态: 0:待呼叫 1:正在呼叫 2:通话中 3:通话结束 长度限制:number(1) 1.3.2 reasonCode number False 通话结束原因码: 0~65535, 0: 通话结束,被叫挂机 1:通话结束,主叫挂机 2:外呼主叫失败 3:外部被叫失败 4:外呼主叫无应答 5:外呼被叫无应答 6:启动呼叫失败 xxx:其他异常 长度限制:number(5) 针对ITA双呼还有一些reasonCode,请参见表4 1.3.3 callData string False 第三方自定义的呼叫数据信息 长度限制:string(1024) 1.3.4 caller string False 主叫号码 长度限制:string(32) 1.3.5 called string False 被叫号码 长度限制:string(32) 1.3.6 startTime string False 外呼开始时间,时间戳,如1572794607000 1.3.7 endTime string False 通话结束时间,时间戳,如1572794607000 1.3.8 callerPresent string False 外显号码,来电显示的号码 长度限制:string(32) 1.3.9 agentPresent string False 外显号码,客户经理来电显示的号码 表4 针对ITA双呼的reasonCode说明 retCode 原因值描述 0 不涉及 1 无法找到号码 2 无法路由到网络 3 无法路由到目的地 4 发送特殊消息 5 中继前缀出错 6 通道无法接入 7 已经建立频道 8 抢先占有 9 抢先占有保留 16 正常呼叫清除 17 用户忙 18 无应答 19 无用户应答 20 用户不可及 21 拒绝呼叫 22 号码已改变 23 重定向 25 交换路由错误 26 无用户准许 27 目标无序 28 非法号码格式 29 设备拒绝 30 状态查询 31 正常 34 路由不可达 38 网络状态不好 39 服务链接不上 40 链接进行中 41 暂时失败 42 设备拥塞 43 信息丢弃 44 通道无法接入 46 呼叫阻塞 47 无可用资源 49 品质无效 50 设备没预订 53 闭合群OCB呼出受限 55 闭合群ICB呼入受限 57 无权限发送 58 发送无效 62 等级不一致 63 服务无效 65 发送无法执行 66 通道无法执行 69 设备无效 70 发送有效 79 CV服务没设置 81 引用非法值 82 通道不存在 83 ID不存在 84 呼叫ID不存在 85 无呼叫等待 86 隐藏号码呼叫 87 CUG无成员 88 目标冲突 90 CUG不存在 91 无效网络 95 无效信息 96 非托管元素 97 类型不存在 98 信息没执行 99 信息单元不存在 100 无效的信息单元 101 呼叫状态不一致 102 定时器超时 103 参数不存在 110 消息中带有未识别的参数 111 协议错误 127 未指定的交互 响应状态码: 400 错误的请求:请检查请求路径及参数。 响应状态码: 401 未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到:请检查请求的路径。 响应状态码: 500 业务失败:请依次确认您请求中各参数的取值。
  • 报文样例 请求消息样例 { "authToken": "P********************oN1ix", "tenantId": "202204017094", "beginTime":"2022-02-21 20:04:38", "endTime":"", "pageNum": "1", "pageSize": "5", "callId": "1648805538-165717321823298", "userMobile": "", "ctiCallId": "" } 响应消息样例 { "errorCode": 0, //接口成功失败标识 "errorMessage": "success!",//接口成功失败描述 "total": 1,//总数 "transferRecordList": [ { "id": "202204013156893697", "tenantId": "202204017094", "callId": "1648805538-165717321823298", "ctiCallId": "1648805538-1657", "flowInstId": "88880301202204011732186311648805538-165717321823298", "callingNumber": "88880301", "calledNumber": "30502", "transfNumber": "88880302", "startTime": 1648805539000, "endTime": 1648805558000, "recordFilePath": "Y:/61/transferrecord/20220401/77448039.wav", "locationId": "0", "opResult": "SUCCESS", "recordResult": "N/A" } ] }
  • 响应说明 表2 响应体参数 参数名称 数据类型 参数位置 必选/可选 描述 errorCode int body True 错误码 0表示成功 非0表示失败 errorMessage String body True 错误描述 total long body False 总条数 transferRecordList transferRecord[] body False 返回转接记录列表(数组结构)
  • 请求说明 表1 请求体参数 参数名称 数据类型 参数位置 必选/可选 描述 tenantId String body True 租户ID authToken String body True 访问接口的有效Token值。 有效Token信息通过获取Token接口获取。 请参见C3 智能助手平台接口鉴权方式。 beginTime String body False 开始时间 格式: yyyy-MM-dd HH:mm:ss endTime String body False 结束时间 格式: yyyy-MM-dd HH:mm:ss pageNum String body False 页码 分页查询,查询第几页,首页为1 不传,默认页码为1 pageSize String body False 每页多少条 可配置:5,10,20,50,100 不传,默认一页100条 callId String body False 流程呼叫ID (userMobile、callId和ctiCallId需要传其中一个) userMobile String body False 用户号码(userMobile、callId和ctiCallId需要传其中一个) ctiCallId String body False 平台呼叫ID (userMobile、callId和ctiCallId需要传其中一个)
  • 响应说明 表6 消息体参数说明 序号 参数名 参数类型 说明 1 resultCode String 原因码。0200000表示成功,其他表示失败。 具体见表5。 2 resultDesc String 描述。 3 importTaskId String 文件导入任务ID 4 returnCode String 原因码。0200000表示成功,其他表示失败。 具体见表7 5 returnDesc String 描述。
  • 错误结果码 表7 错误原因码说明 序号 错误码 说明 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 参数个数不能大于规定个数
  • 黑名单模板 请参考表1创建Excel模板文件。 表1 黑名单模板 黑名单号码(必填) 到期时间(非必填) 有效时长(非必填,单位:小时) 限制次数 限制周期 65676950 - - 1 1 88888888 2022-05-27 23:06:25 - - - 88888888 2022-06-24 10:06:25 - - - 12345678 2022-06-24 10:06:25 - - - 表2 黑名单模板参数说明 序号 参数名 参数类型 是否必选 说明 1 黑名单号码(必填) String True 号码最大长度为24个字符,有效字符为:0~9、*、# 2 到期时间(非必填) String False 到期时间,到期时间=新增时间点+有效时长。例:“2020-12-31 10:06:25”新增2条黑名单号码,有效时长120小时,则到期时间为“2021-01-05 10:06:25”。 3 有效时长(非必填,单位:小时) INT False 有效时长,单位小时,取值范围1~120。 4 限制次数 INT False 限制次数(与限制周期绑定,两者都填或都不填,范围:1-100) 5 限制周期 String False 限制周期(0:每小时;1:每天) 示例1:"restrictTimes":1,"restrictPeriod":"0" 表示2020-12-30 10:06:25 呼出一次,下次可呼出时间为2020-12-30 11:00:00 示例2:"restrictTimes":1,"restrictPeriod":"1" 表示2020-12-30 10:06:25 呼出一次,下次可呼出时间为2020-12-31 00:00:00
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/blackfile/uploadFileServer 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表3 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。
  • 报文样例 该接口的请求消息体举例如下: { "serverId":"164690088271159234793429225848", "filePath":"/isales/upload", "fileName":"demoBlack.xlsx", "hour":"11", "minute":"00" } 该接口的响应消息体举例如下: { "returnCode": "0200000", "importTaskId": "164757251098048478018607266946", "resultCode": "0200000", "resultDesc": "数据导入中,请通过“导入结果”查看详细信息。", "returnDesc": "数据导入中,请通过“导入结果”查看详细信息。" }
  • 呼叫媒体类型说明 表1 呼叫媒体类型 编号 媒体类型 描述 1 MEDIA_TYPE_CHAT 文字交谈 2 MEDIA_TYPE_WEBPHONE 点击通话 3 MEDIA_TYPE_ESCORT 护航浏览、表单共享 4 MEDIA_TYPE_CALLBACK 回呼请求呼叫 5 MEDIA_TYPE_PHONE 普通语音电话 6 MEDIA_TYPE_EMAIL 电子邮件呼叫 说明: 当前版本暂不支持该类型。 7 MEDIA_TYPE_FAX 传真呼叫 说明: 当前版本暂不支持该类型。 8 MEDIA_TYPE_VIDEO IP视频呼叫(H.323) 9 MEDIA_TYPE_WB 电子白板 10 MEDIA_TYPE_APP_SHARE 应用程序共享 11 MEDIA_TYPE_FILE_TRANSFER 文件传输 12 MEDIA_TYPE_VIDEO_2B1D 2B+D ISDN视频呼叫 13 MEDIA_TYPE_VIDEO_6B1D 6B+D ISDN视频呼叫 14 MEDIA_TYPE_OPS OPS呼叫 15 MEDIA_TYPE_PREDICT_OUTBOUND 预测呼出 16 MEDIA_TYPE_PREVIEW_OUTBOUND 预浏览呼出 17 MEDIA_TYPE_MSG 消息媒体 18 MEDIA_TYPE_WEBPHONE_VIDEO 视频点击通话 19 MEDIA_TYPE_PHONE_VIDEO 视频普通呼叫 20 MEDIA_TYPE_WEB_LEAVE_MESSAGE 非实时呼叫 21 MEDIA_TYPE_DESKTOP_SHARE 桌面共享媒体类型 22 MEDIA_TYPE_VC_CALL 技能队列呼入主叫号码功能 23 CLASSIC_MEDIA_TYPE_NUM 接触媒体类型总数 50 MEDIA_TYPE_MULTI_MEDIA_EMAILCHAT 邮件交谈 51 MEDIA_TYPE_MULTI_MEDIA_WEBCHAT 网络交谈 52 MEDIA_TYPE_MULTI_MEDIA_SMSCHAT 短信交谈 53 MEDIA_TYPE_MULTI_MEDIA_SOCIALCHAT 文字交谈 54 MEDIA_TYPE_MULTI_MEDIA_FAXCHAT 传真交谈 55 MEDIA_TYPE_MULTI_MEDIA_H5CHAT H5视频 父主题: 附录
  • 请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表3 请求消息体参数说明 序号 参数名 参数类型 是否必选 说明 1 name String True 业务结果名称。 取值范围:最大长度50,不包含特殊字符。 2 code String False 业务结果编码。 取值范围:最大长度50,有效字符为:数字、字母、-。 3 description Sring False 业务结果描述。 取值范围:最大长度200,不包含特殊字符。 4 children List False 子业务结果。 该对象的参数说明请参见表4。 表4 children参数说明 序号 参数名 参数类型 是否必选 说明 4.1 name String True 子业务结果名称。 取值范围:最大长度50,不包含特殊字符。 4.2 code String False 子业务结果编码。 取值范围:最大长度50,有效字符为:数字、字母、-。 4.3 description String False 子业务结果描述。 取值范围:最大长度200,不包含特殊字符。
  • 错误结果码 表6 错误原因码说明 序号 错误码 说明 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 参数个数不能大于规定个数
  • 报文样例 该接口的请求消息体举例如下: { "name": "呼叫失败", "code": "123456", "description": "呼叫失败", "children": [ { "name": "客户直接挂断", "code": "100001", "description": "客户直接挂断" }, { "name": "客户关机", "code": "100002", "description": "客户关机" } ] } 该接口的响应消息体举例如下: { "resultCode": "0200000", "resultDesc": "addBusinessResult success", "returnCode": "0200000", "returnDesc": "addBusinessResult success" }
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/addBusinessResult 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。
  • 样例报文 请求头: Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数: { "ccId":1, "vdn":170, "skillIds":[1,2] } 响应参数: { "result": "0", "resultCode": "0100000", "resultDatas": [ { "skillId": 1, "queueSize": 0, "loggedOnAgents": 0, "queueTime": 0, "availAgents": 0, "skillDescrip": "defaultVedioSkill", "callId": "4294967295-4294967295", "maxQueueSize": 100 }, { "skillId": 2, "queueSize": 0, "loggedOnAgents": 1, "queueTime": 0, "availAgents": 0, "skillDescrip": "defaultAudioSkill", "callId": "4294967295-4294967295", "maxQueueSize": 100 } ], "resultDesc": [ { "skillId": 1, "queueSize": 0, "loggedOnAgents": 0, "queueTime": 0, "availAgents": 0, "skillDescrip": "defaultVedioSkill", "callId": "4294967295-4294967295", "maxQueueSize": 100 }, { "skillId": 2, "queueSize": 0, "loggedOnAgents": 1, "queueTime": 0, "availAgents": 0, "skillDescrip": "defaultAudioSkill", "callId": "4294967295-4294967295", "maxQueueSize": 100 } ] }
  • 响应消息 表3 响应消息体参数说明 序号 名称 参数类型 说明 1 result String 查询结果。取值如下: 0:成功 其他:失败 失败的原因说明请参见错误码参考。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下: "0100000":成功 其他:失败 失败的原因说明请参见错误码参考。 3 resultDatas array 查询成功后,返回结果信息的对象数组。 该数组中对象的参数说明请参见表4。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 4 resultDesc array 查询成功后,返回结果信息的对象数组。 该数组对象的参数说明请参见表4。 表4 resultDesc/resultDatas对象参数说明 序号 名称 参数类型 说明 2.1 skillId int 技能队列编号 2.2 queueSize int 当前等待在队列中的呼叫数目 2.3 queueTime long 队列中等待最久的呼叫的等待时间,单位为秒 2.4 loggedOnAgents int 当前签入该技能的座席数量 2.5 availAgents int 该技能队列中当前可用的座席数目 2.6 skillDescrip string 技能描述 2.7 callId string 等待最久的呼叫ID 2.8 maxQueueSize int 队列最大可排多少呼叫 如何配置请参见《(For Engineer) ICD VxxxRxxxCxx 产品文档 01 (ICD)》的 配置排队处理/接通率参数
  • 请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表2 请求消息体参数说明 序号 名称 参数类型 是否必选 说明 1 ccId int True 呼叫中心编号。 取值范围:1~65535 2 vdn int True 虚拟呼叫中心编号。 取值范围:1~5000 3 skillIds array True 技能队列ID信息的对象数组。数组长度不大于1000。 技能队列ID取值范围:1~2000。
  • 报文样例 请求消息样例 { "tenantId": "tenant001", "accessIdList": ["10001","..." ], "accessCodeList": ["10086","..." ], "authToken": "0***************************" } 响应消息样例 删除成功: 无响应体报文。 删除失败场景: { "errorCode" : 100000, // int, 错误码,成功时通过状态码为200判断 "errorMsg" : "" }
共100000条