创建语音模板

语音模板即用户听到的音频内容,您在发送语音通知语音验证码前,需要先创建语音模板,审核通过后即可发送语音任务。

注意事项

  • 文本转语音模板目前仅支持在语音服务控制台创建,暂不支持API接口创建模板。

  • 申请创建的文本转语音模板需符合内容规范、变量规范等,详情请参见语音模板规范

  • 确保您套餐包余量或账户余额充足。语音服务计费信息,请参见国内语音服务定价

  • 文本转语音模板审核通过后无法修改模板内容,如果需要修改,请重新创建文本转语音模板。

完整流程

下图展示了从准备到最终通过 API 发送语音的完整路径及各环节预计耗时。

image

第一步:完成账号与资质准备

  1. 开通服务与企业认证

  2. 申请企业资质

    • 目的:为满足合规性要求,所有语音服务用户都必须提交企业资质以证明身份。

    • 操作:前往语音服务控制台 > 企业资质页面,提交您的企业资质并等待审核通过。详细步骤请参见企业资质管理

  3. 申请话术并审核通过。申请话术的目的是业务场景报备,话术内容后续不会应用于语音通话,详情请参见新增话术

第二步:创建语音模板

  1. 登录语音服务控制台,在左侧导航栏,选择语音消息

  2. 根据您的业务需要,选择语音通知语音验证码

    • 语音通知支持文本转语音模板和语音通知文件。

      • 文本转语音模板:指模板的内容是文本,在播放时自动转化为语音。

      • 语音通知文件:指预先录制好的音频文件(MP3WAV格式),在接听后直接播放该文件。

    • 语音验证码仅支持文本转语音模板。

  3. 语音通知语音验证码页面创建语音模板。

    创建文本转语音模板

    1. 单击添加模板,根据页面提示填写模板内容。

      参数名称

      参数说明

      外呼号码(外呼模式)

      公共模式文本转语音模板和专属模式文本转语音模板不通用,文本转语音模板外呼模式必须与业务场景外呼模式匹配。具体差异请参见公共模式和专属模式的区别

      • 公共模式外呼:若您不额外购买语音号码,使用语音服务提供的公共号码池内号码随机外呼,您必须选择此选项以创建公共模式的文本转语音模板

      • 专属模式外呼:若您使用在语音服务控制台购买的真实号码外呼,或使用服务实例调度已绑定的真实号码外呼,您必须选择此选项以创建专属模式的文本转语音模板

      重要
      • 如果您选择公共模式外呼,您需要在下拉列表中选择关联资质

      • 若无可选企业资质,请先进行企业资质申请,企业资质申请审核通过后申请话术,话术审核通过后,重新创建语音模板。

      模板名称

      模板名称用于标识并区分您申请的众多模板。模板名称不超过30个字符。

      模板内容

      模板内容必须遵守语音模板规范

      语言

      选择模板语言。

      • 中文

      • 英文

      语速控制

      设置语速。

      声音类型

      选择声音类型。

      • 女声

      • 男声

      说明

      英文语言下声音类型仅支持女声。

      声音音色

      请选择声音音色。您可选择语速和声音音色后,单击“试听”图标image,配置合适的音频输出效果。

      使用说明

      申请说明是模板审核的参考信息之一,请详细描述您的业务的使用场景,并提供可以验证这些业务的网站链接、APP名称等信息。信息完善的申请说明会提高模板的审核效率。

    2. 单击确定。创建完成,等待审核。

    创建语音通知文件

    单击导入语音文件,选择外呼号码类型并导入语音文件,等待审核。

    重要

    公共模式外呼模板和专属模式外呼模板不通用,请选择适合您业务场景的外呼模式。具体差异请参见公共模式和专属模式的区别

    image

第三步:审核流程

语音模板预计在2小时内完成审核。审核工作时间:周一至周日9:00~23:00(法定节假日顺延)。

审核通过后,您可以在语音通知语音验证码列表页获取模板ID。模板ID是调用语音接口的必填参数。

说明
  • 审核状态未通过,单击原因,查看未通过原因。

  • 不支持修改审核状态为通过审核中未通过的模板。

第四步:API 集成与发送

模板审核通过后,您就可以在您的应用程序中调用 API 来发送语音了。

获取模板ID/语音ID

  • 模板ID:在语音通知或语音验证码的模板列表中,找到已通过审核的模板,并复制其模板ID(API 参数中称为 TtsCode)。这是调用 API 的关键凭证。

    image

  • 语音ID:在语音文件管理列表中,找到已通过审核的语音文件,并复制其语音ID(API 参数中称为 VoiceCode)。这是调用 API 的关键凭证。

    image

选择 API 接口

支持公共模式模板和专属模式模板的外呼接口:

  • SingleCallByTts:向指定号码发送语音验证码文本转语音类型的语音通知

  • SingleCallByVoice:向指定号码发送语音通知文件类型的语音通知

仅支持使用专属模式模板的外呼接口:

常见问题