华为云用户手册

VDN监控指标 VDN历史监控指标如下表1 表1 vdn历史监控指标编码 编码 指标名 说明 IDX_COUNT_TOTAL_CALL 总呼叫数 =总呼入+总呼出。（仅支持分钟粒度查询，入参必须带“timeGrain”） 分钟粒度指标为实时指标。 IDX_COUNT_CONNECTED_CALL 总通话数 =总呼入接通数+总呼出接通数（仅支持分钟粒度查询，入参必须带“timeGrain”） 分钟粒度指标为实时指标。 IDX_COUNT_ABANDONED_CALL 总呼损数 =总呼叫数-总接通数（仅支持分钟粒度查询，入参必须带“timeGrain”） 分钟粒度指标为实时指标。 IDX_COUNT_INBOUND_CALL 总呼入数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_INBOUND_CONNECTED 呼入总接通数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_OUTBOUND_CALL 总呼出数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_OUTBOUND_CONNECTED 呼出总接通数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_INBOUND 人工呼入数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_INBOUND_CONNECTED 人工呼入接通数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_IVR_INBOUND IVR呼入数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_IVR_INBOUND_CONNECTED IVR呼入接通数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_IVR_OUTBOUND IVR呼出接通数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_UNIQUE_COUNT_IVR_INBOUND IVR呼入请求数(通话维度) 一通通话只计算一次（支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_UNIQUE_COUNT_IVR_INBOUND_CONNECTED IVR呼入接通数(通话维度) 一通通话只计算一次 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_UNIQUE_COUNT_IVR_OUTBOUND IVR呼出请求数(通话维度) 一通通话只计算一次 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_UNIQUE_COUNT_IVR_OUTBOUND_CONNECTED IVR呼出接通数(通话维度) 一通通话只计算一次 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_OUTBOUND_CONNECTED 人工呼出接通数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_INBOUND_ABANDON_CONNECTED 当日呼入放弃数 =当日呼入数 - 当日呼入接通数（不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_IVR_INBOUND_CONNECTED IVR呼入接通率 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_INBOUND_CONNECTED 呼入总接通率 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_OUTBOUND_CONNECTED 呼出总接通率 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_AGENT_INBOUND_CONNECTED 人工呼入接通率 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_AGENT_INBOUND_ABANDON 人工呼入放弃率 （不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_PHONE_INBOUND_ABANDON 当天电话呼入放弃率 （不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_ABANDON_IN_(N) N秒内放弃率(其中N取3，5，10，30，60) （不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_AGENT_CONNECTED_IN_(N) N秒内人工接通率(其中N取3，5，10，30，60) （不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_AGENT_CONNECTED_AFTER_(N) N秒外人工接通率(其中N取10，60) （不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AVG_VDN_INBOUND 呼入占用VDN均长(s) （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AVG_VDN_OUTBOUND 呼出占用VDN均长(s) （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AVG_CONNECTED 呼入通话均长(s) （不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AVG_WAIT 呼入等待均长(s) （不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_AGENT_CALL_IN_CONNECTED 人工呼入接通率 人工呼入接通数/人工请求数。从一个座席转到另一座席也算一次请求（不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_AGENT_CALL_IN_CONNECTED_IN_20 人工呼入20s接通率 人工呼入20s接通数/总接通数（不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AVG_AGENT_CALL_IN_CONNECTED 人工呼入通话均长 （不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AVG_AGENT_CALL_OUT_CONNECTED 人工呼出通话均长 （不支持分钟粒度查询） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_IVR_ONLY_INBOUND IVR唯一呼入数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_IVR_ONLY_INBOUND_CONNECTED IVR唯一接通数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_IVR_ONLY_INBOUND IVR唯一呼入总时长(秒) （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_SYSTEM_INBOUND 平台呼入数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_SYSTEM_IN_SUCC 平台接通数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_ASSIGNED 平台人工接通数 （支持分钟粒度查询） 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 VDN实时监控指标如表2 表2 vdn实时监控指标编码（CTI3.6版本不可用） 编码 指标名 说明 IDX_COUNT_REAL_VDN_CONNECT VDN通话数 - IDX_COUNT_REAL_VDN_CALL VDN呼叫数 - IDX_COUNT_REAL_IVR_HANDLE IVR处理数 - IDX_COUNT_REAL_SKILL_QUEUE 排队数 - IDX_COUNT_REAL_AGENT_SIGN_IN 签入座席数 - IDX_COUNT_REAL_AGENT_SET_IDLE 示闲座席数 - IDX_COUNT_REAL_AGENT_SET_BUSY 示忙座席数 - IDX_COUNT_REAL_AGENT_CONNECT 通话座席数 - IDX_COUNT_REAL_AGENT_STUDY 学习座席数 - IDX_COUNT_REAL_AGENT_ACW 整理座席数 - IDX_COUNT_REAL_AGENT_ANSWER 应答座席数 - IDX_COUNT_REAL_AGENT_PREOCCUPY 预占用座席数 - IDX_COUNT_REAL_AGENT_OCCUPY 占用座席数 - IDX_COUNT_REAL_AGENT_NOT_SIGN_IN 未签入座席数 - IDX_COUNT_REAL_AGENT_REST 休息座席数 - 父主题： 指标编码参考

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 ccmessaging-token string False applyToken接口返回的token值。 会话过程中接口Response Header中返回的ccmessaging-token的值。 2 x-app-key string False appKey字段，用户标识，在API Fabric上配置 3 Authorization string False 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 reqBody ReqBody True 请求体 表3 ReqBody参数结构 序号 名称 参数类型 是否必选 说明 1.1 userId string True 客户的唯一标识。取值范围：1到32位字符串。 1.2 channelConfigId string True 渠道配置id 1.3 channel string True 渠道类型

响应说明 响应状态码: 200 表4 RspMsg200参数结构 序号 名称 参数类型 说明 1.1 position integer 本呼叫在队列中的位置 1.2 totalWaitTime integer 本呼叫累计排队时长（秒） 1.3 currentDeviceWaitTime integer 当前技能队列的实际等待时长（秒） 1.4 configMaxcWaitTime integer 配置的最大等待时长（秒） 1.5 longestWaitTime integer 队列中正在排队呼叫的最大排队时长（秒） 1.6 estimateWaitTime integer 对应队列的预估呼叫等待时长（秒） 1.7 resultCode string 查询排队信息返回码。具体错误码信息如下： 0：正在排队，查询成功。 1：参数错误。 2：CCU CS 请求失败。 3：Token错误。 4：未知错误。 5：会话已结束。 6：CCUCS会话已失效。 160001：CCUCS通信失败。 160004：会话不存在或已结束。 160021：当前会话已经转到座席，不在排队状态。 160022：当前会话已转移到IVR，不在排队状态。 160023：当前会话已转移到私有队列，不在排队状态。 160024：座席未应答。 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：查询排队信息 请求头： ccmessaging-token: xxxx x-app-key: xxxx Authorization: Bearer xxxx Content-Type: application/json 请求参数： { "userId": "xxxx", "channelConfigId": "xxxxx", "channel": "WEB" } 响应参数： { "totalWaitTime": 3, "resultCode": "0", "longestWaitTime": 3, "position": 1, "currentDeviceWaitTime": 3, "configMaxcWaitTime": 60, "estimateWaitTime": 60 }

报文样例 场景描述：新增话术 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "sentences": ["10877","10795","10795","10849","10870","10877","10877","10721","10877"], "role": "customer", "position": "set", "SGType": "must_say", "sg_name": "话术名称65", "dialogue_flow_id": "1068973778081419264", "position_distance": 2271 } 响应参数: { "sg_id": "1071513309271822336", "resultCode": "0405000", "resultDesc": "操作成功" }

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 sg_id string False 话术标识 1.2 resultCode string False 返回码 0405000 表示成功 其他表示失败 1.3 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 sentences array[string] False 话术使用的句子 1.2 role string True 话术对应的角色，取值如下： any：不限制 staff：坐席 customer：用户 1.3 position string True 通话的位置，取值如下： any：不限制位置 top：通话开头 bottom：通话结尾 set：设定距离 1.4 SGType string True 句子的逻辑关系运算符，取值如下： must：必须说出 if：如果说出 must_say：一定要说 must_not_say：一定不能说 then：再说出 and：还要说出 1.5 sg_name string False 话术名称 1.6 dialogue_flow_id string True 对话逻辑标识 1.7 position_distance number False 句子的偏移量，取值范围：1~9999

消息样例 场景描述：查询工单类型详情 URL：https:// 域名 /service/AICC__Case/1.0.0/openapi/caseType/{id} 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA=" } 请求体： {"id": "cvmC00000149NzxF1ePA"} 响应头： { "connection": "keep-alive", "Content-Length": "16", "Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： { "resCode": "0", "resMsg": "成功", "result": { "caseTypeInfo": { "caseStatus": "y,Completed", "contentTemplateId": null, "createdDate": "2023-06-16 10:26:31", "creatorName": "qianbin001", "description": "aaa", "id": "cvmC00000149NzxF1ePA", "isStrictOrder": false, "lastModifiedDate": "2023-06-16 10:26:50", "lastModifiedName": "10gd00000143C5ONGb0y", "parentId": null, "status": "Active", "templateId": "c7s800000149NtKyh4me", "typeName": "aaa" } }}

响应说明 响应状态码: 200 序号 名称 参数类型 是否必选 说明 1 caseTypeInfo CaseTypes True 工单类型详情，字段对象属性介绍见表3 CaseTypes工单类型参数说明。 表3 CaseTypes工单类型参数说明 序号 名称 参数类型 是否必选 说明 1 id string True 工单类型id 2 typeName string True 工单模板名称（唯一） 3 description string False 工单类型描述 4 status string True 类型状态 5 caseStatus string True 工单状态，多个用,分隔 6 tempalteId string True 关联的工单模板 7 contentTempalteId string False 关联的内容模板 8 parentId string False 父类型id 9 isStrctOrder boolean True 是否严格模式 10 creatorName string True 创建人名称 11 createdDate Datetime True 创建时间 12 lastModifiedName string True 最后修改人名称 13 lastModifiedDate Datetime True 最后修改时间

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 score number True 规则分数 1.2 seconds number True 重叠秒数限制 1.3 times number True 重叠次数限制 1.4 other object True 质检条件 1.4.1 call_end number False 单通通话结束时间：填写时间戳，单位秒 1.4.2 call_from number False 单通通话开始时间：填写时间戳，单位秒 1.5 interposal_id string True 抢插话规则ID 1.6 name string True 规则名称

报文样例 场景描述：更新抢插话规则 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "score": 4, "seconds": 4, "times": 4, "other": { "call_end": 1623999504, "call_from": 1623913102 }, "interposal_id": "922993405183660032", "name": "test0613" } 响应参数: { "resultCode": "0405000", "resultDesc": "操作成功" }

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultDesc string False 返回的描述信息 1.2 resultCode string False 返回码，0405000表示成功，其他表示失败 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

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

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string False 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 emailId string True email ID

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 说明 1.1 returnCode string 返回码。0：成功，3：邮件ID不存在 1.2 description string 响应描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：丢弃邮件 URL：https://域名/apiaccess/rest/ccmessaging/v1/emailchannel/dropMail 请求头: x-app-Key:************************************ Authorization:Bearer ******************************** 请求参数: { "emailId":"10195068940994050" } 响应参数: { "returnCode": "0", "description": "dropMail success" }

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

请求说明 消息头 表2 请求头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 消息体 表3 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 agentIds int True 接收便签消息座席工号。 最大可以传100个座席工号。 2 content string True 便签内容。 大小为0~1023个字节，内容可为空，支持中文内容。

报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "agentIds": [ 31002, 31003 ], "content": "hello" } 响应参数 { "result": null, "message": "success", "retcode": "0" }

样例报文 请求头： Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数： { "ccId":1, "vdn":4, "agentIds":[11,12], "indexIds":["IDX_DURATION_AGENT_REST","IDX_COUNT_AGENT_REQUEST"], "beginMonthTime":"202007", "endMonthTime":"202008", "mediaType":53, "subMediaType":3 } 响应参数： { "result": "0", "resultCode": "0100000", "resultDatas": [ { "idxs": [ { "val": "3", "id": "IDX_COUNT_AGENT_REQUEST" }, { "val": "35", "id": "IDX_DURATION_AGENT_REST" } ], "id": "11" }, { "idxs": [ { "val": "10", "id": "IDX_COUNT_AGENT_REQUEST" }, { "val": "35", "id": "IDX_DURATION_AGENT_REST" } ], "id": "12" } ], "resultDesc": [ { "idxs": [ { "val": "3", "id": "IDX_COUNT_AGENT_REQUEST" }, { "val": "35", "id": "IDX_DURATION_AGENT_REST" } ], "id": "11" }, { "idxs": [ { "val": "10", "id": "IDX_COUNT_AGENT_REQUEST" }, { "val": "35", "id": "IDX_DURATION_AGENT_REST" } ], "id": "12" } ] }

网页客户端接入 若网页端客户接入接口返回401，说明请求头中Authorization或ccmessaging-token已失效，需先调用C1 系统配置类接口鉴权方式刷新Authorization，调用第三方请求鉴权（applyToken）接口刷新cccmessaging-token后，再调用业务接口。 接口调用流程 第三方请求鉴权 (applyToken) 查询排队信息 (queryQueueInfo) 主动轮询座席侧发送的信息 (poll) 保存客户提交的满意度评价结果 (saveSatisfaction) 发送消息 (send) 客户发送文件 (uploadFileStream) 客户接收文件 (downloadFileStream) 根据客户输入联想常用语 (queryPhraseByKeyword) 检查当前租间是否支持点击通话 (checkClickToCallSupport) 创建点击通话 (createClickToCall) 获取点击通话事件 (getClickToCallEvents) 释放点击通话 (dropClickToCall) 创建匿名通话 (createcall) 客户提交留言 (doLeaveMessage) 提交客户对机器人满意度评价结果 (feedbacksatisfaction) 查询历史消息 (queryHistoryChatMessage) 丢弃邮件（chat_dropMail） 提供whatsapp发送下行消息（sendWhatsappMessage） 查询在线交谈工作台当前交谈的消息（getUserInfoBycallId） 查询满意度调查配置（getSatisfactionSurveyMode）

报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "address": "2002", "addressType": "9", "playMode": 2, "voicePath": "y:/conf/120/1136287.V3" } 响应参数 { "result": {}, "message": "success", "retcode": "0" }

响应说明 表4 消息体参数说明 序号 名称 参数类型 说明 1 message string 描述 说明： 当出现错误提示“Unknown ERROR._*****”时，*****表示CTI错误结果码，详情请参见表2。 2 retcode string 错误码。取值如下： 0：成功 非0：失败 3 result map 只有失败时，才返回该参数。请参考表5 表5 放音失败原因 序号 名称 参数类型 说明 3.1 errorReason int 放音失败时透传排队机侧返回的失败原因码。

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

请求说明 消息头 表2 请求头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 消息体 表3 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 addressType String True 地址类型。 6：电话号码 9：座席工号 2 address String True 地址标识。 最大长度为24字节。 3 playMode int False 放音模式。 2：播放指定文件音。 默认值为2。 4 voicePath voicePath True 文件绝对路径名。文件格式为: 盘符/conf/vdn编号/放音文件名，例如： y:/conf/120/1136287.V3 最大长度为127个字符。

报文样例 请求消息样例 { "tenantId": "ipcc", "authToken": "0**************************", "sentence": "请座", "language": "zh_CN", "checkerType": "nonWordSpellChecker" } 响应消息样例 { "hasMistake": false, "spellCheckerMatchList": [ { "word": "请", "startIndex": 0, "endIndex": 1, "hasMistake": false, "correctWord": "请" }, { "word": "座", "startIndex": 1, "endIndex": 2, "hasMistake": true, "correctWord": "坐" } ] }

场景描述 给第三方接入方调用,实现拼写检查能力。 当用户输入要查询的问题时,如果输入的句子中存在错别字（中文是同音错字,英文是拼写错误）,系统能够具有对这些错误进行纠错的能力。 对接Customer Service Platform系统时,采取Headers头部的userName+token组合鉴权方式,其中userName为ipcc,token获取方式参见C3 智能助手平台接口鉴权方式。 对接其他第三方系统,采取请求体的authToken鉴权方式。

请求说明 表1 请求体参数 参数名称 数据类型 参数位置 必选/可选 描述 tenantId String body True 租户ID,默认为ipcc用户,即同获取token时,约定好的ipcc用户。 authToken String body True Token token失效后,需重新调用获取token接口。 请参见C3 智能助手平台接口鉴权方式。 sentence String body True 输入文本,长度限制1024位 language String body True 传入语言参数： zh_CN：中文 en_US：英文 pt_BR：葡萄牙语 传入语言参数类型要求与输入文本类型匹配。 【限制】中英葡语可正常纠错,其他语种文本不做纠错直接返回。再返回的对象中的“是否存在错别字”字段设置为false,即不存在纠错的情况 checkerType String body True 校验类型： 错字纠错: nonWordSpellChecker 别字纠错: realWordSpellChecker 中文仅存在别字纠错。 英文推荐使用错字纠错。 葡语推荐使用错字纠错。

响应说明 参数名称 数据类型 参数位置 必选/可选 描述 hasMistake boolean body True 是否存在错别字： true 表示输入句子中存在错别字 false表示输入句子中不存在错别字 spellCheckerMatchList SpellCheckerMatch[] body True 纠错结果 表2 SpellCheckerMatch 参数名称 数据类型 参数位置 必选/可选 描述 word String spellCheckerMatchList True 原始输入中的字 startIndex int spellCheckerMatchList True word在句子中开始索引 endIndex int spellCheckerMatchList True word在句子中结束索引 hasMistake boolean spellCheckerMatchList True 该word是否为错别字 correctWord String spellCheckerMatchList True 若word为错别字,则为纠正后的字

座席监控指标 表1 座席历史监控指标 编码 指标名 说明 IDX_COUNT_AGENT_SIGN_IN 签入次数 座席签入的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_CONNECTED 呼入通话次数 人工呼入的通话次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_CALL_OUT 呼出通话次数 呼出的通话次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_COLLATION 话后整理次数 通话后的整理次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_COLLATION_CALL_IN 呼入话后整理次数 呼入通话后的整理次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_COLLATION_CALL_OUT 呼出话后整理次数 呼出通话后的整理次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_REST 休息次数 座席休息次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_HOLD 保持次数 座席执行保持操作的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_SET_BUSY 示忙次数 座席执行示忙操作的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_MOVE_INSIDE 内部转移次数 座席执行内部呼叫转移的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_MOVE_OUT 转出次数 座席将呼叫转出的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_MOVE_IVR 挂起转IVR次数 座席挂起转IVR的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_3WC 三方通话数 座席执行三方通话的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_INSIDE_CALL 内部呼叫数 座席执行内部呼叫的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_INSIDE_HELP_SEEKING 内部求助数 座席执行内部求助的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_REQUEST 请求数 人工呼入的请求数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_ABANDON 呼损数 人工呼入呼损数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_WAIT_ANS 振铃待通话数 人工呼入振铃待通话的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_LOST_RING 振铃无通话数 人工呼入振铃但无通话的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_NO_ACK 座席久不应答数 人工呼入座席久不应答次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_HANG_UP 挂机数（应答时） 人工呼入应答时座席挂机的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_CONNECTED_IN_(N) n秒内人工接通数 其中N=3、5、10、15、20、25、30、35、40、45、50、55、60（不支持分钟粒度查询，即接口入参不要带timeGrain） 查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_TOTAL_AGENT_CALL_OUT 呼出总次数 呼出总次数，包括呼出通话次数和呼出未接通次数 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标 IDX_DURATION_AGENT_SIGN_IN 签入时长 座席执行签入操作的时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_CALL_IN 呼入通话时长 人工呼入的通话时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AGENT_AVG_CALL_IN 呼入通话均长 人工呼入通话的平均时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AGENT_CALL_OUT 呼出通话时长 呼出的通话时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AGENT_AVG_CALL_OUT 呼出通话均长 呼出的通话平均时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AGENT_COLLATION 话后整理时长 通话结束后的整理时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_COLLATION_CALL_IN 呼入话后整理时长 呼入通话结束后的整理时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_AVG_COLLATION_CALL_IN 呼入话后整理均长 呼入通话结束后的整理平均长。（不支持按分钟粒度统计） 查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_COLLATION_CALL_OUT 呼出话后整理时长 呼出通话结束后的整理时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_AVG_COLLATION_CALL_OUT 呼出话后整理均长 呼出通话结束后的整理平均长。（不支持按分钟粒度统计） 查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_AVG_COLLATION 话后整理均长 通话结束后的整理平均长。（不支持按分钟粒度统计） 查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_REST 休息时长 座席执行休息操作的时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_AVG_REST 休息均长 座席执行休息操作的平均时长。（不支持按分钟粒度统计） 查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_HOLD 保持时长 座席执行保持操作的时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_AVG_HOLD 保持均长 座席执行保持操作的平均时长。（不支持按分钟粒度统计） 查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_SET_BUSY 示忙时长 座席执行示忙操作的时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_AVG_SET_BUSY 示忙均长 座席执行示忙操作的平均时长。（不支持按分钟粒度统计） 查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_RING 应答时长 人工呼入应答的时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AGENT_FREE 空闲时长 座席执行空闲操作的时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_AVG_RING 应答均长 人工呼入应答的平均时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AGENT_MAX_CALLING 最大通话时长 人工呼入最大的通话时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_DURATION_AGENT_MIN_CALLING 最小通话时长 人工呼入最小的通话时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_AGENT_CONNECTED 通话率 人工呼入通话成功次数占呼入请求次数的比率。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_RATE_AGENT_SUCC_CALL_OUT 呼出成功通话率 呼出通话次数占呼出总次数的比率。 分钟粒度或查询当天（入参不带“timeGrain”）指标为实时指标。 IDX_COUNT_AGENT_ARRANGE 整理次数 座席执行整理操作的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_ARRANGE 整理时长 座席执行整理操作的时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_COUNT_AGENT_PLAY 放音次数 座席执行放音操作的次数。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 IDX_DURATION_AGENT_PLAY 放音时长 座席执行放音操作的时长。 分钟粒度或查询当天（入参不带“timeGrain”）指标为非实时指标。 表2 座席实时监控指标 编码 指标名 说明 IDX_AGENT_PHONE 电话号码 座席电话号码。需要签入座席 IDX_AGENT_CURRENT_STATE 座席状态 座席状态。CTI平台座席状态码参考 IDX_DURATION_AGENT_CURRENT_STATE 当前状态持续时长 座席当前状态持续时长（秒）。 IDX_AGENT_ LOG IN_SKILLS 签入或者拥有的技能列表 技能队列ID的数组。 表3 座席定制指标 编码 指标名 说明 IDX_AGENT_RESERVED_COL(N) 座席定制指标N 取值范围：1～20 父主题： 指标编码参考