华为云用户手册

  • 报文样例 请求头 POST /CCFS/resource/ccfs/ivr/downloadFile HTTP/1.1 Authorization: auth-v2/ak/2021-08-31T09:38:50.872Z/content-length;content-type;host/c12f0ed0******************94941bdd106 Accept: */* Content-Type: application/json;charset=UTF-8 Content-Length: 193 请求参数 { "request": { "version": "2.0" }, "msgBody": { "filePath": "Y:/3rdfile/53/thirdvoicebotfile", "mode":"1" } }
  • 响应说明 当调用本接口响应成功,则从httpresponse消息中获取文件的二进制数据生成录音文件,文件后缀名为.wav,响应中content-type字段为Application/Octet-stream;charset=UTF-8。 当调用本接口响应失败,则返回相应的错误码信息,错误码响应数据结构请查看表 响应消息response参数说明,resultData为保留字段,默认为空字符串。 表4 响应消息参数说明 序号 名称 参数类型 说明 1 resultCode String 请求返回的结果码,详见错误码参考。 2 resultDesc String 请求结果描述。 3 resultData Object 请求响应数据
  • 接口URI https://ip:port/agentgateway/resource/onlineagent/{agentid}/agentskills 其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号,取值范围:101~59999。
  • 响应说明 表3 消息体参数说明 序号 名称 参数类型 说明 1 message string 描述 2 retcode string 错误码。取值如下: 0:成功 非0:失败 3 result array 查询成功后,返回结果信息的对象。 该对象的参数说明请参见表4。 表4 result对象参数说明 序号 名称 参数类型 说明 3.1 name string 技能名称 。 3.2 id int 技能ID。 3.3 mediatype int 媒体类型。其中: 1:文字交谈 2:点击通话 4:回呼请求 5:普通音视频电话 15:预测呼出 16:预浏览呼出 17:消息呼叫 19:视频普通呼叫 51:多媒体Web Chat 53:Social Chat
  • 报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 无 响应参数 { "result": [ { "name": "defaultMediaSkill", "id": 1, "mediatype": 53 } ], "message": "success", "retcode": "0" }
  • 连接失败 标示符 AgentEvent_Connect_Fail 作用 座席连接失败。 附带信息 content:文本型,呼叫所属于的CallId(呼叫标示)。 示例: {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Connect_Fail","workNo":"49999","content":"1456404043-38"}} 父主题: 音视频通话事件
  • 样例报文 请求头: Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数: { "queryParam": { "calleeNos": ["10000"], "beginLogDay": "2020-01-01", "endLogDay": "2020-01-01", "callTypes": [0], "skillIds": [1], "subCcNo": 1, "vdn": 3, "ccId": 1 } } 响应参数: { "result": "0", "resultCode": "0100000", "resultDatas": [ { "callTimeGt10": 6, "vdn": 152, "minIvrCallTime": 0, "queOverToIvrNum": 0, "failTimeGt10": 0, "inCallTime": 6584, "agentToQueueNum": 0, "inVdnTime": 0, "callType": 6, "maxQueueWaitTime": 0, "succWaitAnsNum": 0, "ivrOccupyNum": 0, "beginLogDay": "2020-08-24", "autoUserAbandonNum": 0, "callTimeLt60": 2, "maxCallTime": 5702, "failTimeLt60": 0, "hangUpTime": 0, "failTimeLt10": 0, "succAckTimeGt10": 0, "minWaitAnsTime": 2, "autoAnsTime": 0, "ivrOnlySuccNum": 0, "autoCallSuccNum": 0, "hangUpNum": 0, "callTimeLt10": 1, "currentSkillId": -1, "failQueueWaitNum": 0, "minQueueWaitTime": 0, "succQueueWaitNum": 0, "inOccupyNum": 7, "maxIvrCallTime": 0, "currentAgentId": 1133, "ivrOnlyTime": 0, "subCcNo": 1, "succAckTimeLt30": 7, "succAckTimeGt60": 0, "serviceNo": 65535, "maxWaitAnsTime": 3, "netCallSuccNum": 0, "failTimeLt5": 0, "ivrOnlyNum": 0, "minCallTime": 5, "failTimeLt3": 0, "inCallSuccNum": 7, "queOverToIvrTime": 0, "autoCallNum": 0, "failWaitAnsTime": 0, "succAckTimeLt60": 7, "queueWaitTime": 0, "hangUpReleaseNum": 0, "endLogDay": "2020-08-25", "ivrCallTime": 0, "orgCcNo": 1, "calleeNo": "1134", "failTimeLt30": 0, "failTimeGt60": 0, "succWaitAnsTime": 20, "callTimeGt60": 5, "callTimeLt5": 0, "netCallNum": 0, "callTimeLt30": 1, "callTimeLt3": 0, "serCcNo": 1, "succAckTimeLt5": 7, "ivrCallSuccNum": 0, "succQueueWaitTime": 0, "agentToAgentNum": 0, "failQueueWaitTime": 0, "succAckTimeLt10": 7, "noAckNum": 0, "waitAnsNum": 7, "waitAnsTime": 20, "succAckTimeLt3": 1, "autoTransferNum": 0, "inCallCostMinute": 10, "reserved_col1": 0, "inCallAllCostMinute": 1, ...... }, {......} ], "resultDesc": [ { "callTimeGt10": 6, "vdn": 152, "minIvrCallTime": 0, "queOverToIvrNum": 0, "failTimeGt10": 0, "inCallTime": 6584, "agentToQueueNum": 0, "inVdnTime": 0, "callType": 6, "maxQueueWaitTime": 0, "succWaitAnsNum": 0, "ivrOccupyNum": 0, "beginLogDay": "2020-08-24", "autoUserAbandonNum": 0, "callTimeLt60": 2, "maxCallTime": 5702, "failTimeLt60": 0, "hangUpTime": 0, "failTimeLt10": 0, "succAckTimeGt10": 0, "minWaitAnsTime": 2, "autoAnsTime": 0, "ivrOnlySuccNum": 0, "autoCallSuccNum": 0, "hangUpNum": 0, "callTimeLt10": 1, "currentSkillId": -1, "failQueueWaitNum": 0, "minQueueWaitTime": 0, "succQueueWaitNum": 0, "inOccupyNum": 7, "maxIvrCallTime": 0, "currentAgentId": 1133, "ivrOnlyTime": 0, "subCcNo": 1, "succAckTimeLt30": 7, "succAckTimeGt60": 0, "serviceNo": 65535, "maxWaitAnsTime": 3, "netCallSuccNum": 0, "failTimeLt5": 0, "ivrOnlyNum": 0, "minCallTime": 5, "failTimeLt3": 0, "inCallSuccNum": 7, "queOverToIvrTime": 0, "autoCallNum": 0, "failWaitAnsTime": 0, "succAckTimeLt60": 7, "queueWaitTime": 0, "hangUpReleaseNum": 0, "endLogDay": "2020-08-25", "ivrCallTime": 0, "orgCcNo": 1, "calleeNo": "1134", "failTimeLt30": 0, "failTimeGt60": 0, "succWaitAnsTime": 20, "callTimeGt60": 5, "callTimeLt5": 0, "netCallNum": 0, "callTimeLt30": 1, "callTimeLt3": 0, "serCcNo": 1, "succAckTimeLt5": 7, "ivrCallSuccNum": 0, "succQueueWaitTime": 0, "agentToAgentNum": 0, "failQueueWaitTime": 0, "succAckTimeLt10": 7, "noAckNum": 0, "waitAnsNum": 7, "waitAnsTime": 20, "succAckTimeLt3": 1, "autoTransferNum": 0, "inCallCostMinute": 10, "reserved_col1": 0, "inCallAllCostMinute": 1, ...... }, {......} ] }
  • 响应消息 表3 消息体参数说明 参数名 数据类型 说明 result String 查询结果。取值如下: 0:成功 其他:失败 失败的原因说明请参见错误码参考。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 resultCode string 查询结果。取值如下: "0100000":成功 其他:失败 失败的原因说明请参见错误码参考。 resultDatas array 查询成功后,返回结果信息的对象数组。 该数组中对象的参数说明请参见表4。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 resultDesc array 查询成功后,返回结果信息的对象。 该对象的参数说明请参见表4。 表4 resultDesc/resultDatas对象参数说明 参数名 数据类型 说明 beginLogDay string 统计的开始通话时间,与入参一致。 endLogDay string 统计的结束通话时间,与入参一致。 calleeNo string 呼叫的被叫号码。 callType int 呼叫类型。 vdn int 虚拟呼叫中心编号。 serviceNo int 业务类型。 orgCcNo int 原始呼叫中心子系统号。 subCcNo int 子系统号。 serCcNo int 服务方的子系统号。 currentAgentId int 座席工号。 一通呼叫的最后一条话单的座席工号(指标结算时不建议使用) currentSkillId int 技能队列编号。 一通呼叫的最后一条话单的技能队列编号(指标结算时不建议使用) failQueueWaitNum int 呼损等待次数。 failQueueWaitTime int 呼损等待时长(秒)。 waitAnsNum int 等待应答次数。 waitAnsTime int 等待应答时长(秒)。 succWaitAnsTime int 成功通话等待应答时长(秒)。 noAckNum int 应答无通话次数。 succQueueWaitTime int 成功通话排队时长(秒)。 succQueueWaitNum int 成功通话排队次数。 queOverToIvrNum int 队列转IVR挂机数。 queOverToIvrTime int 队列转IVR挂机总时间(秒)。 hangUpNum int 人工转IVR次数。 hangUpTime int 人工转IVR总时间。 hangUpReleaseNum int 人工转IVR挂机数。 inOccupyNum int 人工请求次数。 inCallSuccNum int 人工通话次数。 inCallTime int 人工通话时长(秒)。 maxQueueWaitTime int 最大排队等待时长(秒)。 minQueueWaitTime int 最小排队等待时长(秒)。 maxWaitAnsTime int 最大等待应答时长(秒)。 minWaitAnsTime int 最小等待应答时长(秒)。 maxCallTime int 最大通话时长(秒)。 minCallTime int 最小通话时长(秒)。 succAckTimeLt3 int 应答短于3秒的成功通话量。 callTimeLt3 int 通话时间短于3秒的成功通话量。 failTimeLt3 int 等待时长短于3秒的失败量。 succAckTimeLt5 int 应答短于5秒的成功通话量。 callTimeLt5 int 通话时间短于5秒的成功通话量。 failTimeLt5 int 等待时长短于5秒的失败量。 succAckTimeLt10 int 应答短于10秒的成功通话量。 callTimeLt10 int 通话时间短于10秒的成功通话量。 failTimeLt10 int 等待时长短于10秒的失败量。 succAckTimeLt30 int 应答短于30秒的成功通话量。 callTimeLt30 int 通话时间短于30秒的成功通话量。 failTimeLt30 int 等待时长短于30秒的失败量。 succAckTimeLt60 int 应答短于60秒的成功通话量。 callTimeLt60 int 通话时间短于60秒的成功通话量。 failTimeLt60 int 等待时长短于60秒的失败量。 succAckTimeGt10 int 应答大于10秒的成功通话量。 callTimeGt10 int 通话时间大于10秒的成功通话量。 failTimeGt10 int 等待时长大于10秒的失败量。 succAckTimeGt60 int 应答大于60秒的成功通话量。 callTimeGt60 int 通话时间大于60秒的成功通话量。 failTimeGt60 int 等待时长大于60秒的失败量。 minIvrCallTime int 最小IVR通话时长(秒)。 agentToQueueNum int 人工转队列数。 inVdnTime int 呼入呼叫占用VDN总时长(秒)。 succWaitAnsNum int 成功通话应答数。 ivrOccupyNum int IVR呼入请求次数。 autoUserAbandonNum int 在IVR放音时用户主动挂断的次数。 autoAnsTime int 系统级IVR呼入振铃时长(秒)。 ivrOnlySuccNum int IVR唯一接通数。 autoCallSuccNum int 系统级IVR通话次数。 maxIvrCallTime int 最大IVR通话时长(秒)。 ivrOnlyTime int IVR唯一呼入总时长(秒)。 netCallSuccNum int 通过网络设备成功呼入次数。 ivrOnlyNum int IVR唯一呼入数。 autoCallNum int 系统级IVR呼入次数。 failWaitAnsTime int 呼损应答时长(秒)。 queueWaitTime int 排队等待时长(秒)。 ivrCallTime int IVR呼入通话时长(秒)。 netCallNum int 通过网络设备呼入次数。 ivrCallSuccNum int IVR呼入通话次数。 agentToAgentNum int 人工转人工数。 autoTransferNum int 系统级IVR呼入转出次数。 inCallCostMinute int 人工通话计费时长(分钟)。 inCallAllCostMinute int 每通通话计费总时长(分钟),包括人工通话计费时长和IVR通话计费时长。 reserved_col1-reserved_col20 int 预留字段,业务含义根据表t_cms_custom_indicator_config配置确定;默认预留字段3为等待应答时长小于等于15秒的呼入数。
  • 样例报文 请求头: Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数: { "ccId":1, "id":"159832684658001135254942692203", "vdn":113 } 响应参数: { "returnCode": "0", "resultCode": "0100000", "description": "删除成功", "resultDesc": "删除成功" }
  • 响应消息 表3 消息体参数说明 参数名 数据类型 说明 returnCode String 查询结果。取值如下: 0:成功 其他:失败 失败的原因说明请参见错误码参考。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 resultCode String 执行结果。取值如下: "0100000":成功 其他:失败 失败的原因说明请参见错误码参考。 description String 结果描述 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 resultDesc String 结果描述
  • 结果码 表4 外呼结果错误原因码说明 分类 错误原因码 错误原因描述 外呼成功 00000 外呼成功。 用户侧拆线 00531 外呼用户挂机。 00537 外呼号码被叫忙。 00538 外呼号码为空号或错号。 00548 外呼手机号码关机。 00549 外呼手机号码不在服务区。 00551 用户挂机。 00601 应答前用户挂机。 00603 外呼号码无应答后拆线。 00604 呼叫拒绝。 00701 外呼用户转队列,排队中用户主动挂机。 平台正常拆线 00702 外呼用户转队列,排队超时,平台释放呼叫(若配置为排队超时释放)。 01040 振铃超时,平台释放呼叫。(即在设置的振铃时间内,用户一直没有摘机) 01043 平台内部等待外呼结果超时。 01046 占用座席失败(转IVR外呼不涉及)。 01049 外呼检测超时。 34601 外呼任务不存在。 34605 电话号码为空,即外呼获取的被叫号码为空字符串。 34606 试呼失败,即调用呼出接口失败(比较常见的一种情况:当前的并发外呼数达到了最大外呼数;),没有呼出到用户。 34608 呼出后,没有得到呼出结果信息,超时后将该呼叫数据回写。 系统资源不足,平台侧拆线 00602 系统资源不足,请联系管理员检查资源配置。 00605 01048 34606 系统异常 00606 请联系管理员排查。 34611 其他
  • 报文样例 该接口的请求消息体举例如下: [ { "campaignId": "3", "sessionId": "1202_test013", "called": "60584", "callTimeStr": "2020-08-30 20:00:00", "callStatus": 6, "failCode": "0", "vdnId": 11, "callId": "0023-134864174", "recordPath": "Y:/1/11/20200830/3408/0949218.V3" } ] 该接口的响应消息体举例如下: { "retCode": "0", "retMsg": "success" }
  • 请求说明 无请求头消息。 表1 请求消息体参数说明 序号 参数名 参数类型 说明 1 callResultList List 外呼结果列表,此处仅做说明,实际无此实体对象,response直接返回List。具体参考表2。 表2 callDataList参数说明 序号 参数名 参数类型 说明 1 campaignId String 外呼活动的id 2 sessionId String 标识用户的ID。 3 called String 被叫号码。 4 callTimeStr String 呼叫时间,格式为:yyyy-mm-dd hh:mm:ss。 5 callStatus int 呼叫结果(5: 呼叫失败,6: 呼叫成功)。 6 failCode String 失败的原因码,请参见表4。 7 vdnId int 外呼号码所属VDN ID。 8 callId String 通话记录ID,用于与CTI平台的话单等通话数据关联。 9 customField String 用户自定义字段。 10 recordPath String 通话录音文件的存储路径。 说明: 该字段仅在使用接续时(SAAS组网),才返回值,其他情况返回为空。
  • 样例报文 请求头: Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数: { "ccId":1, "vdn":170 } 响应参数: { "result": "0", "resultCode": "0100000", "resultDatas": [ { "id": 1, "serviceNo": 1, "realFlag": 1, "accessNo": "85000", "description": "异常处理流程" }, { "id": 2, "serviceNo": 1, "realFlag": 1, "accessNo": "85001", "description": "主流程" } ], "resultDesc": [ { "id": 1, "serviceNo": 1, "realFlag": 1, "accessNo": "85000", "description": "异常处理流程" }, { "id": 2, "serviceNo": 1, "realFlag": 1, "accessNo": "85001", "description": "主流程" } ] }
  • 响应消息 表3 响应消息体参数说明 序号 名称 参数类型 说明 1 result String 查询结果。取值如下: 0:成功 其他:失败 失败的原因说明请参见错误码参考。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下: "0100000":成功 其他:失败 失败的原因说明请参见错误码参考。 3 resultDatas array 查询成功后,返回结果信息的对象数组。 该数组中对象的参数说明请参见表4。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 3 resultDesc array 查询成功后,返回结果信息的对象数组。 该数组中对象的参数说明请参见表4 表4 resultDesc/resultDatas数组中对象参数说明 序号 名称 参数类型 说明 2.1 id int IVR流程ID 2.2 serviceNo int 业务类型编号 2.3 realFlag int 虚实队列 1-实队列 2-虚队列 2.4 accessNo string 接入码 2.5 description string 接入码功能描述
  • 请求说明 表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
  • 报文样例 请求消息样例 { "tenantId": "00030010", "faqGroupId":10000, "user":"138****8888", "sentence":"什么是守护人寿险", "authToken": "5**************************" } 响应消息样例 { "answer": { "faqGroupId": 10000, "faqGroupName": "保险咨询", "faqId": 10039, "question": "什么是寿险?", "answers": ["人寿保险是人身保险的一种,以被保险人的寿命为保险标的,且以被保险人的生存或死亡为给付条件的人身保险。和所有保险业务一样,被保险人将风险转嫁给保险人,接受保险人的条款并支付保险费。与其他保险不同的是,人寿保险转嫁的是被保险人的生存或者死亡的风险。"], "prob": 121.11094785672965 } }
  • 请求说明 表1 请求体参数 参数名称 数据类型 参数位置 必选/可选 描述 tenantId String body True 租户ID faqGroupId int body True 问答组ID user String body True 测试用户ID sentence String body True 请求语句 authToken String body True 认证token。 请参见C3 智能助手平台接口鉴权方式。
  • 报文样例 场景描述:获取指定通话的质检结果接口。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "call_uuid": "434l2j4242424jjl242" } 响应参数: { "staff_name": "xieyiling", "left_speed": 324.068, "create_time": 1635318854, "left_speech_ratio": 0.6081, "file_name": "1111", "right_speech_ratio": 0.185, "left_channel": "customer", "call_time": 1635318854, "right_channel": "staff", "call_id": "17af55af-e51d-4cc0-8a62-84222e1d1eea", "segments": [{ "start_time": 0.0, "asr_text": "请问是您想询价吗", "speaker": "customer", "end_time": 11.32, "segment_id": 1 }, { "start_time": 13.36, "asr_text": "对", "speaker": "staff", "end_time": 13.88, "segment_id": 2 }, { "start_time": 14.56, "asr_text": "那您是打算在北京这边买车是吗", "speaker": "customer", "end_time": 16.74, "segment_id": 3 }, { "start_time": 18.74, "asr_text": "是的", "speaker": "staff", "end_time": 19.68, "segment_id": 4 }], "left_silence_time": 40.8, "duration": 104.12, "right_emotions": [{ "score": 32.0, "type": "negative" }, { "score": 69.0, "type": "positive" }], "right_silence_time": 84.86, "upload_time": 1635318854, "left_emotions": [{ "score": 65.0, "type": "negative" }, { "score": 80.0, "type": "positive" }], "right_speed": 230.53, "staff_id": "1679888582905592626", "call_type": 0, "status": 2 }
  • 请求说明 表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 call_uuid string True 通话标识 可从details接口返回的结果获取call_uuid
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 deal number False 交易是否达成 1.2 left_speed number False 左声道发话语速,发话方取决于left_channel字段 1.3 left_speech_ratio number False 左声道通话比例,发话方取决于left_channel字段 1.4 file_name string False 质检文件名称 1.5 left_channel string False 左声道发话方:客户,座席 1.6 right_speech_ratio number False 右声道通话比例,发话方取决于right_channel字段 1.7 call_time number False 通话开始时间 1.8 right_channel string False 右声道发话方:客户,座席 1.9 call_id number False 通话标识 1.10 left_silence_time number False 发话静音时间 1.11 segments array[object] False ASR转写文本语段结果 1.11.1 asr_text string False 转写文本 1.11.2 speaker string False 发话方 1.11.3 start_time number False 发话开始时间 1.11.4 end_time number False 发话结束时间 1.11.5 segment_id number False 语段标识 1.11.6 status number False 通话状态 1.12 duration number False 通话时间 1.13 right_silence_time number False 发话静音时间,发话方取决于right_channel字段 1.14 upload_time number False 通话上传时间 1.15 rule_severity_violation_count number False 质检规则违反总数 1.16 left_emotions array[object] False 通话语气,只针对座席,取决于left_channel是否为座席 1.16.1 type string False 语气类型:积极,消极 1.16.2 score number False 语气评分 1.17 right_speed number False 右声道发话语速,发话方取决于right_channel字段 1.18 staff_id string False 座席人员的userId 可在登录后,进入座席管理页面,查看接口返回的accountId 1.19 call_uuid string False 通话标识 1.20 call_type number False 质检通话类型:文本,音频 1.21 status number False 质检状态取值如下: 0:表示等待质检。 1:表示质检处理中。 2:表示处理成功。 3:表示ASR转写中。 9:表示质检失败,发生错误,质检音频总流量达到每日上限,质检文件数量达到每日上限。 31:表示ASR转写结果语音内容为空。 32:表示语音转文本失败。 33:表示上传语音文件至ASR失败。 34:表示科大ASR传输任务提交失败。 35:表示执行多媒体质检任务失败。 36:表示TUC质检失败。 37:表示ASR将语音文件转换为文本失败。 38:表示更新质检结果失败。 39:表示执行质检任务失败。 40:表示语音文件无效。 1.22 right_emotions array[object] False 通话语气,只针对座席,取决于right_channel是否为座席 1.22.1 type string False 语气类型:积极,消极 1.22.2 score number False 语气评分 响应状态码: 400 错误的请求:请检查请求路径及参数。 响应状态码: 401 未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到:请检查请求的路径。 响应状态码: 500 业务失败:请依次确认您请求中各参数的取值。
  • 接口URI 呼叫中心平台调用识别结果通知接口的URI格式如下: {servicecallbackuri}/v100/subscribe/asrevent/asrresult其中,“servicecallbackuri”为注册的通知回调地址。 例如:https://10.21.117.9:8043/agentgateway/resource/asrresult/v100/subscribe/asrevent/asrresult 第三方需要对该地址进行接收消息处理。
  • 报文样例 场景描述:修改质检评分设置档。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "id": "1980058583", "name": "1", "lower_bound": 10, "upper_bound": 100, "base": 10 } 响应参数: { "resultCode": "0412000", "resultDesc": "操作成功" }
  • 请求说明 表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 id string True 设置档唯一标识 1.2 name string True 设置档名称 1.3 lower_bound number True 下限分数 1.4 upper_bound number True 上限分数 1.5 base number True 起始分数
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0412000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求:请检查请求路径及参数。 响应状态码: 401 未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到:请检查请求的路径。 响应状态码: 500 业务失败:请依次确认您请求中各参数的取值。
  • 报文样例 请求消息样例 { "tenantId":"00030010", "authToken": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "model": { "id": -1, "faqGroupId": 10012, "question": "南京市购房限购", "simQuestions": [ { "statement": "南京市购房限购政策", "type": "Q" } ], "answer": "每户限购2套", "simAnswers": [ { "statement": "每户最多购买2套", "type": "A" } ], "keywords": [ { "w": "限购" } ] } } 响应消息样例 { "errorCode" : "0", "errorMsg" : "" }
  • 请求说明 表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 name string(64) True 规则名称 1.2 score number True 规则分数 1.3 seconds number True 重叠秒数限制 1.4 times number True 重叠次数限制 1.5 other object True 质检条件 1.5.1 call_end number False 单通通话结束时间:填写时间戳,单位秒 1.5.2 call_from number False 单通通话开始时间:填写时间戳,单位秒
  • 报文样例 场景描述:创建抢插话规则 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"other":{"call_from":1623913102,"call_end":1623999504},"name":"test0611","score":4,"seconds":4,"times":4} 响应参数: {"interposal_id":"922992717770788864","resultCode":"0405000","resultDesc":"操作成功"}
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码,0405000表示成功,其他表示失败 1.2 resultDesc string False 描述信息 1.3 interposal_id string False 抢插话规则标识 响应状态码: 400 错误的请求:请检查请求路径及参数。 响应状态码: 401 未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到:请检查请求的路径。 响应状态码: 500 业务失败:请依次确认您请求中各参数的取值。
  • 请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token,access-token获取参见鉴权配置机机接口(SaaS集成) 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 caseInfo Object True 工单信息,该对象的参数说明请参见表3 caseInfo列出来的字段只是任意工单都需要的一些标准字段,其他字段是可以根据工单对应的模板动态扩展。 表3 caseInfo参数说明 序号 名称 参数类型 长度(字节) 是否必选 说明 1 title string 128 True 工单标题 2 description string 20000 True 工单描述 3 type string 20 True 工单类型,工单类型id 4 ownerId string 20 False 工单的责任人,工单自动分配时可以不填写,创建工单接口中根据分配逻辑自动分配责任人 5 isAtuoAssigned boolean - True 是否自动分配 6 priority string - False 优先级,Low/Medium/High/Critical 7 origin string - False 工单来源,Voice/Whatapp/webchat/Email 8 dueDate DateTime - False 期望完成时间,格式为YYYY-MM-DD HH:mm:ss 9 contactId string 20 True 工单对应的联系人 10 attachment string - False 附件大小不能超过5M,数量不超过5个,支持jpg 、png 、pdf 、jpeg 、gif、doc、docx格式 11 creatorId string 20 False 创建人 12 contactPhone string 20 False 联系人电话 13 beId string 20 False CRM客户较多,beId用于区分客户大区 如果创建工单涉及的工单类别使用了自定义的工单模板,则工单模板上扩展的字段可继续在请求消息体中继续往后添加。
共100000条