全部产品
Search
文档中心

语音服务:VoiceSingleCall - 向指定号码发起语音呼叫

更新时间:Nov 11, 2025

向指定号码发送语音验证码和带参数变量的语音通知,支持语音文件模板或文本转语音模板。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
dyvms:VoiceSingleCallnone
*全部资源
*

请求参数

名称类型必填描述示例值
CallerIdNumberstring

主叫号码。 若您不填该参数,系统将会使用当地随机号码作为外显号码。 若您专属号码外呼,则必须传入已购买的号码,仅支持一个号码。您可以登录国际语音服务控制台,选择"号码管理"查看已购买的号码。

852****0001
CalledNumberstring

接收语音通知的手机号码。 号码格式:国际码+号码: 示例:85200****00。

852****0000
TtsCodestring

文本转语音模板的语音 ID。 您可以登录国际语音服务控制台,选择"语音模板管理"-"文本转语音模板",查看模板 ID。 此参数与 VoiceCode 二选一必填。分别代表使用语音文件作为呼叫内容呼叫或者使用固定模板文字作为呼叫内容。

1001
TtsParamstring

模板中的变量参数,JSON 格式。

{"code":"1234"}
VoiceCodestring

语音文件的模板 ID。 您可以登录国际语音服务控制台,选择"语音模板管理"-"语音文件",查看模板 ID。 此参数与 TtsCode 二选一必填。分别代表使用语音文件作为呼叫内容呼叫或者使用固定模板文字作为呼叫内容。

1002
PlayTimeslong

一通电话内语音通知内容的播放次数。取值范围:1~3,默认取值 3。

2
Volumelong

语音通知的播放音量。取值范围:0~100,默认取值 100。

100
Speedlong

语速控制。取值范围为:-500~500。

0
TaskNamestring

任务名称。

单呼任务名
SendTypelong

发送类型:取值[1,2]。 1: 立即开始发送任务,不等待。 2: 定时开始发送任务。如果传该类型,TimingStart 为必选字段。

1
TimingStartstring

定时发送的时间。

2022-05-01T08:00:00+08:00
OutIdstring

预留给调用方使用的 ID,最终会通过在回执消息中将此 ID 带回给调用方。 字符串类型,长度为 1~15 个字节。

22522****
CountryIdstring

国家/地区二字码,ISO2。

HK

返回参数

名称类型描述示例值
object
AccessDeniedDetailstring

访问被拒绝详细信息。

""
Messagestring

返回信息描述。

OK
RequestIdstring

请求 ID。

D9CB****-****-****-****-********9D23
Modelobject

请求结果数据

Codestring

请求状态码。 返回 SUCCESS 代表请求成功。 其他错误码,请参见 API 错误码。

SUCCESS
Successboolean

请求是否成功,成功:true,失败:false。

true

示例

正常返回示例

JSON格式

{
  "AccessDeniedDetail": "",
  "Message": "OK",
  "RequestId": "D9CB****-****-****-****-********9D23\n",
  "Model": {
    "test": "test",
    "test2": 1
  },
  "Code": "SUCCESS",
  "Success": true
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史