华为云用户手册

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

请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表3 请求消息体参数说明 序号 参数名 参数类型 是否必选 说明 1 busiResult String True 业务结果编码，最大长度为50个字符。 2 subStatus String False 子业务状态编码，最大长度为50个字符。 3 busiResultDesc String False 业务结果描述。 4 workNo String False 执行呼叫的座席的平台工号。 如果需要同一个外呼数据，始终呼叫到同一个座席，该参数必填，如不填，则会路由至其他座席。

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

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

座席自动应答 标示符 AgentEvent_Auto_Answer 作用 座席自动应答呼叫。 附带信息 caller：文本型，主叫号码。 called：文本型，被叫号码。 callid：文本型，呼叫所属于的CallId（呼叫标示）。 type：文本型，协作呼叫(assistant)或主呼叫(main)。 feature：呼叫类型，例如0普通呼入，7普通外呼，43预测外呼。feature与callid关联，不会随转移等动作改变。 mediaAbility：媒体能力，1表示语音，2表示视频，3表示音视频，5表示文字，6表示H5视频。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Auto_Answer","workNo":"49999","content":{"caller":"70093","transfer":"no","callid":"1456404171-43","transfrom":"","called":"6048","type":"main","mediaAbility":"1","feature":"0"}}} 父主题： 音视频通话事件

响应消息 该接口的响应消息体举例如下： { "returnCode": "0200000", "data": { "callId": "1644464743-1388", "called": "88881955", "callEndTime": "2022-02-10 11:45:51", "vdnId": 8, "callStatus": "6", "failCode": "00000", "resultCode": "OB99999", "callBeginTime": "2022-02-10 11:45:47", "recordPath": "https://south-aicc-develop.obs.cn-south- 1.myhuaweicloud.com:443/isales/record/A68CA32800B9684811D698D1B61C1A0661511E7AD042DEE5304254DDB9DCED00/ec96a62d-f56c-4f4e-8f5e-30e7a29f38e5?AccessKeyId=ERUDBXB5GOMYURMPLKBO&Expires=1644484560&Signature=uztQO%2FxI8GOSW2GZJWCBCm8AyAg%3D", "ackBeginTime": "2022-02-10 11:45:43" }, "resultCode": "0200000", "resultDesc": "Query Success!", "returnDesc": "Query Success!" } 该接口的响应消息体参数说明如表2 响应体参数说明所示。 表3 响应体参数说明 参数名 数据类型 说明 resultCode String 原因码。0200000表示成功，其他表示失败。 resultDesc String 描述。 returnCode String 原因码。0200000表示成功，其他表示失败。 returnDesc String 描述。 data JSONObject 结果json，详见表4 表4 data参数说明 参数名称 数据类型 描述 called String 被叫号码 ackBeginTime String 外呼开始时间，即振铃开始时间，格式为：yyyy-mm-dd hh:mm:ss callBeginTime String 通话开始时间，即接通开始时间，格式为：yyyy-mm-dd hh:mm:ss callEndTime String 通话结束时间，即挂机时间，格式为：yyyy-mm-dd hh:mm:ss callStatus int 呼叫结果（5: 呼叫失败，6: 呼叫成功） failCode String 失败的原因码。 resultCode String 失败的原因码对应的外显结果码。外显结果码可以自定义，失败原因码与外显结果码相互关联。 vdnId int 外呼号码所属VDN ID。 callId String 通话记录ID，用于与CTI平台的话单等通话数据关联。 recordPath String 通话录音文件OBS的URL路径。 说明： 该字段仅在使用接续时（SAAS组网），才返回值，其他情况返回为空。 表5 错误原因码说明 序号 错误码 说明 1 0200001 参数异常，异常详情在resultDesc中描述。 2 0200007 通话记录ID不存在。 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/agentgateway/resource/voicecall/{agentid}/canceltransfer 其中，ip为agentgateway服务器地址，port为agentgateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-KEY string False appKey字段，用户标识，请联系运营人员获取appKey 2 Authorization string True 鉴权信息，值为Bearer + tokenByAKSK接口的返回值中的AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 workNo number True 座席工号

错误结果码 表6 错误原因码说明 序号 错误码 说明 1 0200001 参数异常，异常详情在resultDesc中描述。 2 0200007 外呼活动已经不存在。 3 0200008 开始时间和结束时间不是同时存在，或者同时不存在。 4 0200009 开始时间或者结束时间的格式不正确。 5 0200010 开始时间不是早于结束时间。 6 0200011 开始时间和结束时间相差的天数超过30天。 7 02000001 参数值为空 8 02000002 参数包含非法字符 9 02000003 参数长度不能大于规定长度 10 02000004 参数长度不能小于规定长度 11 02000005 参数长度需要介于规定长度之间 12 02000006 参数值类型不正确 13 02000007 参数值大小不正确 14 02000008 参数转换异常，请检查请求参数 15 02000009 参数组合不正确，请检查请求参数 16 02000010 hour和minute必须同时存在 17 02000011 参数个数不能大于规定个数

响应说明 表4 响应体参数说明 序号 参数名 参数类型 说明 1 resultCode String 原因码。0200000表示成功，其他表示失败。 2 resultDesc String 描述。 3 returnCode String 原因码。0200000表示成功，其他表示失败。 4 returnDesc String 描述。 5 totalCount int 外呼结果总数 6 data JSONArray 结果json，详见表5。 表5 data参数说明 序号 参数名称 参数类型 描述 6.1 campaignId String 外呼任务的id 6.2 sessionId String 标识用户的ID 6.3 called String 被叫号码 6.4 callTimeStr String 呼叫时间，格式为：yyyy-mm-dd hh:mm:ss 6.5 callStatus int 呼叫结果（5: 呼叫失败，6: 呼叫成功） 6.6 failCode String 失败的原因码。 6.7 resultCode String 失败的原因码对应的外显结果码。外显结果码可以自定义，失败原因码与外显结果码相互关联。 6.8 vdnId int 外呼号码所属VDN ID。 6.9 callId String 通话记录ID，用于与CTI平台的话单等通话数据关联。 6.10 recordPath String 通话录音文件的存储路径。 说明： 该字段仅在使用接续时（SAAS组网），才返回值，其他情况返回为空。

报文样例 该接口的请求消息体举例如下： { "sessionId": "1202_test013", "pageSize": 500, "pageNum": 1 } 该接口的响应消息体举例如下： { "resultCode":"0200000", "resultDesc":"Query Success!", "returnCode":"0200000", "returnDesc":"Query Success!", "totalCount": 2, "data": [ { "campaignId": "3", "sessionId": "1202_test013", "called": "60584", "callTimeStr": "2020-08-30 20:00:00", "callStatus": 6, "failCode": "0", "resultCode": "OB99999", "vdnId": 11, "callId": "0023-134864174", "recordPath": "Y:/1/11/20200830/3408/0949218.V3" }, { "campaignId": "3", "sessionId": "1202_test013", "called": "60584", "callTimeStr": "2020-08-30 20:05:00", "callStatus": 6, "failCode": "0", "resultCode": "OB99999", "vdnId": 11, "callId": "0023-134864893", "recordPath": "Y:/1/11/20200830/3408/0942113.V3" } ] }

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

报文样例 场景描述：抽检任务详情。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "currentRole": "qualityDirector", "page": 1, "rows": 10, "fixedColumns": { "planCode": "125092321715122176", "showReviewingOfficer": false, "inspectStatus": "0" } } 响应参数: { "total": 1, "pages": 0, "data": [{ "calls": [{ "duration": 347.16, "upload_time": 1609143922, "rightSpeechRatio": "0.2446", "file_name": "766", "leftSpeechRatio": "0.1933", "call_time": 1609143921, "leftChannel": "staff", "call_uuid": "c6a31191-6c69-486b-b8f9-c3412ef44bfd", "inspectStatus": 0, "call_type": 0, "taskId": "954153162039409666", "call_id": "954155173359172609" }], "id": "954153162039409666", "inspector": "1600226476732482572", "inspectStatus": 0, "inspectorName": "zjrylong", "is_group": false, "setting": { "staff_name": "zxrylong", "staffId": "1600226440112042215", "taskId": "954153162039409666", "call_id": "954155173359172609" } }], "resultCode": "0409000", "resultDesc": "success" }

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 total number True 总条数 1.2 data array[object] True 查询数据 1.2.1 id number False 任务ID 1.2.2 inspector string False 质检人员 1.2.3 inspectStatus number False 质检状态 1.2.4 calls array[object] False 通话列表 1.2.4.1 call_id string False 通话业务id 1.2.4.2 file_name string False 文件名称 1.2.4.3 duration number False 通话时长 1.2.4.4 upload_time number False 上传时间 1.2.4.5 call_time number False 通话开始时间 1.2.4.6 call_uuid string False 通话业务id 1.2.4.7 taskId number False 任务id 1.2.4.8 call_type number False 通话类型 1.2.4.9 inspectStatus number False 质检状态 1.2.4.10 leftChannel string False 左声道 1.2.4.11 leftSpeechRatio number False 左声道通话比例 1.2.4.12 rightSpeechRatio number False 右声道通话比例 1.2.5 setting object False 扩展信息 1.2.5.1 call_id string False 通话详情id 1.2.5.2 taskId number False 任务id 1.2.5.3 staffId string False 坐席id 1.2.5.4 staff_name string False 坐席姓名 1.2.6 inspectorName string False 抽检人员名称 1.2.7 is_group boolean False 是否关联通话 1.3 resultCode string False 返回码 0409000 表示成功 其他表示失败 1.4 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 currentRole string True 用户角色： 质检主管职位：qualityDirector 质检人员职位：qualityInspector 座席人员职位：tableStaff 座席主管职位：tableDirector 1.2 page number True 分页，第几页 1.3 rows number True 分页，每页条数 1.4 fixedColumns object True 抽检任务详情 1.4.1 planCode string True 抽检任务编码，不超过128字符 1.4.2 showReviewingOfficer boolean True 搜索是否已指派复核人的任务: false-否 true-是 1.4.3 inspectStatus string False 抽检状态： -1指未抽检、 0指抽检中、 1指已抽检 1.4.4 inspector string False 抽检人员，不超过256字符 1.4.5 fileName string False 文件名称，不超过256字符 1.4.6 reviewingOfficer string False 复核人员，不超过256字符 1.4.7 reviewingStates string False 复核状态： -1指未复检 2指复检中 3指已复检 1.4.8 staff string False 座席人员，不超过256字符 1.4.9 durationFrom number False 通话时长范围开始 1.4.10 durationTo number False 通话时长范围结束

样例报文 请求头： Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数： { "queryParam": { "ccId":1, "vdn":1, "agentId":101 } } 响应参数： { "result": "0", "resultCode": "0100000", "resultDatas": { "workNo": 101, "vdnId": 1, "citStatus": 0, "name": "HW35154101", "phoneNumber": null, "loginDate": 4294967295000, "currentStateTime": 436879, "mediaType": 0, "status": 2 }, "resultDesc": { "workNo": 101, "vdnId": 1, "citStatus": 0, "name": "HW35154101", "phoneNumber": null, "loginDate": 4294967295000, "currentStateTime": 436879, "mediaType": 0, "status": 2 } }

响应消息 表3 消息体参数说明 序号 名称 参数类型 说明 1 result String 查询结果。取值如下： 0：成功 其他：失败 失败的原因说明请参见错误码参考。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 3 resultDatas object 查询成功后，返回结果信息的对象。 该数组中对象的参数说明请参见表4。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 4 resultDesc object 查询成功后，返回结果信息的对象。 该对象的参数说明请参见表4。 表4 resultDesc/resultDatas对象参数说明 序号 名称 参数类型 说明 2.1 workNo int 座席工号。 2.2 vdnId int 所属VDN ID。 2.3 citStatus Int 座席平台状态。CTI平台座席状态码参考 2.4 name String 座席名称。 2.5 phoneNumber String 座席电话号码。 2.6 loginDate long 签入时间。（毫秒级时间戳） 2.7 currentStateTime long 当前状态时长 单位秒(s)。 2.8 mediaType Int 座席媒体类型，请参见表1 2.9 status Int 座席状态。表5 表5 座席状态 值 说明 0 未知。对应CTI平台状态的9。 1 签入状态。未使用。 2 签出状态。对应CTI平台状态的0。 3 示忙状态。对应CTI平台状态的7。 4 空闲状态。对应CTI平台状态的1。 5 整理态。对应CTI平台状态的6。 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 监控/系统外呼/话单/知识库类接口鉴权方式。 表2 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 ccId int True 呼叫中心编号。 取值范围：1～65535 2 vdn int True 虚拟呼叫中心编号。 取值范围：1～5000 3 agentId Int True 座席工号。 取值范围：101-59999

报文样例 请求样例 { "tenantId":"202104237142", "accessCode":"943370855474270208", "timestamp":1628784000000, "type":"hour", "authToken":"wEd*******************Q6VwYMj" } 响应样例 [ { "recordTime": 1628820000000, "tenantId": "202104237142", "accessCode": "943370855474270208", "callCount": 1, "exitNoConsultCount": 0, "callStaffNoConsultCount": 0, "callStaffConsultCount": 0, "exitConsultingCount": 1, "interactCount": 2, "autonomyRate": "1.0000", "averageInteractPerCall": "2.00", "dbRecordTime": 1628820000000, "type": "hour", "interfaceRequestCount": 0, "interfaceSuccessCount": 0, "interfaceSuccessRate": "-1.0000" } ]

响应说明 参数名称 数据类型 参数位置 必选/可选 描述 - QueryCallStatisticsRes[] body True 呼叫统计报表信息 表2 QueryCallStatisticsRes 名称 是否必选 参数类型 说明 recordTime True long 记录日期的毫秒时间戳 tenantId True String 租户ID accessCode True String 接入标识（机器人接入码） callCount True long 接入量 exitNoConsultCount True long 直接退出量,用户和IVR只交互一次的量 callStaffNoConsultCount True long 直接转人工量,用户和IVR交互大于1次且小于等于3次,并且不在IVR挂机的量 callStaffConsultCount True long 咨询后转人工量,用户和IVR交互大于3次,并且不在IVR挂机的量 exitConsultingCount True long 仅咨询机器人量,用户和IVR交互大于1次,并且在IVR挂机的量 interactCount True long 对话轮次,总的用户和IVR交互次数 autonomyRate True String 净自助解决率 -1.000: 机器人总使用量为0（直接转人工量+咨询后转人工量+仅咨询机器人量） 0-1.000：仅咨询机器人量/机器人总使用量 averageInteractPerCall True String 平均对话轮次,平均每通对话,用户和IVR的交互次数 dbRecordTime True Date 数据库记录日期,未设置为null type True String 查询类型 hour: 按小时查询 day: 按天查询 interfaceRequestCount True long 接口调用总数 interfaceSuccessCount True long 接口调用成功数 interfaceSuccessRate True String 接口调用成功率 -1.000: 接口调用总数为0 0-1.000：接口调用成功数/接口调用总数

请求说明 表1 请求体参数 参数名称 数据类型 参数位置 必选/可选 描述 type String body True 查询类型 hour: 按小时查询,特定日期的报表数据 day: 按天查询,三十日内的报表数据 tenantId String body True 租户ID accessCode String body True 接入标识（机器人接入码） timestamp long body True 查询日期的毫秒时间戳 authToken String body True 认证token。 请参见C3 智能助手平台接口鉴权方式。

报文样例 场景1：查询句子列表 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "category_id": "1070149256381206528", "keyword": "句子", "page": 1, "limit": 10 } 响应参数: { "paging": { "total": 4 }, "data": [ { "category_id": "1070149256381206528", "sentence_id": "10870", "sentence_name": "句子名称78", "tags": null }, { "category_id": "1070149256381206528", "sentence_id": "10877", "sentence_name": "句子名称25", "tags": null }, { "category_id": "1070149256381206528", "sentence_id": "10884", "sentence_name": "句子名称39", "tags": null }, { "category_id": "1070149256381206528", "sentence_id": "10891", "sentence_name": "句子名称85", "tags": null } ] } 场景2：通过句子id查询句子详情 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "sentence_id": "10891" } 响应参数: { "category_id": "1070149256381206528", "sentence_id": "10891", "tagDataList": [ { "tag_type": "dialogue_act", "pos_sentences": [ { "name": "同义语料18", "id": "10169" } ], "neg_sentences": [ { "name": "反义语料14", "id": "10047" } ] }, { "tag_type": "keyword", "pos_sentences": [ { "name": "正则表达式2221", "id": "10109" }, { "name": "关键字22223", "id": "10108" }, { "name": "关键字11164", "id": "10107" } ] } ], "sentence_name": "句子名称85" }

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 data array[object] False 返回的句子数据集合对象 1.1.1 category_id string False 句子分类的唯一标识 1.1.2 sentence_id string True 句子的唯一标识 1.1.3 sentence_name string False 句子名称 1.1.4 tags array[object] False 句子所使用的语义与关键词 1.1.4.1 tag_id string False 标签的唯一标识 1.1.4.2 tag_name string False 标签名称 1.1.4.3 tag_type string False 标签的类型：keyword-关键词，dialogue_act-语义，regular_exp-正则表达式 1.2 paging object False 分页信息对象 1.2.1 current number False 页码 1.2.2 limit number False 每页数量 1.2.3 total number False 查询结果总数 1.3 category_id string False 分类的唯一标识 1.4 sentence_id string False 句子的唯一标识 1.5 sentence_name string False 句子名称 1.6 tagDataList array[object] False 语义与关键字列表 1.6.1 tag_type string False 标签类型 1.6.2 pos_sentences array[object] False 正向语义，关键字和正则表达式 1.6.2.1 id string False 语料的唯一标识 1.6.2.2 name string False 语料内容 1.6.3 neg_sentences array[object] False 反向语义，与pos_sentences在同一个标签对象中不能同时存在 1.6.3.1 id string False 语料的唯一标识 1.6.3.2 name 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 category_id string False 句子分类的唯一标识，传入句子分类标识只查询该分类下的句子 1.2 page number True 分页信息查询条件，查询目标页码 1.3 limit number True 分页信息查询条件，每页数量 取值范围：5， 10， 20， 50， 100 1.4 keyword string False 查询关键字 1.5 sentence_id string False 句子的唯一标识，当传入了句子标识，只查询返回该句子的详情

报文样例 请求头: Content-Type:application/json X-APP-KEY:********************* Authorization:Bearer ********************* 请求参数: {"workNo":107} 响应参数: { "returnCode": "0", "data": false, "description": "success" }

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-KEY string False appKey字段，用户标识，请联系运营人员获取appKey 2 Authorization string True 鉴权信息，值为Bearer + tokenByAKSK接口的返回值中的AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 workNo number True 座席工号

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 returnCode string True 操作结果。0：成功，非0为失败 1.2 description string False 提示信息 1.3 data boolean False 是否是手机接听（true：是，false：否） 响应状态码: 401 鉴权失败 响应状态码: 404 请求资源不存在 响应状态码: 500 服务器内部异常

座席操作类型 表1 操作类型 操作类型 含义 操作对象 操作原因 说明： 下面操作对象和操作原因都为“-”，表示对该操作类型不写座席操作详单。 US_NO_USE=0xFFFF; 65535 0 座席签出C CS 。 US_NO_USE 1~255：客户端传入原因 256：座席与平台断连 257：座席被质检员强制签出 258：座席主动签出 259：座席重新签入前的签出 260：媒体服务器和CCS关于座席控制块握手超时 261：CCS检测到与UIS关于座席控制块握手超时 262：媒体服务器与CCS握手断连导致座席签出 263：UIS与座席握手超时 264：具有相同工号的座席正在新的客户端强制登录，导致本座席被强制签出 1 座席签入。 US_NO_USE US_NO_USE 2 空闲。 - - 3 示忙。 US_NO_USE 1：自己示忙 2：久不应答被示忙 3：被质检员强制示忙 4：休息 5：座席电话不可用 7：座席拒接呼叫 200～250：业务自定义原因码 4 通话态。 US_NO_USE 1：座席未真实退出通话态时，每个准点0分和5分输出的话单。 0：座席完全退出通话态时输出的话单。 5 等待应答。 给业务代表分来话后等业务代表应答。 - - 6 业务代表应答或业务代表呼出成功后等待连接成功的消息。 - - 7 业务代表拆线。 - - 8 请求释放。 - - 9 呼出时等被叫振铃。 - - 10 三方通话。 工号 US_NO_USE 11 座席通道坏或座席死机。 - - 12 座席通道或座席已恢复。 - - 13 人工转自动，业务代表处于挂起状态。 US_NO_USE US_NO_USE 14 被监听或插入。 - - 15 停止被监听或插入。 - - 16 被录音。 - - 17 停止被录音。 - - 18 被监视。 - - 19 停止被监视。 - - 20 监听/插入/耳语。 工号 0：监听座席 2：监听中继 US_NO_USE 21 停止监听/插入/耳语。 - - 22 放音。 US_NO_USE US_NO_USE 23 停止放音。 - - 24 监视。 - - 25 停止监视。 - - 26 座席休假(休息)。 工号 休息原因由客户端调用CCC_REQUEST_REST_EX_Msg时指定（默认0）。 27 工作状态。 US_NO_USE 0：事后整理 业务侧设置自动进入工作态。 0~255：手动调整 由业务座席通过调用接口手动进入工作态。 缺省为0，即事后整理。 28 监听插入呼叫。 - - 29 强制签出。 工号 US_NO_USE 30 强制示闲。 工号 US_NO_USE 31 强制示忙。 工号 US_NO_USE 32 座席对用户静音。 US_NO_USE US_NO_USE 33 结束静音，座席取消对用户静音。 - - 34 座席进入学习态。 US_NO_USE US_NO_USE 35 座席进入工作态。 - - 36 座席进入调整态。 - - 37 工作态结束。 - - 38 座席保持呼叫。 质检员工号 1：被质检员强制保持 US_NO_USE 39 座席取保持。 - - 40 座席发起内部求助。 工号 0：无组合操作 1：两方人工求助 2：三方人工求助 3：通话转被叫应答后先和业务代表通话，业务代表释放时连接主被叫用户。 4：三方通话转被叫应答后实现三方通话，业务代表释放时连接主被叫用户。 5：三方通话 6：连接呼叫 41 座席发起内部呼叫。 工号 US_NO_USE 42 座席进行连接保持。 - - 43 拦截呼叫。 工号 US_NO_USE 44 暂停放音。 US_NO_USE US_NO_USE 45 内部转移。 工号 US_NO_USE 46 转出。 US_NO_USE US_NO_USE 47 签入媒体服务器。 US_NO_USE US_NO_USE 50 静像（只静视频，不静音）。 US_NO_USE US_NO_USE 51 静音视频。 US_NO_USE US_NO_USE 52 签出媒体服务器。 US_NO_USE US_NO_USE 53 转移正在公有队列中排队的呼叫。 US_NO_USE US_NO_USE 54 释放转。 US_NO_USE US_NO_USE 55 转移到其他设备。 US_NO_USE US_NO_USE 56 设置座席的自定义状态。 US_NO_USE 业务自定义的座席状态码。 57 内部求助时切换保持。 US_NO_USE 内部求助切换。 58 座席进入“会议态”。 座席工号 - 59 多媒体协作。 座席工号 0：发起多媒体会议 1：参加多媒体会议 父主题： 附录

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识，请联系运营人员获取appKey 2 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 id string True 被叫ID 1.2 devicetype integer True 设备类型；1：技能队列 3：IVR 1.3 deviceId integer True 目前设备id（技能队列skillId、IVR的id）

报文样例 请求头: Content-Type:application/json Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX X-APP-Key:XXXXXXXXXXXXXXXXXXXXXXX 请求参数: { "id": "1125397061153369092", "devicetype": 1, "deviceId": 1 } 响应参数: { "returnCode": "0", "description": "data update success" }