# 识别结果通知 #### 场景描述 第三方业务向CTI平台注册订阅任务后，CTI平台通过该接口可向业务客户端上报识别结果通知。调用方是CTI平台的openproxy组件，接收方为AICC产品的CC-AI部件或企业的第三方系统。 #### 接口方法 该接口仅支持POST方法，不支持GET、PUT和DELETE等方法。 #### 接口URI 呼叫中心平台调用识别结果通知接口的URI格式如下： {servicecallbackuri}/v100/subscribe/asrevent/asrresult其中，"servicecallbackuri"为注册的通知回调地址。 例如：https://10.21.117.9:8043/agentgateway/resource/asrresult/v100/subscribe/asrevent/asrresult 第三方需要对该地址进行接收消息处理。 HTTPS采用TLS1.2及以上版本，确保web应用的敏感数据在传输过程中不被非法截获 #### 请求消息 - 消息头 表1消息头参数说明 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | Content-Type | string | True | 消息主体编码方式，缺省值：application/json;charset=UTF-8 | | 2 | service_token | string | True | 鉴权token，通过[订阅](https://support.huaweicloud.com/api-ccfs-cec/cec_07_1109.html#ZH-CN_TOPIC_0000002489461310)生成，例如：3320EA1E5E\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*7112A68E336ED638 最大长度256。 | - 消息体 表2识别结果通知推送参数说明 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | serverid | string | True | 平台向业务上报的订阅任务编号 | | 2 | subscribetype | string | True | 上报的订阅事件类型。 - 1：识别。 - 其他：保留，未使用。 当前仅支持为"1"。 | | 3 | initialagentid | string | True | 主控方座席工号，即用户呼入的座席或主动发起外呼的座席工号 | | 4 | ccid | string | True | 当前通话座席所属的呼叫中心CTI平台的编号 | | 5 | vdnid | string | True | 当前通话座席所属的VDN的编号 | | 6 | curcallid | string | True | 当前通话的CallID | | 7 | curuserdn | string | True | 与当前座席通话的用户的电话号码。如果是座席与座席的通话，则为空 | | 8 | talkertype | string | True | 当前说话者类型。 - 1：座席 - 2：用户 | | 9 | talkerid | string | True | 当前说话者标识。 - 当talkertype=1时，该参数值为座席工号。 - 当talkertype=2时，该参数值为用户的电话号码 | | 10 | nlpResult | - object："asrusercase"的值设置为"62"时。 - string："asrusercase"的值不设置为"62"时。 | False | 分析结果内容。该对象参数说明请参见[表3]。 | | 11 | result | array | True | 识别结果内容。取值类型为对象数组，对象数组参数说明如下： - confidence：有效识别结果的可信度。 - content：识别结果内容。该内容格式依赖AICC对接的ASR厂商定义的nlresult值，请根据具体返回格式进行适配。例如，本节样例报文中，该参数的值为AICC公有云场景下返回的格式"\"。 - iscontentenc：识别结果内容是否加密。 - 0：未加密 - 1：加密 | | 12 | asrusercase | string | True | 识别结果原因码。取值如下： - 0：正常识别结果，且识别结束。（非连续识别） - 61：说话开始，不携带识别内容。 - 62：正常识别结果，且识别会连续。 - 63：识别结束 - 其他：识别错误 | | 13 | calldata | string | False | 随路数据，最大1024字节。 calldata存储的内容为： { "nlpFlag": true or false "flowAccessCode":流程接入码 "callBackUrl":实际的回调地址 } | 表3nlpResult 参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 10.1 | call_script | array | 话术进展。该对象参数说明请参见[表4]。 | | 10.2 | call_script_matchedstep | string | 当前话术 | | 10.3 | Intend | string | 意图 | | 10.4 | sensitive_word | object | 敏感词。 | | 10.5 | recomand_KP | object | 推荐知识。该对象参数说明请参见[表5]。 | 表4call_script 参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 10.1.1 | intentcode | string | 意图码 | | 10.1.2 | intentDsp | string | 意图 | | 10.1.3 | status | string | 意图状态，取值： - finished：完成 - 空：未发送 | | 10.1.4 | childintent | array | 话术。 - intentcode：话术码 - intentDsp：话术 - status：话术状态： - finished：完成 - 空：未发送 | 表5recomand_KP参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 10.5.1 | similarFaqs | array | 推荐的相似问答（知识）。该对象参数说明请参见[表6]。 | | 10.5.2 | answer | array | 推荐的问答（知识）。 | 表6similarFaqs参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 10.5.1.1 | faqGroupName | array | 问答组，知识组。 | | 10.5.1.2 | prob | string | 推荐概率值。 | | 10.5.1.3 | question | string | 问题，知识标题。 | | 10.5.1.4 | answers | array | 答案，知识内容。该对象参数说明请参见[表7]。 | | 10.5.1.5 | faqId | string | 问答ID，或知识id。 | | 10.5.1.6 | faqGroupId | string | 问答组ID。 | 表7answer参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 10.5.1.4.1 | faqGroupName | array | 问答组，知识组。 | | 10.5.1.4.2 | prob | string | 推荐概率值。 | | 10.5.1.4.3 | question | string | 问题，知识标题。 | | 10.5.1.4.4 | answers | string | 答案，知识内容。 | | 10.5.1.4.5 | faqId | string | 问答ID，或知识id。 | | 10.5.1.4.6 | faqGroupId | string | 问答组ID。 | #### 响应消息 表8响应消息体参数说明 | 参数名 | 数据类型 | 说明 | |:---|:---|:---| | message | string | 返回消息 | | retcode | string | 操作的结果原因码。 取值类型为整数。 - 0：成功 - 非0：失败，具体见"[错误码定义](https://support.huaweicloud.com/api-ccfs-cec/cec_07_1119.html#ZH-CN_TOPIC_0000002521621095)"章节 | #### 报文样例 - 消息头 ``` Content-Type:application/json;charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 ``` - 请求参数 ``` { "subscribetype": "1", "curuserdn": "88880313", "serverid": "20200723164539-001-00625", "initialagentid": "184", "result": { "iscontentenc": "0", "confidence": "100", "content": "{" }, "ccid": "1", "createTime": 1595493968513, "vdnid": "14", "talkertype": "2", "talkerid": "88880313", "asrusercase": "62", "curcallid": "1595493961-913", "nlpResult": { "call_script": [ { "intentcode": "guashi", "intentDsp": "挂失", "status": "finished", "childintent": [ { "intentcode": "shoujihaoma", "intentDsp": "您的手机号码", "status": "" }, { "intentcode": "shenfenzheng", "intentDsp": "您的身份证号码-Copy1", "status": "" } ] } ], "call_script_matchedstep": "guashi", "Intend": "挂失", "sensitive_word": "", "recomand_KP": { "similarFaqs": [ { "faqGroupName": "挂失相关", "prob": "1E-08", "question": "挂失业务办理流程说明", "answers": [ "挂失业务办理需要到柜面填写资料，挂失业务办理需要到柜面填写资料挂失业务办理需要到柜面填写资料挂失业务办理需要到柜面填写资料挂失业务办理需要到柜面填写资料挂失业务办理需要到柜面填写资料挂失业务办理需要到柜面填写资料挂失业务办理需要到柜面填写资料" ], "faqId": 10002, "faqGroupId": 10000 } ], "answer": { "faqGroupName": "挂失相关", "prob": 4.05465109108164, "question": "挂失业务办理方式", "answers": [ "挂失业务办理需要到柜面填写资料，挂失业务办理需要到柜面填写资料挂失" ], "faqId": 10001, "faqGroupId": 10000 } } } } ``` - 响应参数 ``` { "message": "success", "retcode": "0" } ```