华为云用户手册

  • 名词解释 基本概念、云服务简介、专有名词解释 弹性云服务器 ECS:是一种可随时自助获取、可弹性伸缩的云服务器,可帮助您打造可靠、安全、灵活、高效的应用环境,确保服务持久稳定运行,提升运维效率。 云硬盘 EVS:为云服务器提供高可靠、高性能、规格丰富并且可弹性扩展的块存储服务,可满足不同场景的业务需求,适用于分布式文件系统、开发测试、数据仓库以及高性能计算等场景。 弹性公网IP EIP:提供独立的公网IP资源,包括公网IP地址与公网出口带宽服务。可以与弹性云服务器、裸金属服务器、虚拟IP、弹性负载均衡、NAT网关等资源灵活地绑定及解绑。 mRemoteNG: 一个用于 Windows 的开源、选项卡式、多协议、远程连接管理器,可以在简单而强大的选项卡式界面中查看所有远程连接。具体操作请参考mRemoteNG帮助文档。
  • 资源和成本规划 该解决方案主要部署如下资源,不同产品的花费仅供参考,实际以收费账单为准,具体请参考华为云官网价格: 表1 资源和成本规划-弹性云服务器部署(包年包月) 华为云服务 配置示例 每月花费 云耀云服务器 区域:华北-北京四 计费模式:包年/包月 规格:X86计算 | HECS | x.medium.2 | 1vCPUs | 2GiB 镜像:Windows Server 2012 R2 标准版 64位简体中文 系统盘:高IO | 40GB 购买量:1 78.98元 弹性公网IP 区域:华北-北京四 计费模式:包年/包月 线路:动态BGP 公网带宽:按带宽计费 带宽大小:1Mbit/s 购买量:1 23.00元 合计 - 101.98元
  • 资源和成本规划 该解决方案主要部署如下资源,以下花费仅供参考,具体请参考华为云官网价格详情,实际收费以账单为准: 表1 资源和成本规划 华为云服务 计费说明 每月花费(调用1000次) 文字识别服务 增值税发票识别: 0.18元/次 发票验真:0.23元/次 410元 对象存储服务 数据存储(多AZ存储):0.1390元/GB/月 请求费用:0.0100元/万次 预计每月新增1GB数据量,花费0.1390元。 该方案存储费用消耗较低,详细请参考每月账单。 函数工作流 请求次数0-100万次/月:免费 计量时间:0-400,000 GB/秒:免费 节点执行次数:0-5000次:免费 0 总计: - 约410.14元
    AI
  • 名词解释 基本概念、云服务简介、专有名词解释: 文字识别服务 OCR:文字识别(Optical Character Recognition,简称OCR)是指将图片、扫描件或PDF、OFD文档中的打印字符进行检测识别成可编辑的文本格式,以JSON格式返回识别结果。 对象存储服务 OBS:对象存储服务(Object Storage Service,OBS)是一个基于对象的海量存储服务,为客户提供海量、安全、高可靠、低成本的数据存储能力。 函数工作流FunctionGraph:FunctionGraph是一项基于事件驱动的函数托管计算服务。使用FunctionGraph函数,只需编写业务函数代码并设置运行的条件,无需配置和管理服务器等基础设施,函数以弹性、免运维、高可靠的方式运行。此外,按函数实际执行资源计费,不执行不产生费用。
    AI
  • 快速部署 本章节主要指导用户如何自动化部署“文字识别-发票识别与验真”解决方案。 表1 参数说明 参数名称 类型 是否可选 参数解释 默认值 image_bucket_name string 必填 OBS桶名称,全局唯一,用于上传发票图片或PDF文件。取值范围:3~63个字符,支持小写字母、数字、中划线(-)、英文句号(.)。 空 result_bucket_name string 必填 OBS桶名称,全局唯一,用于存放发票识别结果。取值范围:3~63个字符,支持小写字母、数字、中划线(-)、英文句号(.)。 空 登录华为云解决方案实践,选择"文字识别-发票识别与验真",单击“一键部署”,跳转至解决方案创建堆栈界面。 图1 解决方案实践 在选择模板界面中,单击“下一步”。 图2 选择模板 在配置参数界面中,参考表1 参数说明完成自定义参数填写,单击“下一步”。 图3 配置参数 在资源设置界面中,在权限委托下拉框中选择“rf_admin_trust”委托,单击“下一步”。 图4 资源栈设置 在配置确认界面中,单击“创建执行计划”。 图5 配置确认 在弹出的创建执行计划框中,自定义填写执行计划名称,单击“确定”。 图6 创建执行计划 单击“部署”,并且在弹出的执行计划确认框中单击“执行”。 图7 执行计划 图8 执行计划确认 待“事件”中出现“Apply required resource success”,表示该解决方案已经部署完成。 图9 部署完成 父主题: 实施步骤
    AI
  • 通过华为云控制台使用 登录华为云对象存储服务控制台,查看自动创建的OBS桶列表: 图1 对象存储服务控制台 选择用于上传和存储发票图片或者PDF文件的桶“ocr-image-bucket-demo”,上传示例发票图片或者电子发票pdf文件: 图2 上传待识别发票 选择用于存放结果的“ocr-result-bucket-demo”桶,即可自动获取该发票的识别与验真结果,以发票文件名称为前缀的JSON文件存储: 图3 获取识别结果文件
    AI
  • 结果示例 示例发票:(注:本示例发票不能用于测试) 图4 示例发票 发票识别与验真结果如下所示,'status'字段为'valid',表示该发票有效,返回参数的详细介绍,请参见华为云官网API参考: {'type': 'vat_normal_electronic','code': '033XXXXXXXXX','number': '658XXXXX','issue_date': '20201127','machine_number': '499XXXXXXXXX','check_code': '059XXXXXXXXXXXXX','status': 'valid','subtotal_amount': '46.50','subtotal_tax': '0.00','total': '46.50','total_in_words': '肆拾陆元伍角','remarks': '','receiver': '','issuer': '','reviewer': '','buyer_name': '华XXXXXXXXX','buyer_id': '914XXXXXXXXXXXXXX','buyer_address': '','buyer_bank': '','seller_name': '福建XXXXXXXXXXXXXXXXXXX','seller_id': '913XXXXXXXXXX','seller_address': '浙江省杭州市XXXXXXXXXXXXXXXXXXX','seller_bank': '浦发银行XXXXXXXXXXXXXXXX','deductible_toll': 'N', 'items':[{'name': '*运输服务*客运服务费','specification': '无','unit': '次','quantity': '1','unit_price': '46.50','amount': '46.50','tax_rate': '0.00','tax': '0.00','license_plate_number': '','vehicle_type': '','start_date': '','end_date': ''}],'result_code': '1000','result_message': 'The invoice verification information is consistent with the tax authority’s information.'}
    AI
  • 接口URI https://ip:port/agentgateway/resource/calldata/{agentid}/appdata?isEncodeResult={isEncodeResult}&callId={callId} 其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号,取值范围:101~59999。 2 isEncodeResult boolean False 查询到的呼叫数据是否经过base64编码。取值范围: true:查询到的呼叫数据经过了base64编码 false:查询到的呼叫数据没有经过base64编码 true以外的参数都作为false处理。 说明: Base64是一种编码方式,不是加密算法,不能用作任何敏感信息的加密用途。 3 callid string False 被查询呼叫ID。多媒体会话时为必传。
  • 响应消息样例5 { "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" }}
  • 响应消息样例4 { "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" }}
  • outparams参数(outaction=10:对话拆线类操作) 注:一通会话结束,都要以IVR发起inaction=9/11且input=hangup的请求后,ODFS触发拆线响应,返回给IVR后为结束标记,IVR此后不再调用ODFS的接口。 参数名称 数据类型 参数位置 必选/可选 描述 call_id String body True 呼叫唯一标志,与userid 取值相同,给流程使用。 call_sor_id String body True 用户标识。(语音导航、语音外呼场景传入用户号码,其他交互场景传入用户id) call_dst_id String body True 接入标识 (1、语音导航场景传入被叫号码; 2、语音外呼问卷场景时为问卷类型id; 3、其他交互场景时传入接入标识)。 start_time String body True 对话交互开始时间 end_time String body True 对话交互结束时间。 release_reason String body False odfs流程走到结束图元是否是正常流程逻辑 0、正常业务逻辑进入结束图元; 1、流程遇到异常、超时等没有容错业务逻辑处理时走到结束图元。 region_id String body False(语音导航场景特有字段) 用户归属地。 entrance_id String body False(语音导航场景特有字段) 入口维度。 exit_id String body False(语音导航场景特有字段) 出口维度,取值同入口维度。 user_type_id String body False(语音导航场景特有字段) 用户类型。 suilu_region_id String body False(语音导航场景特有字段) 呼叫接入地。
  • 响应消息样例2 { "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" }}
  • outparams参数(outaction=12:查询类操作,用于普通IVR流程) 参数名称 数据类型 参数位置 必选/可选 描述 call_id String body True 呼叫唯一标志,与userid 取值相同,给流程使用。 prompt_type String body True 查询类型。 1:通话在技能队列中排队时,查询当前技能队列排队信息; 2:通话不在技能队列排队,进入技能队列前,根据技能队列Id查询排队信息; 3:根据座席工号,查询座席所在技能队列信息 5: 音视频切换操作 skill_id String String False 技能队列Id。 prompt_type为2的场景,必填;其他场景无该参数。 moduleName String body False 模块名称,图元的名称 inter_idx String body False(语音导航场景特有字段) ODFS侧记录的与用户连续交互的次数。
  • outparams参数(outaction=11:对话转接类操作) 参数名称 数据类型 参数位置 必选/可选 描述 call_id String body True 呼叫唯一标志,与userid 取值相同,给流程使用。 call_sor_id String body True 用户标识。(语音导航、语音外呼场景传入用户号码,其他交互场景传入用户id) trans_type String body True 对话转移类型 1:转人工(路由码方式转技能队列) 2:转IVR 3:转人工(技能名称方式转技能队列) 4:转人工(转座席工号) 5:转接第三方号码 6:在线数字辅助 7:转人工(转熟客,目前仅支持多媒体) 8:转人工(转座席所在技能队列,目前仅支持多媒体) 31:转多媒体留言(转熟客) 32:转多媒体留言(转技能队列) 33:转多媒体留言(转座席) route_value String body True 路由值信息,依赖trans_type取值,当trans_type= 如下值时: 1,route_value=技能队列后续接入码 2,route_value=IVR流程接入码 3,route_value=技能队列名称 4,route_value=座席工号 5,route_value=第三方号码 6,流程路由码 7,无 8,座席工号 31,无 32,技能队列名称或者接入码 33,座席工号 trans_data String body False 随路数据(转人工时传递) calling_num String body False 呼叫转移第三方号码时,优先使用此号码作为主叫号码 record_path String body False 录音全路径名(仅当route_value=第三方号码时生效,启动会场录音,当为空或不存在时则不录音) inter_idx String body False(语音导航场景特有字段) ODFS侧记录的与用户连续交互的次数。 trans_idx String body O(语音导航场景特有字段) 跳转序数。 question_id String body False(语音外呼问卷场景特有字段) 问题id(外呼场景使用)(废弃) question_name String body False(语音外呼问卷场景特有字段) 问题名称(外呼场景使用)(废弃) answer_id String body False(语音外呼问卷场景特有字段) 问题答案(外呼场景使用)(废弃)
  • inparams 参数 参数名称 数据类型 参数位置 必选/可选 描述 call_id String body True 呼叫唯一标志,与userid 取值相同,给流程使用。 不超过64位 call_sor_id String body True 用户标识。(语音导航、语音外呼场景传入用户号码,其他交互场景传入用户id) 不超过64位 call_dst_id String body M 接入标识 1、语音导航场景传入流程接入码; 2、语音外呼问卷场景时为流程接入码; 3、其他交互场景时传入接入标识。 不超过20位 real_callee String body False 实际接入IVR时的被叫号码,当语音导航场景下有效 不超过32位 cti_callid String body False(语音导航场景特有字段) 华为ivr传入的实际呼叫的CTI的callid,其他场景此值为空 不超过32位 auth_token String body True 授权信息,取接入控制系统返回的token值。 请参见C3 智能助手平台接口鉴权方式。 suilu_region_id String body False(语音导航场景特有字段) 呼入地。 不超过64位 entrance_id String body False(语音导航场景特有字段) 导航入口。 01:广告语 02:欢迎语 03:首层主菜单 04:人工拦截 05:人工座席 06:直接通过短号接入 07:全语音门户 08:“0”号夜间导航模式 09:夜间全语音门户 10:直接通过自助短号接入 11:人工忙碌 98:其他 99:未识别 mediaType String body False 媒体类型(文本,音频,视频...) channelType String body False 渠道类型 WEB INSTAGRAM TELEGRAM WECHAT FACEBOOK TWITTER EMAIL LINE WHATSAPP 5G SMS responseStyle String body False 回复风格
  • 请求消息样例1 { "userid": "1528780879-9581", "inaction": 8, "inparams": { "call_id": "1528780879-9581", "call_sor_id": "13500000001", "call_dst_id": "10086", "auth_token":"eyJhbGc*******************MjUzNSwian", "suilu_region_id": "025", "entrance_id": "03" }, "extparams": { "transin_data":"95,22714,0,,1,1,,test_gdj_01005" }}
  • outparams参数(outaction=9:对话交互类操作) 参数名称 数据类型 参数位置 必选/可选 描述 prompt_type String body True 交互类型。 0:语音交互播放指定提示音(全路径) 1:语音交互播放指定提示 2:语音交互播放TTS内容 3:文字交互 4:对呼叫方录音 5:视频播放 6:多媒体 7:卡片 prompt_wav String body False(语音导航场景特有字段) 当prompt_type=0,4,5 时填播放或录音的文件全路径名(必须保证为UAP可读取的路径); 当prompt_type=1 时填语音文件名(不包含路径头,播放时由IVR拼接路径头) prompt_text String body True TTS动态文本内容/文字对话内容, 当prompt_type为2、3、6、7时必填 language String body True 语种id(TTS放音以及ASR识别必须传) 0:中文 1:英文 inter_idx String body False(语音导航场景特有字段) ODFS侧记录的与用户连续交互的次数。 model_type String body O(语音导航场景特有字段) 模板类型,由7位数字组成,前三位分别代表放音\识别\按键的支持情况(对于放音:1表示支持,0表示不支持;对于识别/按键,1表示支持且会打断放音,2表示支持且不打断放音,0表示不支持);紧接着两位代表最大按键长度,,后两位是*#是否做为功能键(1功能键-#代表确定,*代表取消,0不作为功能键-普通输入键)。 如:1011201代表支持放音按键,不支持识别,最大按键长度为12位,#为确认键。 1101200 代表支持放音识别,不支持按键,后面四位1200无效。 timeout String body False(语音导航场景特有字段) 放音超时时长(秒),放音结束后等待输入超时时间。 tone String body False(语音导航场景特有字段) 当prompt_type=4 录音时必传 true:录音开始前播放“嘀”音 false:录音开始前不播放“嘀”音 vendor String body False(语音导航场景特有字段) 语音识别扩展参数 grammar String body False(语音导航场景特有字段) 语法文件名(包含路径和后缀) question_id String body False(语音外呼问卷场景特有字段) 问题序号(外呼场景使用),如Q1,Q2;(废弃) question_name String body False(语音外呼问卷场景特有字段) 问题名称(外呼场景使用) (废弃) answer_id String body False(语音外呼问卷场景特有字段) 问题答案(外呼场景使用), 是:Y; 否:N; 超时:TIMEOUT; 拒识:NOMATCH; 其他异常:ERROR 如问题设定非“是”“否”这种答案,则需要以实际约定配置的结果为准 (废弃) flowRecordFlag String body False 是否需要录音标志。 0:需要 1:不需要 不设置的场景,默认为1 flowRecordPath String body False 需要录音时返回录音文件的路径。 ttsGroupId String body False TTS服务器在Uap上配置的GroupId ttsSoundEffect String body False TTS声效 男生朗读:0 女生朗读:1; ttsSoundSpeed String body False TTS音速: 低速朗读:0; 中速朗读:1; 高速朗读:2 ttsMRCPVendor String body False TTS扩展参数,即它的mrcp vendor参数,当前最大长度40 asrMRCPId String body False ASR服务器在Uap上配置的MRCPId asrSlotName String body False 解析ASR识别槽位使用的关键字 asrRecognizeType String body False ASR识别类型 普通识别:0; 智能识别:1 asrNoInputTimeout String body False 用户无话超时时长,默认100,单位s asrRecognitionTimeout String body False 识别结果超时时长,默认200,单位s asrSpeechCompleteTimeout String body False 用户停顿超时长,默认500,单位s responseSource int body False 回复来自机器人还是静默座席,机器人--0,静默座席--1 specialRecognize int body False 是否使用抓包录制的识别 原始识别--0,抓包录制识别--1 Prompt_text格式说明【for 智能信息匹配业务】 参数名称 数据类型 参数位置 必选/可选 Value描述 来源 sensitive_word Json Object body False 敏感词的提醒信息 {"违禁语":["密码"]} TUC敏感词配置 Intend String body True 客户意图 说明文本 TUC意图 recomand_KP List body False 推荐知识点信息 业务知识库 call_script Json String body True 话术推荐 说明: intentcode是TUC意图码,允许为空;intentDsp是意图描述,不能为空 { {intentcode:“”, intentDsp:“”,"status":"",childintent[{intentcode:“”, intentDsp:“”,"status":""},{intentcode:“”, intentDsp:“”, "status":""}…]} { intentcode:“”, intentDsp:“”, "status":""} } ODFS资源模板配置 call_script_matchedstep String body False 意图码 对应上述call_script中的意图码 表示话术进展(被匹配的步骤) TUC意图 Prompt_text格式说明【for 智能工单填写业务】 参数名称 数据类型 参数位置 必选/可选 描述 使用方法 beginIndex String body True 实体在文本中的开始索引位置 实体在文本中的开始索引位置 endIndex String body True 实体在文本中的结束索引位置 实体在文本中的结束索引位置 type String body True 抽取的实体类型 用于标注此实体的识别类型,不需要填入表单 entity String body True 实体内容,已做规则化 用于填入表单对应字段 tag String body True 表单中待填写的字段名 如:对象二级
  • ExtParams参数 参数名称 数据类型 参数位置 必选/可选 描述 transin_data String body False 由接入方跟OIAP约定的随路数据参数,例如IVR传入的数据包参数 locationid String body O 呼叫录音节点号 mediaability String body False 媒体能力 1:音频 2:视频 3:音视频 ieValue String body False 接入方跟OIAP约定的随路数据参数,使用场景为:在与其他的平台对接时,如果呼叫是从其他的第三方的平台转移过来的呼叫,使用该参数携带呼叫信息。 注意:在OIAP的流程中,该参数的取值将会匿名化处理。
  • 请求说明 表1 请求体参数 参数名称 数据类型 参数位置 必选/可选 描述 tenantId String body True 租户ID authToken String body True 访问接口的有效Token值。 有效Token信息通过获取Token接口获取。 请参见C3 智能助手平台接口鉴权方式。 beginTime String body False 开始时间 格式: yyyy-MM-dd HH:mm:ss endTime String body False 结束时间 格式: yyyy-MM-dd HH:mm:ss pageNum String body False 页码 分页查询,查询第几页,首页为1 不传,默认页码为1 pageSize String body False 每页多少条 可配置:5,10,20,50,100 不传,默认一页100条 callId String body False 流程呼叫ID (userMobile、callId和ctiCallId需要传其中一个) userMobile String body False 用户号码(userMobile、callId和ctiCallId需要传其中一个) ctiCallId String body False 平台呼叫ID (userMobile、callId和ctiCallId需要传其中一个)
  • 响应说明 表2 响应体参数 参数名称 数据类型 参数位置 必选/可选 描述 errorCode int body True 错误码 0表示成功 非0表示失败 errorMessage String body True 错误描述 total long body False 总条数 transferRecordList transferRecord[] body False 返回转接记录列表(数组结构)
  • 报文样例 请求消息样例 {"authToken": "P********************oN1ix","tenantId": "202204017094", "beginTime":"2022-02-21 20:04:38", "endTime":"","pageNum": "1","pageSize": "5","callId": "1648805538-165717321823298","userMobile": "","ctiCallId": ""} 响应消息样例 { "errorCode": 0, //接口成功失败标识 "errorMessage": "success!",//接口成功失败描述 "total": 1,//总数 "transferRecordList": [ { "id": "202204013156893697", "tenantId": "202204017094", "callId": "1648805538-165717321823298", "ctiCallId": "1648805538-1657", "flowInstId": "88880301202204011732186311648805538-165717321823298", "callingNumber": "88880301", "calledNumber": "30502", "transfNumber": "88880302", "startTime": 1648805539000, "endTime": 1648805558000, "recordFilePath": "Y:/61/transferrecord/20220401/77448039.wav", "locationId": "0", "opResult": "SUCCESS", "recordResult": "N/A" } ]}
  • 响应消息样例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" }}
  • outparams参数(outaction=10:对话拆线类操作) 注:一通会话结束,都要以IVR发起inaction=9/11且input=hangup的请求后,ODFS触发拆线响应,返回给IVR后为结束标记,IVR此后不再调用ODFS的接口。 参数名称 数据类型 参数位置 必选/可选 描述 call_id String body True 呼叫唯一标志,与userid 取值相同,给流程使用。 call_sor_id String body True 用户标识。(语音导航、语音外呼场景传入用户号码,其他交互场景传入用户id) call_dst_id String body True 接入标识 (1、语音导航场景传入被叫号码; 2、语音外呼问卷场景时为问卷类型id; 3、其他交互场景时传入接入标识)。 start_time String body True 对话交互开始时间 end_time String body True 对话交互结束时间。 release_reason String body O odfs流程走到结束图元是否是正常流程逻辑 0、正常业务逻辑进入结束图元; 1、流程遇到异常、超时等没有容错业务逻辑处理时走到结束图元。 region_id String body O(语音导航场景特有字段) 用户归属地。 entrance_id String body O(语音导航场景特有字段) 入口维度。 exit_id String body O(语音导航场景特有字段) 出口维度,取值同入口维度。 user_type_id String body False(语音导航场景特有字段) 用户类型。 suilu_region_id String body False(语音导航场景特有字段) 呼叫接入地。
  • 响应消息样例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" }}
  • outparams参数(outaction=12:查询类操作,用于普通IVR流程) 参数名称 数据类型 参数位置 必选/可选 描述 call_id String body True 呼叫唯一标志,与userid 取值相同,给流程使用。 prompt_type String body True 查询类型。 1:通话在技能队列中排队时,查询当前技能队列排队信息; 2:通话不在技能队列排队,进入技能队列前,根据技能队列Id查询排队信息; 3:根据座席工号,查询座席所在技能队列信息 5: 音视频切换操作 skill_id String String False 技能队列Id。 prompt_type为2的场景,必填;其他场景无该参数。 moduleName String body False 模块名称,图元的名称 inter_idx String body False(语音导航场景特有字段) ODFS侧记录的与用户连续交互的次数。
  • outparams参数(outaction=11:对话转接类操作) 参数名称 数据类型 参数位置 必选/可选 描述 call_id String body True 呼叫唯一标志,与userid 取值相同,给流程使用。 call_sor_id String body True 用户标识。(语音导航、语音外呼场景传入用户号码,其他交互场景传入用户id) trans_type String body True 对话转移类型 1:转人工(路由码方式转技能队列) 2:转IVR 3:转人工(技能名称方式转技能队列) 4:转人工(转座席工号) 5:转接第三方号码 6:在线数字辅助 7:转人工(转熟客,目前仅支持多媒体) 8:转人工(转座席所在技能队列,目前仅支持多媒体) 31:转多媒体留言(转熟客) 32:转多媒体留言(转技能队列) 33:转多媒体留言(转座席) route_value String body True 路由值信息,依赖trans_type取值,当trans_type= 如下值时: 1,route_value=技能队列后续接入码 2,route_value=IVR流程接入码 3,route_value=技能队列名称 4,route_value=座席工号 5,route_value=第三方号码 6,流程路由码 7,无 8,座席工号 31,无 32,技能队列名称或者接入码 33,座席工号 trans_data String body False 随路数据(转人工时传递) calling_num String body False 呼叫转移第三方号码时,优先使用此号码作为主叫号码 record_path String body False 录音全路径名(仅当route_value=第三方号码时生效,启动会场录音,当为空或不存在时则不录音) inter_idx String body False(语音导航场景特有字段) ODFS侧记录的与用户连续交互的次数。 trans_idx String body O(语音导航场景特有字段) 跳转序数。 question_id String body False(语音外呼问卷场景特有字段) 问题id(外呼场景使用)(废弃) question_name String body False(语音外呼问卷场景特有字段) 问题名称(外呼场景使用)(废弃) answer_id String body False(语音外呼问卷场景特有字段) 问题答案(外呼场景使用)(废弃)
  • 响应消息样例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" }}
  • outparams参数(outaction=9:对话交互类操作) 参数名称 数据类型 参数位置 必选/可选 描述 prompt_type String body True 交互类型。 0:语音交互播放指定提示音(全路径) 1:语音交互播放指定提示 2:语音交互播放TTS内容 3:文字交互 4:对呼叫方录音 5:视频播放 6:多媒体 7:卡片 prompt_wav String body False(语音导航场景特有字段) 当prompt_type=0,4,5 时填播放或录音的文件全路径名(必须保证为UAP可读取的路径); 当prompt_type=1 时填语音文件名(不包含路径头,播放时由IVR拼接路径头) prompt_text String body True TTS动态文本内容/文字对话内容, 当prompt_type为2、3、6、7时必填 language String body True 语种id(TTS放音以及ASR识别必须传) 0:中文 1:英文 inter_idx String body False(语音导航场景特有字段) ODFS侧记录的与用户连续交互的次数。 model_type String body False(语音导航场景特有字段) 模板类型,由7位数字组成,前三位分别代表放音\识别\按键的支持情况(1支持,0不支持);紧接着两位代表最大按键长度,,后两位是*#是否做为功能键(1功能键-#代表确定,*代表取消,0不作为功能键-普通输入键)。 如:1011201代表支持放音按键,不支持识别,最大按键长度为12位,#为确认键。 1101200 代表支持放音识别,不支持按键,后面四位1200无效。 timeout String body False(语音导航场景特有字段) 放音超时时长(秒),放音结束后等待输入超时时间。 tone String body False(语音导航场景特有字段) 当prompt_type=4 录音时必传 true:录音开始前播放“嘀”音 false:录音开始前不播放“嘀”音 vendor String body False(语音导航场景特有字段) 语音识别扩展参数 grammar String body False(语音导航场景特有字段) 语法文件名(包含路径和后缀) question_id String body False(语音外呼问卷场景特有字段) 问题序号(外呼场景使用),如Q1,Q2;(废弃) question_name String body False(语音外呼问卷场景特有字段) 问题名称(外呼场景使用) (废弃) answer_id String body False(语音外呼问卷场景特有字段) 问题答案(外呼场景使用), 是:Y; 否:N; 超时:TIMEOUT; 拒识:NOMATCH; 其他异常:ERROR 如问题设定非“是”“否”这种答案,则需要以实际约定配置的结果为准 (废弃) flowRecordFlag String body False 是否需要录音标志。 0:需要 1:不需要 不设置的场景,默认为1 flowRecordPath String body False 需要录音时返回录音文件的路径。 ttsGroupId String body False TTS服务器在Uap上配置的GroupId ttsSoundEffect String body False TTS声效 男生朗读:0 女生朗读:1; ttsSoundSpeed String body False TTS音速: 低速朗读:0; 中速朗读:1; 高速朗读:2 ttsMRCPVendor String body False TTS扩展参数,即它的mrcp vendor参数,当前最大长度40 asrMRCPId String body False ASR服务器在Uap上配置的MRCPId asrSlotName String body False 解析ASR识别槽位使用的关键字 asrRecognizeType String body False ASR识别类型 普通识别:0; 智能识别:1 asrNoInputTimeout String body False 用户无话超时时长,默认100,单位s asrRecognitionTimeout String body False 识别结果超时时长,默认200,单位s asrSpeechCompleteTimeout String body False 用户停顿超时长,默认500,单位s responseSource int body False 回复来自机器人还是静默座席,机器人--0,静默座席--1 specialRecognize int body False 是否使用抓包录制的识别 原始识别--0,抓包录制识别--1 Prompt_text格式说明【for 智能信息匹配业务】 参数名称 数据类型 参数位置 必选/可选 Value描述 来源 sensitive_word Json Object body False 敏感词的提醒信息 {"违禁语":["密码"]} TUC敏感词配置 Intend String body True 客户意图 说明文本 TUC意图 recomand_KP List body False 推荐知识点信息 业务知识库 call_script Json String body True 话术推荐 说明: intentcode是TUC意图码,允许为空;intentDsp是意图描述,不能为空 { {intentcode:“”, intentDsp:“”,"status":"",childintent[{intentcode:“”, intentDsp:“”,"status":""},{intentcode:“”, intentDsp:“”, "status":""}…]} { intentcode:“”, intentDsp:“”, "status":""} } ODFS资源模板配置 call_script_matchedstep String body False 意图码 对应上述call_script中的意图码 表示话术进展(被匹配的步骤) TUC意图 Prompt_text格式说明【for 智能工单填写业务】 参数名称 数据类型 参数位置 必选/可选 描述 使用方法 beginIndex String body True 实体在文本中的开始索引位置 实体在文本中的开始索引位置 endIndex String body True 实体在文本中的结束索引位置 实体在文本中的结束索引位置 type String body True 抽取的实体类型 用于标注此实体的识别类型,不需要填入表单 entity String body True 实体内容,已做规则化 用于填入表单对应字段 tag String body True 表单中待填写的字段名 如:对象二级
  • 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...) channelType String body False 渠道类型 WEB INSTAGRAM TELEGRAM WECHAT FACEBOOK TWITTER EMAIL LINE WHATSAPP 5G SMS
  • 请求消息样例 如果呼叫转移成功,接入方先发起如下请求。 { "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 类型的返回(由业务逻辑决定)
共100000条