对话接口-华为云

云客服-请求识别结果（inaction=13）:请求消息样例

请求消息样例 { "userid": "1528780879-9581", "inaction": 13, "inparams": { "call_id": "1528780879-9581", "call_sor_id": "13500000001", "call_dst_id": "10086", "auth_token":"eyJhbG*******************jUzNSwian" } } ODFS接收到inaction为13的请求后，检索该呼叫从宇高上报识别结果队列是否有数据，如果有数据，就给IVR返回1，否则返回0：

云客服对话接口

云客服-对话交互后接口（inaction=9）:响应消息样例1

响应消息样例1 { "userid": "1528780879-9581", "outaction": 9, "outparams": { "call_id": "1528780879-9581", "prompt_type": "1", "prompt_wav": "welcome", "prompt_text": "查询话费", "language": "0", "inter_idx": "1", "model_type":"1011201" "timeout": "10", "tone": "", "grammar": "", "question_id": "Q1", "question_name": "问题1", "answer_id": "Y" } }

云客服对话接口（V2）

云客服-对话交互后接口（inaction=9）:请求消息样例

请求消息样例 { "userid": "1528780879-9581", "inaction": 9, "inparams": { "call_id": "1528780879-9581", "call_dst_id": "10086", "flow_result_type":"1", "input":"帮我查一下我的话费", "inter_idx": "1", "begin_play": "2018090407:16:24", "end_play": "2018090407:16:30", "result_time":"2018090407:16:3", "inter_no":"0" }, "extparams": { "transin_data":"95,22714,0,,1,1,,test_gdj_01005", "queueIndex":"2", "agentCount":"5", "estimateTime":"10", "idleAgentCount":"1" } } ODFS判断如果 flow_result_type = 1 且 input = (识别结果id值) 时会调用Redis获取转写文本（key=识别结果id值中redis值编号key），获取到的识别文本格式为字符串（非JSON格式）。 Lua脚本获取Redis结果示例代码如下，示例中代码key值为“msg”字符串。

云客服对话接口（V2）

云客服-对话交互后接口（inaction=9）:响应消息样例3

响应消息样例3 { "userid": "1528780879-9581", "outaction": 10, "outparams": { "call_id": "1528780879-9581", "call_sor_id": "13500000001", "call_dst_id": "10086", "start_time": "2018090407:16:24", "end_time": "2018090407:30:24", "release_reason": "0", "region_id": "025", "entrance_id": "03", "exit_id": "05", "user_type_id": "01", "suilu_region_id":"025" } }

云客服对话接口（V2）

云客服-对话交互后接口（inaction=9）:响应消息样例

响应消息样例 { "outaction": 12, "outparams": { "call_id": "1528780879-9581", "prompt_type": "1", "inter_idx": "1", "moduleName":"查询", "xxx":"xxx" //扩展 } }

云客服对话接口（V2）

云客服-对话交互后接口（inaction=9）:响应消息样例2

响应消息样例2 { "userid": "1528780879-9581", "outaction": 11, "outparams": { "call_id": "1528780879-9581", "call_sor_id": "13500000001", "calling_num":"1234567890", "trans_type": "1", "route_value": "123456789", "inter_idx": "1", "trans_idx": "1", "question_id": "Q1", "question_name": "问题1", "answer_id": "Y" } }

云客服对话接口（V2）

云客服-对话交互后接口（inaction=9）:ExtParams参数

ExtParams参数参数名称数据类型参数位置必选/可选描述 transin_data String body False 由接入方跟OIAP约定的随路数据参数，例如IVR传入的数据包参数 release_reason String body False(语音导航场景特有字段) ivr上报给odfs呼叫拆线的原因码： 0、业务流程正常拆线； 1、系统异常拆线； 2、用户拆线； queueIndex String body False(查询排队信息场景特有) 查询技能队列的排队位置 agentCount String body False(查询排队信息场景特有) 查询技能队列的在线座席数 estimateTime String body False(查询排队信息场景特有) 查询技能队列的预计等待时间 idleAgentCount String body False(查询排队信息场景特有) 查询技能队列的空闲座席数

云客服对话接口（V2）

云客服-对话交互后接口（inaction=9）:inparams 参数

inparams 参数参数名称数据类型参数位置必选/可选描述 call_id String body True 呼叫唯一标志,与userid 取值相同，给流程使用。不超过64位 call_dst_id String body True 接入标识 1、语音导航场景传入被叫号码； 2、语音外呼问卷场景时为问卷类型id； 3、其他交互场景时传入接入标识。不超过20位 flow_result_type String body True 结果类型。 1：语音识别输入或者文字输入 2：语音按键输入 3：正常无输入(只播放) 4：录音结束 -1：其他 5：数字人流媒体服务 input String body True 对话交互结果。语音识别结果或者文字输入：语音识别结果为id值，格式为redis值编号key+@+inter_no；文字输入结果则直接为文字内容语音按键结果：按键值，如"1","201801"等 playover：放音结束 timeout：超时 nomatch：识别或按键失败 sys_err：系统异常 hangup：挂机 recordend：录音结束当结果为hangup时，可触发ODFS的拆线响应。不超过1024位 auth_token String body True 授权信息,取接入控制系统返回的token值。请参见C3 智能助手平台接口鉴权方式。 recordFileName String body False(支持全流程录音的语音导航场景特有字段) 全流程录音的路径文件名，例如：Y:/record/1/20200421/xxxxxx.wav inter_idx String body False(语音导航场景特有字段) 交互次数,直接取上一次ODFS返回的inter_idx值即可。 begin_play String body False(语音导航场景特有字段) 放音开始时间 end_play String body False(语音导航场景特有字段) 放音结束时间 result_time String body False(语音导航场景特有字段) 结果产生的时间 inter_no String body False(语音导航场景特有字段) 识别标识 IACmd String body False(语音导航场景特有字段) 智能匹配和智能工单填写专用字段智能匹配时，只支持值为match 智能工单时，可取值如下： match：请求填单 rematch：当识别的事项分类错误时,重新识别 confirm：当座席点选某字段时,告知odfs该字段已确认 TextSource String body False(语音导航场景特有字段) 当IACmd为match时，用于区分输入文本来自座席还是用户（智能匹配、智能工单相同）,值为staff或customer staff：座席 customer：用户当IACmd为confirm时，传入座席点选的字段名,如：对象二级当IACmd为rematch时，可不填 feedback int body False 反馈的满意度: 1(满意)；0(不满意) feedbackContent String body False 反馈的不满意原因(如果反馈为满意则为空) mediaType String body False 媒体类型（文本,音频,视频... 例如：audio,video...） call_media_type String body False 呼入ivr的呼叫类型，文本：0 音频：1视频：3 channelType String body False 渠道类型 WEB（Web） INSTAG RAM （Instagram） TELEGRAM(Telegram) WECHAT(微信) FACEBOOK（Facebook） TWITTER（X (Twitter)） EMAIL（邮件） LINE WHATSAPP（WhatsApp） 5G（5G消息） SMS （短信）。说明：括号里为界面字段,区别于接口传参字段。 refeedbackContentcordFileName String body False 录音文件名 action String body 数字人回复图元操作类型。 3: interrupt 4：callback action_result int body False 0：流媒体处理成功 1：流媒体处理失败 2：流媒体处理异常

云客服对话接口（V2）

云客服-对话转接后请求（inaction=11）:请求消息样例

请求消息样例如果呼叫转移成功,接入方先发起如下请求。 { "userid": "1528780879-9581", "inaction": 11, "inparams": { "call_id": "1528780879-9581", "call_dst_id": "10086", "begin_trans": "2018090407:16:24", "end_trans": "2018090407:20:24", "trans_result":"0", "input": "", "inter_idx": "1" }, "extparams": { "transin_data":"95,22714,0,,1,1,,test_gdj_01005" } } 在收到ODFS的响应后,则再次发起如下请求。 { "userid": "1528780879-9581", "inaction": 11, "inparams": { "call_id": "1528780879-9581", "call_dst_id": "10086", "begin_trans": "2018090407:16:24", "end_trans": "2018090407:20:24", "trans_result":"0", "input": "hangup", "inter_idx": "1" }, "extparams": { "transin_data":"95,22714,0,,1,1,,test_gdj_01005" } } 收到请求后,ODFS侧则再次返回拆线响应,接入方侧不需再调用ODFS侧接口,整个呼叫转移动作完成。如果呼叫转移失败传入上述参数后, 可能收到ODFS返回 outaction=9/10/11 类型的返回（由业务逻辑决定）

云客服对话接口

云客服-对话转接后请求（inaction=11）:响应消息样例1

响应消息样例1 { "userid": "1528780879-9581", "outaction": 9, "outparams": { "call_id": "1528780879-9581", "prompt_type": "1", "prompt_wav": "welcome", "prompt_text": "查询话费", "language": "0", "inter_idx": "1", "model_type":"1011201" "timeout": "10", "tone": "", "grammar": "", "question_id": "Q1", "question_name": "问题1", "answer_id": "Y" } }

云客服对话接口

云客服-对话转接后请求（inaction=11）:响应消息样例

响应消息样例 { "outaction": 12, "outparams": { "call_id": "1528780879-9581", "prompt_type": "1", "inter_idx": "1", "moduleName":"查询", "xxx":"xxx" //扩展 } }

云客服对话接口

云客服-对话转接后请求（inaction=11）:响应消息样例2

响应消息样例2 { "userid": "1528780879-9581", "outaction": 11, "outparams": { "call_id": "1528780879-9581", "call_sor_id": "13500000001", "calling_num":"1234567890", "trans_type": "1", "route_value": "123456789", "inter_idx": "1", "trans_idx": "1", "question_id": "Q1", "question_name": "问题1", "answer_id": "Y" } }

云客服对话接口

云客服-对话转接后请求（inaction=11）:inparams 参数

inparams 参数参数名称数据类型参数位置必选/可选描述 call_id String body True 呼叫唯一标志,与userid 取值相同，给流程使用。不超过64位 call_dst_id String body True 接入标识 1、语音导航场景传入流程接入码； 2、语音外呼问卷场景时为流程接入码； 3、其他交互场景时传入接入标识。不超过20位 begin_trans String body True 转移开始时间。 end_trans String body True 转移结束时间。 trans_result String body True 转移结果。 0：成功其他值：失败 auth_token String body True 授权信息,取接入控制系统返回的token值。请参见C3 智能助手平台接口鉴权方式。 record_result String body False 录音结果（仅当转接第三方号码成功时生效） 0：成功其他值：失败 input String body False 交互结果,（此参数请参考以下场景）当转移成功后,接入方的请求参数需要传入trans_result=0的参数,不需要input；此后接入方收到ODFS的拆线(outaction=10)的响应，需接入方再次发送此请求，且请求参数需要包含input参数，取值为hangup。 hangup：挂机不超过1024位 inter_idx String body False(语音导航场景特有字段) 交互次数，直接取上一次ODFS返回的inter_idx值即可。 mediaType String body False 媒体类型（文本、音频、视频... 例如：audio,video...） call_media_type String body False 呼入ivr的呼叫类型，文本：0 音频：1视频：3 channelType String body False 渠道类型 WEB（Web） INSTAGRAM（Instagram） TELEGRAM(Telegram) WECHAT(微信) FACEBOOK（Facebook） TWITTER（X (Twitter)） EMAIL（邮件） LINE WHATSAPP（WhatsApp） 5G（5G消息） SMS（短信）。说明：括号里为界面字段，区别于接口传参字段。

云客服对话接口

云客服-对话转接后请求（inaction=11）:响应消息样例3

响应消息样例3 { "userid": "1528780879-9581", "outaction": 10, "outparams": { "call_id": "1528780879-9581", "call_sor_id": "13500000001", "call_dst_id": "10086", "start_time": "2018090407:16:24", "end_time": "2018090407:30:24", "release_reason": "0", "region_id": "025", "entrance_id": "03", "exit_id": "05", "user_type_id": "01", "suilu_region_id":"025" } }

云客服对话接口

云客服-对话初始化接口（inaction=8）:响应消息样例3

响应消息样例3 { "outaction": 12, "outparams": { "call_id": "1528780879-9581", "prompt_type": "1", "inter_idx": "1", "moduleName":"查询", "xxx":"xxx" //扩展 } }

云客服对话接口（V2）

云服务器内容精选

对话接口

7*24

备案

专业服务

退订

建议反馈

售前咨询热线