语音通话
用户指南
文档版本 1
发布日期 2022-02-10
版权所有 © 华为技术有限公司 2022。 保留一切权利。
非经本公司书面许可,任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部,并不得以任何形式传 播。
商标声明
和其他华为商标均为华为技术有限公司的商标。
本文档提及的其他所有商标或注册商标,由各自的所有人拥有。
注意
您购买的产品、服务或特性等应受华为公司商业合同和条款的约束,本文档中描述的全部或部分产品、服务或 特性可能不在您的购买或使用范围之内。除非合同另有约定,华为公司对本文档内容不做任何明示或暗示的声 明或保证。
由于产品版本升级或其他原因,本文档内容会不定期进行更新。除非另有约定,本文档仅作为使用指导,本文 档中的所有陈述、信息和建议不构成任何明示或暗示的担保。
目 录
1 开通服务...1
2 添加应用...4
3 添加企业...8
4 订购号码...10
5 退订号码...11
6 添加放音文件...13
7 添加语音模板...14
8 修改企业话术...15
9 业务测试...17
10 联系人管理... 19
11 业务详单... 21
12 业务统计... 22
13 权限管理... 24
13.1 创建用户并授权使用通信云服务... 24
用户指南 目 录
1
开通服务
感谢您对语音通话服务的信任,请使用通过实名认证的企业账号登录华为云。
1. 访问语音通话服务产品首页,点击“立即使用”进入“开通语音通话服务”页 面。
您也可以直接访问“开通语音通话服务”页面。
2. 勾选“我已阅读并同意《语音通话服务使用声明》”,然后点击“立即申请”。
3. 进入调研表页面,请根据您的业务实际使用情况填写调研表。
用户指南 1 开通服务
填写完成点击“立即开通”,完成开通服务。
名称 说明
业务类型 请根据实际使用情况选择。
企业联系人姓名 请填写企业联系人姓名。
联系邮箱 请填写您的有效邮箱,华为云能通过该信息联系您。
联系电话 请填写您的单位电话或手机,华为云能通过该信息联系 您。
企业名称 填写全称并和营业执照的名称保持一致。
用户指南 1 开通服务
名称 说明
使用话术 需要大概描述话术,请根据实际情况填写。
企业性质 请根据实际情况选择。
● 渠道:封装能力为下级客户提供服务,场景多样化。
● SaaS:自研系统或软件中使用语音通话功能,且不独 立售卖,仅作为增值能力。
● 直客:仅自用业务使用,且业务场景单一。
所属行业 请根据实际情况选择行业,选择其他时请填写具体行业。
预估日通话分钟 请根据实际情况选择。
是否使用过同类产 品
请根据实际情况选择。
业务承载方 请选择填写业务承载方和其具体信息。
● APP:填写APP名称。
● 小程序:填写小程序名称。
● 网站:填写网站,示例:www.yourwebsite.com。
● 公众号:填写公众号名称。
● H5界面:填写产品名称。
● 其他:填写具体名称。
4. 业务的开通申请将在1~2个工作日审核完成,请耐心等待审核结果。
5. 服务开通后您会收到短信通知,后续根据业务使用进行扣费,若费用不够,请及 时在华为云账户中充值。具体可参考如何给账户充值。
注:如果您后期想开通语音通话平台提供的其他服务,点击控制台-总览-业务类型管 理。
根据您要开通的服务类型,“操作”列选择“去开通”,即可进入调研表页面,请根 据您的业务实际使用情况填写调研表。
用户指南 1 开通服务
2
添加应用
语音通话应用是用户使用华为云语音通话服务的载体。请根据您所开展的业务,填写 应用信息:
说明
● 语音通话服务默认可添加5个应用。
● 应用添加成功后将无法删除且无法修改“业务类型”。
1. 请登录并进入语音通话控制台。
2. 进入“应用管理”页面,点击“添加应用”。
3. 按照页面提示填写应用信息。
– 应用名称:用户自定义。可以包含中文、英文字母、数字、下划线,不能包 含空格,最大长度为64个字符。
– 业务类型:请根据实际业务场景选择。点此了解各个模式
注:选择业务类型后,若有以下提示,请根据提示执行不同的操作。没有提 示请忽略。
提示 说明
您尚未开通权限,去 开通
添加应用的业务类型与开通服务时调研表的业务类 型不一致,请点击链接跳转到语音通话开通服务调 研表页面,填写完成后点击“立即开通”。
业务需审核(1个工作日),请等待审核通过后再 添加应用。
您的权限申请还在审 核中,请等待
已在语音通话开通服务调研表页面申请开通权限,
运营经理审核中,请耐心等待审核结果(1个工作 日)。
您的权限申请已被驳 回,驳回原因:xxx,
去修改
语音通话开通服务调研表页面的某些内容不符合规 范,请点击链接跳转到语音通话开通服务调研表页 面后按要求修改,修改完成后点击“立即开通”,
等待审核通过后(1个工作日)再添加应用。
用户指南 2 添加应用
提示 说明 您的权限已被取消,
重新提交
请联系运营经理确认具体情况。确认完成后点击链 接跳转到语音通话开通服务调研表页面,填写完成 后点击“立即开通”。
业务需审核(1个工作日),请等待审核通过后再 添加应用。
– 是否开通录音:
▪
“是否开通录音”选择“是”,并在调用语音通话接口时设置了录音参 数,语音通话才会被录音。(已开通录音的应用无法进行“是否开通录 音”的修改)▪
“是否开通录音”选择“否”,后续使用应用时若想修改此项,可在该 应用对应的“操作”列点击“修改”,“是否开通录音”选择“是”即 可。– 是否开通语音质检:
▪
该参数仅在“是否开通录音”选择“是”时出现。▪
只有此处选择“是”,才会开启应用的语音质检功能。点此了解语音质 检功能▪
为保证业务合规运营,防止业务违规造成关停,建议您开通语音质检功 能。我们会充分尊重您的隐私,并遵从华为云《隐私政策声明》。– 随机抽检录音提示音:用于指定个性化随机抽检录音提示音。
▪
该参数仅在“是否开通录音”和“是否开通语音质检”都选择“是”时 出现。▪
需提前在放音文件管理页面上传并审核通过才可使用。若不设置,则选 择“不播放提示音”。– 呼叫状态接收地址&呼叫话单接收地址:用于接收语音通话平台推送的呼叫状 态或话单的URL地址。
▪
可填写为http://IP:Port或域名,推荐使用域名,支持http和https。▪
请确保提供的地址正确,且地址前后不要有多余的空格和回车。– 被授权通知接收地址:用于接收语音通知业务被授权应用的通知信息的URL 地址。如果需要接收被授权通知,则必须填写该地址。
请确保提供的地址正确,且地址前后不要有多余的空格和回车。
– 企业项目:已开通企业项目,才有该选项。用于设置应用所属的企业项目。
若已开通企业管理但无企业项目要求,可选择默认企业项目。点此了解企业 管理
用户指南 2 添加应用
注意
企业项目的项目类型分为“商用生产项目”和“测试类项目”,若您的资源 是按合同商务扣费,请选择“商用生产项目”类型的企业项目。
● 已创建的企业项目的类型可进入项目管理页面查看。
● 若已选择“测试类项目”,请参考测试类项目转商用生产项目将测试类项 目转为商用生产项目。
4. 点击“确定”。
应用创建后,可以在应用管理页中查看应用信息,修改应用和添加应用授权。
说明
当“是否开通语音质检”由“是”改为“否”时,需要运营经理审核且审核通过后才能生 效,请点击“确认”后耐心等待审核结果。审核结果请在应用详情(点击应用名称左侧的
)中查看,如果审核通过,则“是否开通语音质检”显示为“否”,否则仍显示为
“是”。
用户指南 2 添加应用
5. 导出应用信息
进入应用管理页面,根据业务类型、应用名称、创建时间、状态,按需筛选,点
击页面右上角的 按钮导出相关应用信息。
用户指南 2 添加应用
3
添加企业
添加应用后,需要补充完善企业认证信息(已通过华为云企业实名认证的用户仍需添 加企业认证信息),可按照以下步骤进行操作:
1. 请登录并进入语音通话控制台。
2. 进入“企业管理”页面,点击页面右上角的“添加企业”按钮。
3. 弹出“授权声明”提示框,请点击“同意”进入下一步操作(若点击“不同 意”,则操作失败,即无法使用语音通话服务)。
4. 进入“添加企业”页面,请根据您的业务的预计使用情况填写企业相关信息,详 细可参考企业资质审核标准。若对填写内容有疑问,请联系您的客户经理确认。
– 若您的业务类型是语音回呼、语音通知、语音验证码,请按下图所示内容填 写企业相关信息。
申请固话号码,请先下载申请函和承诺书模板,填写完成并加盖公章后上 传。
用户指南 3 添加企业
说明
如果您需要为子企业添加业务,可点击“选择已有企业”项进行选择;如果您需要新增企 业,可直接在文本框中填写企业名称。
5. 点击“提交”,完成添加企业。
6. 等待审核结果。
审核一般需要2个工作日,您可在“企业管理”页面查看审核结果。
说明
只有审核通过的企业才可以订购号码。
7. 导出企业信息
进入企业管理页面,根据业务类型、企业名称、状态,按需筛选,点击页面右上
角的 按钮导出相关企业信息。
用户指南 3 添加企业
4
订购号码
添加完企业信息并审核通过后,需向语音通话平台订购号码:
说明
为防止业务高峰期并发不足,可多申请几个号码以作备用。
1. 请登录并进入语音通话控制台。
2. 进入“号码订购”页面,点击“订购申请”,按照页面提示填写号码订购信息。
固话号码需选择号码所属城市和数量,单击“立即购买”。
注:号码发放当日会收取当月月租费,请根据实际使用量填写号码个数。
3. 等待资源下发。
号码资源下发需要10个工作日左右。您可在“号码订购”页面查看结果。
若号码已下发,您可以进行线下开发。
用户指南 4 订购号码
5
退订号码
语音通话平台支持退订号码。
说明
1. 用户可随时退订号码,退订后从次月开始不收月租费。
2. 单次批量退订号码数量不超过10000个。
3. 仅支持.xlsx类型文件的导入。
4. 号码批量退订可能失败,请关注退订结果。
5. 退订号码后不可恢复,请谨慎进行退订操作。
退订号码
方法1:
1. 点击控制台左侧导航栏的“号码退订”,进入号码退订页。
2. 点击右上角“退订申请”。
3. 点击“模板”下载退订模板,填写后上传。点击“提交”。
用户指南 5 退订号码
方法2:
1. 点击控制台左侧导航栏的“号码管理”,进入号码管理页。
2. 退订多个号码时,选择需要退订的号码,点击右上角的“批量退订”,点击“确 认”。
3. 退订单个号码时,选择需要退订的号码,点击右上角的“批量退订”,或点击
“操作”下面的“退订”。
说明
号码退订后不可恢复,请谨慎操作。
查看退订结果
点击控制台左侧导航栏的“号码退订”可查看号码退订结果。号码退订状态有“完 成、部分成功、号码检查中、号码检查不通过”四种。
● “部分成功”是指退订的号码中有部分退订成功和部分检查不通过或退订失败的 号码;“号码检查不通过”是指退订的号码都没有通过检查。
● 点击“查看详情”可下载退订结果列表查看检查不通过和退订失败的原因。
● 点击“退订申请”可再次上传退订失败的号码。
用户指南 5 退订号码
6
添加放音文件
语音通话支持各种场景的自定义放音,自定义放音使用的文件需要提前上传到语音通 话平台并通过审核后才可使用。点此了解自定义放音场景
1. 进入语音通话控制台,点击“放音文件管理”。
2. 点击右上角“添加放音文件”,开始添加放音文件。
3. 选择要上传的放音文件并填写文件说明。
4. 点击“提交”。
提交成功后,您可在放音文件管理页面查看审核状态、下载或删除放音文件。
用户指南 6 添加放音文件
7
添加语音模板
语音通话支持自定义语音模板,语音模板需要提前到语音通话平台提交并通过审核后 才可使用。
1. 进入语音通话控制台,点击“语音模板管理”。
2. 点击右上角“添加语音模板”,开始添加。
3. 填写模板名称、设置语音播放速度、模板内容及业务场景。
说明
模板内容必须以汉字开头。
4. 点击“确认”。
提交成功后,将生成唯一“模板ID”。您可在“语音模板管理”页面查看审核状 态、修改或删除语音模板。
用户指南 7 添加语音模板
8
修改企业话术
语音通话支持修改使用场景的具体话术数据,如需修改,请进入控制台-企业管理。
注:只有审核通过的企业才可以修改数据。修改过程中会弹出“授权声明”提示框,
请点击“同意”进入下一步操作(若点击“不同意”,则操作失败,即无法修改企业 相关信息)。
请根据您的业务类型,选择您想要修改的企业,状态为“审核通过”的企业-“操作”
列选择“修改”,并按照下图所示内容填写修改相关信息。
用户指南 8 修改企业话术
用户指南 8 修改企业话术
9
业务测试
请拨打400客服电话,获取测试支撑。
语音回呼
尊敬的客户:欢迎您使用语音通话服务。如下为服务指南:
获取接口文档:
请访问语音回呼场景API,获取PDF版接口文档。
获取代码样例:
请访问语音回呼代码样例,获取语音回呼代码样例。
建议您先下载Node.js Demo完成调测熟悉接口,再结合接口文档参考代码样例进行其 他语言开发。
常见问题:
请参考语音通话常见问题。
录音相关接口:
获取录音文件下载地址API
语音通知&语音验证码
尊敬的客户:欢迎您使用语音通话服务。如下为服务指南:
获取接口文档:
请访问语音通知API或语音验证码场景API,获取PDF版接口文档。
获取代码样例:
用户指南 9 业务测试
请参考语音通知模板配置规则、放音文件音频格式要求。
您需要按照以上模板规则,在控制台上传模板或者放音文件,我们的工作人员审核通 过后,就可以正常调用了。
常见问题:
请参考语音通话常见问题。
用户指南 9 业务测试
10
联系人管理
为方便您及时获取号码订购审核结果、企业审核结果、放音文件和语音模板的审核结 果,语音通话平台支持添加联系人及联系信息,用于接收语音通话业务相关通知。
1. 点击控制台左侧导航栏的“联系人管理”,进入联系人管理页。
2. 点击右上角“添加联系人”,依次输入联系人的姓名、联系号码及邮箱,选择接 收的通知类型并点击“提交”。
用户指南 10 联系人管理
2. 一共可添加10个联系人。
用户指南 10 联系人管理
11
业务详单
语音通话平台支持用户查看已开通业务的通话详请。
1. 进入语音通话控制台,选择“业务详单”,进入业务详单页面。
2. 选择业务类型,点击“高级搜索 ”可展开更多条件选项,输入搜索条件,点击
“搜索”,即可查看相关号码通话详情。
说明
● 呼叫时间只能查询当前时间2个月之内的数据。
● SessionId、主叫号码、被叫号码支持模糊搜索。
用户指南 11 业务详单
12
业务统计
基本介绍
语音通话服务支持查看和导出语音回呼、 语音通知和语音验证码的业务统计详情。
说明
● 业务统计只支持查询审核通过的企业。
● 呼叫时长和接通率数据只能选其一,不能同时选择。
● 双击折线图中数据圆点,可逐级显示当月/当天数据。
● 自定义日期查询时,只能统计前一天或更早的数据,连续时间不能超过六个月,最新数据从 2020年11月1日开始。
查看业务统计
1. 进入语音通话控制台,选择“业务统计”,进入业务统计页面。
2. 选择“语音回呼”、“语音通知”或“语音验证码”,按需筛选。
– 可根据应用名称、业务号码、企业名称筛选指定时间(连续不超过六个月)
的业务统计数据。
– 可点击“本月”/“上月”快速筛选查看本月/上月的业务统计数据。
3. 查看业务统计详情。
– 各业务统计项如下:
▪
语音回呼:统计业务的主被叫呼叫次数、主被叫接通次数、主被叫呼叫 时长和主被叫接通率。▪
语音通知、语音验证码:统计业务的呼叫次数、接通次数、呼叫时长和 接通率。用户指南 12 业务统计
– 统计表支持添加扩展项“企业名称”统计业务数据,在统计表上方的“查看 扩展数据”中选择。
用户指南 12 业务统计
13
权限管理
13.1 创建用户并授权使用通信云服务
如果您需要对您所拥有的通信云服务进行精细的权限管理,您可以使用统一身份认证 服务(Identity and Access Management,简称IAM),通过IAM,您可以:
● 根据企业的业务组织,在您的华为云账号中,给企业中不同职能部门的员工创建 IAM用户,让员工拥有唯一安全凭证,并使用通信云服务资源。
● 根据企业用户的职能,设置不同的访问权限,以达到用户之间的权限隔离。
● 将通信云服务资源委托给更专业、高效的其他华为云账号或者云服务,这些账号 或者云服务可以根据权限进行代运维。
如果华为云账号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章 节,不影响您使用通信云服务的其它功能。
本章节为您介绍对用户授权的方法,操作流程如图 给用户授予语音通话平台权限流程 所示。
前提条件
给用户组授权之前,请您了解用户组可以添加的通信云服务权限,并结合实际需求进 行选择,通信云服务支持的系统权限,请参见:通信云服务系统权限。若您需要对除 通信云服务之外的其它服务授权,IAM支持服务的所有权限请参见系统权限。
说明
进行用户组授权时,“作用范围”需要选择“区域级项目”,设置权限时:
● 若在指定区域(如华北-北京一)对应的项目(cn-north-1)中设置相关权限,则该权限仅对 此项目生效;IAM用户登录控制台后,需要切换至指定授权区域(如华北-北京一)进行验 证;
● 若在“所有项目”中设置权限,则该权限在所有区域项目中都生效,IAM用户登录后无需切 换指定授权区域。
用户指南 13 权限管理
示例流程
图13-1 给用户授予语音通话平台权限流程
1. 创建用户组并授权
在IAM控制台创建用户组,并授予通信云服务执行权限“RTC Administrator”。
2. 创建用户并加入用户组
在IAM控制台创建用户,并将其加入1中创建的用户组。
3. 用户登录并验证权限
新创建的用户登录控制台,切换至授权区域,验证通信云服务的执行权限。
用户指南 13 权限管理