操作指南

在您使用语音通知服务前,需要您先开通此服务。

语音服务概览

在语音通知服务概览页,您可在“配置管理”栏目里查看当前语音通知号码数,已上传文本转语音模板总数,语音文件总数。

  • 在“语音通知号码“中,可点击“购买新号码“,进行语音通知号码的配置。

    说明:
    当前未开放号码购买的功能,系统为用户提供随机号码使用。

  • 在“文本转语音“中,可点击数字,进入到文本转语音模板中进行配置。

  • 在“语音文件“中,可点击数字,进入到语音文件中进行配置。

    说明:
    当前未开放上传语音通知文件的功能。

  • 在“API文档”栏中,您可查看语音通知API详情,下载语音通知API调用示例,帮助您快速启用服务。

  • 在“订阅回执消息”中,您可对回执信息的接收地址进行设置。在保存接收地址时,服务端需要严格按照标注内容设置响应信息。

文本模板上传

  1. 在左侧导航栏选择“配置管理>文本转语音文件模板”,进入文本转语音列表页。

  2. 点击“添加文本模板”,用户可配置新模板内容。要求用户填写模板名称、模板内容以及申请说明。

    模板内容的说明:

    • 对模板内容的设置需满足支持的业务场景,不支持特殊符号,平台会对模板进行黄反校验、敏感词校验等。
    • 用户可自行定义变量内容,变量长度根据类型有一定限制,如:
      • 姓名的文本长度限制为5个汉字字符;
      • 日期格式只接受yy/mm/dd的输入格式;
      • 时间格式只接受二十四小时制(01:23:45)的输入格式;
      • 金额数据只接受十位以内的数字,精确到十分位和百分位;
      • 文字模板总字节需控制在1024字节以内。
  3. 完成文本模板内容配置后,用户可点击“确认”提交审核。
  4. 提交审核后,文本转语音文件模板列表页,查看到刚刚新添加的模板,以及该模板的审核状态。

    说明:
    文本模板的审核采取系统审核和人工审核相结合的方式,一般情况下在用户发出审核申请的1个工作日之内给出审核结果。

调用API

用户发起调用前,需要在控制台获取文本模板ID,模板ID是发起语音通知服务的必填参数。

语音通知服务提供了详细的API文档,用户可结合实际需求,实现灵活调用。点击查看 API文档

订阅回执消息

用户可通过订阅回执消息,接收呼叫记录消息。在通话结束后,可以获取到本次通话的被叫号码、通话开始时间、通话结束时间,通话状态等信息。开通订阅回执消息服务后,回执消息会以HTTP批量模式,推送至用户设置的接收地址。

注意:

用户设置保存接收地址时,服务端需要严格按照提示内容设置服务端响应信息。

若未在控制台设置接收地址,您将无法获取服务结果详情。

通话状态信息将以回执状态码的形式推送,状态码所代表的详情如下:

回执状态码

返回值 描述 说明
0000 成功 调用成功
0001 服务错误 外呼失败(未发起拨打),原因未知
0002 被叫拦截 通话拨通后无人接听,可能被用户端拦截
1000 被叫关机 被叫用户关机,呼叫失败
1001 被叫停机 被叫用户欠费停机,呼叫失败
1002 暂时无法接通 被叫用户暂时无法接通,包括不在服务区,网络忙,建议稍后再进行拨打
1003 号码正忙 被叫用户正在通话中,无法接通
1004 空号 被叫号码为空号,无法接通
1005 无人接听 号码已经拨通,但用户未接听
1006 用户拒绝 号码已经拨通,但被叫用户拒绝接听
1007 线路忙 线路忙,未拨通,建议稍后再进行拨打
1008 线路错误 线路错误,导致拨打失败,建议重试
1009 其他错误 其他错误

统计分析

用户调用语音通知服务的统计概况,可在统计分析中查看。用户可选择时间段查看发起请求总量,接通总量以及未接通总量。另外,用户可在失败分析中,查看未接通的具体原因,可根据业务实际需要制定调用策略。

统计项说明:

统计名称 描述
拨打总量 用户在选定的时间区间内,调用语音通知服务,发起呼叫的总次数
接通量 用户在选定的时间区间内,呼叫的总被接听次数
未接通量 用户在选定的时间区间内,呼叫的未接听次数
接通率 接通率 = 呼叫的总被接听次数/调用语音通知服务发起呼叫的总次数
通话时间 用户在选定的时间区间内,使用语音通知服务的总通话时间
失败分析 失败原因:在选定的时间内,未接听呼叫的原因分类统计,失败原因包括空号、暂时无法接通、和其他三大原因
失败数量:在选定的时间内,使用语音通知服务的呼叫的未接听次数统计
所占比例:在选定的时间内,未接听呼叫根据不同原因的占比统计