客户端操作指引【NOC-Joey】

一.客户端【国际语音】模块功能介绍



语音应用：可以查看已经开通的Voice业务。
文件管理：用于上传和管理语音群呼所需的录音文件。
语音发送：客户端手动发送语音活动。
记录查询：语音活动发送详细记录查询。
消费报表：语音活动消费报表统计。
批次记录：按批次查询语音活动记录。

二.操作手册

1语音应用管理：您可以通过 语音应用 来创建和管理您的语音应用。

新增语音应用


新增入口：国际语音-语音应用-新增应用
新设置项说明：
应用名称：语音应用名称，可自定义。建议根据用途命名，比如语音群呼，语音通知，语音验证码。
回执推送地址：语音活动推送的Http接口地址（由用户提供）。例如：http://106.15.34.94:8989/voice/testVoiceDr
状态：启用/停用 语音应用

请注意，新增完成后请联系客户经理配置国家地区方向路由及更优惠的价格。或者更直接一些，联系客户经理后台直接新增语音应用。

查看密钥


密钥的用途：密钥是API接口接入所需的必要参数，客户端SrcretKey默认脱敏显示******。通过注册手机号或账户绑定邮箱，可以获取验证码。进行验证后，SrcretKey可以解除脱敏。

查看密钥入口：国际短信-语音应用-查看密钥

查看价格

查看价格入口：国际短信-语音应用-价格，根据语音应用类型，可查看对应 群呼费率/验证码费率/通知费率

费率项说明：
应用名称：自定义语音应用名称
国码：国家地区码
国家：国家地区名称
币种：账户签约币种
当前原币价格：当前单价，和生效原币价格保持一致
生效原币价格：生效单价，和当前原币价格保持一致
计费周期：当前计费精度，和生效计费周期保持一致
生效计费周期：生效计费精度，和计费周期保持一致
基本费：语音群呼应用专用费用，每一通未接通的呼叫会收取基本费；接通的呼叫则不再收取基本费。

Q&A：常见的计费周期有哪些？
常见的计费周期有：60+60，20+20，60+1，1+1等；
60+60：即按分钟收费，不足60s也会按60s进行计费
20+20：即按20s一个计费周期收费，不足20s也会按20s进行计费。
60+1：即首个计费周期按分钟计费(不足60s按60s进行计费)，超过60s后的时长按秒计费
1+1：即按秒计费

2.文件管理：用于上传和管理 语音群呼 所需的录音文件

展示项说明：
文件名称：上传的录音文件名称
URL地址：录音文件上传后由系统自动生成的URL地址，用于API接口调用
语音预览：预览试听上传录音
上传时间：录音上传成功的时间

上传文件


入口：国际语音-文件管理-上传文件
支持录音文件类型及大小：请上传小于2MB的音频文件，格式为mp3、wav


3.语音发送：客户端手动发送语音活动

(1).语音群呼客户端发送：


发送选择项说明：带*的为必填项
语音应用：选择语音群呼对应的应用名称，如您初次使用语音群呼产品时请联系业务员开通。
国家：发送国家地区选择，单选，只能同时发送一个国家地区
显示号码：传入NXCLOUD呼叫系统的主叫号码，非特殊定制可以随意传值。请注意，由于线路资源并不一定支持主叫号码透传，终端用户收到的最终显示号码并不一定是您传入时的主叫号码，即用户收到的来电显示号码会有更改的可能
手机号：请在框内输入号码(不需要加国码，号码前面可以加0)，若多个号码请用英文逗号隔开；如果批量号码需要文件导入，请下载模板(模板格式为一个号码一行)。号码格式以中国为例：013977776666或者13977776666。
下载模板：批量导入号码时可选用，下载模板Txt文件，注意模板格式为一个号码一行
号码上传：导入号码文件，注意一次最多提交5万个号码
语音文件：
    新上传文件：选择上传录音文件，需要注意录音文件需要小于2M，支持MP3，wav，m4a等常见格式
    已上传文件：可查看和选择历史上传的录音文件
定时发送：设置定时群呼任务，选择发送日期和时间，需要注意时区选择，默认GMT+8，即东八区北京时间，可按需调整
短信应用：挂机短信功能。可配置短信应用(如未开通短信应用则不可选择)，当终端用户成功接通后，系统将自动追加一条文本内容至该号码
短信内容：挂机短信的发送内容。请注意，由于各个国家地区的发送限制和规则差异，如需使用挂机短信请提前联系业务员确认是否支持


(2).语音通知客户端发送：


发送选择项说明：带*的为必填项
应用名称：选择语音通知对应的应用名称，如您初次使用语音通知产品时请联系业务员开通。
国家：发送国家地区选择，单选，只能同时发送一个国家地区
显示号码：传入NXCLOUD呼叫系统的主叫号码，非特殊定制可以随意传值。请注意，由于线路资源并不一定支持主叫号码透传，终端用户收到的最终显示号码并不一定是您传入时的主叫号码，即用户收到的来电显示号码会有更改的可能
手机号：请在框内输入号码(不需要加国码，号码前面可以加0)，若多个号码请用英文逗号隔开；如果批量号码需要文件导入，请下载模板(模板格式为一个号码一行)。号码格式以中国为例：013977776666或者13977776666
下载模板：批量导入号码时可选用，下载模板Txt文件，注意模板格式为一个号码一行
号码上传：导入号码文件，注意一次最多提交5万个号码
文本内容：语音通知的文本内容，和语种需要匹配
语种：文本语种，比如播放英文选择English，播放中文选择Chinese；注意需要和文本内容匹配
定时发送：设置定时语音通知任务，选择发送日期和时间，需要注意时区选择，默认GMT+8，即东八区北京时间，可按需调整

请注意，如果是触发式的语音通知，需要通过API接口来接入生产活动；客户端发送适用于安排人工来批量发送的语音活动或测试。


(3).语音验证码客户端发送：


发送选择项说明：带*的为必填项
应用名称：选择语音验证码对应的应用名称，如您初次使用语音验证码产品时请联系业务员开通。
国家：发送国家地区选择，单选，只能同时发送一个国家地区
显示号码：传入NXCLOUD呼叫系统的主叫号码，非特殊定制可以随意传值。请注意，由于线路资源并不一定支持主叫号码透传，终端用户收到的最终显示号码并不一定是您传入时的主叫号码，即用户收到的来电显示号码会有更改的可能
手机号：请在框内输入号码(不需要加国码，号码前面可以加0)，若多个号码请用英文逗号隔开
文本内容：语音验证码的文本内容，和语种需要匹配。比如【文本内容】为英文，那么【语种】应该为English，系统将自动播放对应语种的语音；播放验证码建议将数字用"-"号隔开，比如：1-2-3-4-5-6。
语种：文本语种，比如播放英文选择English，播放中文选择Chinese；注意需要和文本内容匹配

请注意，由于语音验证码是客户触发式的活动，需要通过API接口来接入生产活动。客户端的手动发送活动仅适用于测试。


4.记录查询：语音活动发送详细记录查询

记录查询-语音群呼

记录显示项说明：
应用名称：语音群呼活动使用的应用名称
被叫号码：被叫侧用户号码
显示号码：传入NXCLOUD系统的主叫号码
国家：号码归属国家地区
基本费：语音群呼活动专有费率；未接通的呼叫会收取按条收取基本费，已接通的呼叫不收取基本费；具体费用请联系业务员确认
单价：单价
计费条数：通话计费条数
总价：单价*计费条数+基本费，消费总费用
通话时长(秒)：语音接通后通话的时长
计费周期：通话计费周期，20表示每20秒一个计费周期。例：计费周期20，通话时长11秒，则计费条数为1；通话时长23秒，则计费条数为2
状态：
    提交失败：该条记录提交失败，任务终止；常见原因有：发送目标国家地区未开通(报价不存在)，录音文件格式不合规等；提交失败的记录不收取任何费用。
    提交成功：该条记录的语音活动已经成功发起。请注意，提交成功是一个中间状态，在语音呼叫活动结束时，会更新状态为接通或未接通。
    接通：呼叫已经接通
    未接通：呼叫未接通
提交结果：提交结果展示。语音活动提交成功会显示未接通/接通，提交失败则会显示具体失败原因，如：报价不存在(未开通)
终止原因：
    未接通-主叫挂断：通话未接通，主叫方发起呼叫终止
    未接通-被叫拒接：通话未接通，被叫方发起呼叫终止
    已接通-主叫挂断：通话接通，主叫方发起呼叫终止
    已接通-被叫挂断：通话接通，被叫方发起呼叫终止
    其它：其它终止原因，比如提交失败时，会显示为该项终止原因
按键反馈：按键反馈是指，被叫用户接通电话后，在手机键盘按数字键后的反馈记录。默认不开启；如果按键反馈功能需要，请联系业务员确认是否支持
追加短信内容：发送的挂机短信内容；未设置挂机短信则显示为空
短信应用：发送挂机短信的应用通道密钥
发送时间：语音活动发送时间



记录查询-语音通知

记录显示项说明：
应用名称：语音通知活动使用的应用名称
被叫号码：被叫侧用户号码
显示号码：传入NXCLOUD系统的主叫号码
国家：号码归属国家地区
计费条数：通话计费条数
通话时长(秒)：语音接通后通话的时长
计费周期：通话计费周期，20表示每20秒一个计费周期。例：计费周期20，通话时长11秒，则计费条数为1；通话时长23秒，则计费条数为2
单价：单价
总价：单价*计费条数，总费用
状态：
    提交失败：该条记录提交失败，任务终止；常见原因有：发送目标国家地区未开通(报价不存在)，被叫号码归属不存在等；提交失败的记录不收取任何费用。
    提交成功：该条记录的语音活动已经成功发起。请注意，提交成功是一个中间状态，在语音呼叫活动结束时，会更新状态为接通或未接通。
    接通：呼叫已经接通
    未接通：呼叫未接通
提交结果：提交结果展示。语音活动提交成功会显示未接通/接通，提交失败则会显示具体失败原因，如：报价不存在(未开通)
文本内容：上传的Txt文本文案
录音文件：此项目前功能不可用，请忽略
语种：选择的语种
发送时间：语音活动发送时间



记录查询-语音验证码

记录显示项说明：
应用名称：语音验证码活动使用的应用名称
被叫号码：被叫侧用户号码
显示号码：传入NXCLOUD系统的主叫号码
国家：号码归属国家地区
计费条数：通话计费条数
通话时长(秒)：语音接通后通话的时长
计费周期：通话计费周期，20表示每20秒一个计费周期。例：计费周期20，通话时长11秒，则计费条数为1；通话时长23秒，则计费条数为2
单价：单价
总价：单价*计费条数，总费用
状态：
    提交失败：该条记录提交失败，任务终止；常见原因有：发送目标国家地区未开通(报价不存在)，被叫号码归属不存在等；提交失败的记录不收取任何费用。
    提交成功：该条记录的语音活动已经成功发起。请注意，提交成功是一个中间状态，在语音呼叫活动结束时，会更新状态为接通或未接通。
    接通：呼叫已经接通
    未接通：呼叫未接通
提交结果：提交结果展示。语音活动提交成功会显示未接通/接通，提交失败则会显示具体失败原因，如：报价不存在(未开通)
文本内容：上传的Txt文本文案
录音文件：此项目前功能不可用，请忽略
语种：选择的语种
发送时间：语音活动发送时间


5.消费报表：语音活动消费报表统计

此列表数据的统计时间是：每天统计前一天的所有数据

语音群呼 消费报表


报表展示项说明：

应用名称		语音群呼应用名称
总拨打数		拨打号码数量总数
总计费条数		语音活动总计费条数
总通话时长(秒)		语音活动总计费时长，单位秒
接通	拨打数	呼叫状态为接通的号码数量
	计费条数	呼叫状态为接通的计费条数
	总金额	呼叫状态为接通的消费总金额
未接通	拨打数	呼叫状态为未接通的号码数量
	计费条数	呼叫状态为未接通的计费条数
	总金额	呼叫状态为未接通的消费总金额
总金额		总消费金额
平均接通率		平均接通率=接通/总拨打数
平均通话时长(秒)		平均通话时长=总通话时长/总拨打数
时间		发送日期

Q&A
Q：语音活动是接通计费的方式，那为什么报表中未接通的数据也有总金额统计？
A：语音群呼活动存在基本费，即会对每一个未接通状态的号码收取兜底基本费，所以即使呼叫未接通，也会有消费金额。请注意，如果通话接通，则不再收取基本费，只收取接通费用。

语音通知 消费报表


报表展示项说明：

应用名称		语音群呼应用名称
总拨打数		拨打号码数量总数
总计费条数		语音活动总计费条数
总通话时长(秒)		语音活动总计费时长，单位秒
接通	拨打数	呼叫状态为接通的号码数量
	计费条数	呼叫状态为接通的计费条数
	总金额	呼叫状态为接通的消费总金额
未接通	拨打数	呼叫状态为未接通的号码数量
	计费条数	呼叫状态为未接通的计费条数
	总金额	呼叫状态为未接通的消费总金额
总金额		总消费金额
平均接通率		平均接通率=接通/总拨打数
平均通话时长(秒)		平均通话时长=总通话时长/总拨打数
时间		发送日期

 

语音验证码 消费报表


报表展示项说明：

应用名称		语音群呼应用名称
总拨打数		拨打号码数量总数
总计费条数		语音活动总计费条数
总通话时长(秒)		语音活动总计费时长，单位秒
接通	拨打数	呼叫状态为接通的号码数量
	计费条数	呼叫状态为接通的计费条数
	总金额	呼叫状态为接通的消费总金额
未接通	拨打数	呼叫状态为未接通的号码数量
	计费条数	呼叫状态为未接通的计费条数
	总金额	呼叫状态为未接通的消费总金额
总金额		总消费金额
平均接通率		平均接通率=接通/总拨打数
平均通话时长(秒)		平均通话时长=总通话时长/总拨打数
时间		发送日期

6.批次记录：按批次查询语音活动记录

每一次提交的语音活动即一个单独批次。批次记录可以查看每一组语音活动的整体呼叫情况。

过滤单条筛选项：选择过滤单条筛选项后，则查询的数据会剔除单个号码的活动批次记录


批次记录 语音群呼

显示项说明：

应用名称	语音活动应用名称
被叫号码	提交批次中的所有被叫号码
显示号码	提交活动时传入的显示号码
国家	呼叫国家或地区
计费条数	批次计费总条数
URL	群呼录音地址
状态	批次提交状态。常见的状态有以下这些：待提交，已撤销，提交成功，提交失败
提交结果	批次提交结果。若提交失败会显示具体失败原因
平均通话时长(秒)	批次平均通话时长
平均接通率	批次平均接通率
短信应用	挂机短信关联的短信应用appkey
短信内容	挂机短信内容
定时发送	批次是否定时发送
定时时间	批次定时发送时间；如未设置定时发送则会立即发出，则此项显示为空
提交时间	批次提交时间
操作-撤销	定时任务触发前可以选择撤销。如果撤销则会更新状态未“已撤销”。请注意，定时任务如果已经触发，则不可撤销。

批次记录 语音通知

显示项说明：

应用名称	语音活动应用名称
被叫号码	提交批次中的所有被叫号码
显示号码	提交活动时传入的显示号码
国家	呼叫国家或地区
计费条数	批次计费总条数
URL	语音通知活动不包含录音。此项显示为空
状态	批次提交状态。常见的状态有以下这些：待提交，已撤销，提交成功，提交失败
提交结果	批次提交结果。若提交失败会显示具体失败原因
平均通话时长(秒)	批次平均通话时长
平均接通率	批次平均接通率
语种	批次提交时选择的语种
文本内容	批次文本内容
定时发送	批次是否定时发送
定时时间	批次定时发送时间；如未设置定时发送则会立即发出，则此项显示为空
提交时间	批次提交时间
操作-撤销	定时任务触发前可以选择撤销。如果撤销则会更新状态未“已撤销”。请注意，定时任务如果已经触发，则不可撤销。

批次记录 语音验证码

显示项说明：

应用名称	语音活动应用名称
被叫号码	提交批次中的所有被叫号码
显示号码	提交活动时传入的显示号码
国家	呼叫国家或地区
计费条数	批次计费总条数
URL	语音验证码活动不包含录音。此项显示为空
状态	批次提交状态。常见的状态有以下这些：待提交，已撤销，提交成功，提交失败
提交结果	批次提交结果。若提交失败会显示具体失败原因
平均通话时长(秒)	批次平均通话时长
平均接通率	批次平均接通率
语种	批次提交时选择的语种
文本内容	批次文本内容
定时发送	批次是否定时发送
定时时间	批次定时发送时间；如未设置定时发送则会立即发出，则此项显示为空
提交时间	批次提交时间
操作-撤销	定时任务触发前可以选择撤销。如果撤销则会更新状态未“已撤销”。请注意，定时任务如果已经触发，则不可撤销。 由于语音验证码都是用户触发式，基本不需要设置定时任务。此项功能多用于客户端测试