发送第一条语音通知
从开通到发出第一次语音通知呼叫的完整流程。
语音通知向手机号发起语音呼叫，以 TTS 播报模板内容，适用于订单提醒、物流通知、会议邀约与风险告警等场景。本页带你从零完成第一次语音呼叫。
准备工作
- 已开通语音产品（未开通请联系商务）
- 一枚 API Key：在 Console > Developers 创建，参见 鉴权
- 该 API Key 须配置 IP 白名单，并确保请求出口 IP 在名单内（未配置白名单时所有请求将被拒绝）
典型使用流程
创建并送审模板
呼叫内容由模板定义。在 Console 语音产品控制台的模板管理页新建文本模板（变量用 {1}、{2} 序数占位符表示），或调用 模板 API 创建；提交审核后状态变为已通过，记录 templateId。详见 使用语音控制台。
确认模板国家
模板创建时绑定的国家/地区（alpha-2 编码）决定呼叫的路由与计费，发送时无需再传国家编码。编码表参见 国家/地区编码。
发起呼叫
调用发送接口，将 {BASE_URL} 替换为接入地址、{API_KEY} 替换为你的 API Key：
curl -X POST '{BASE_URL}/open/v1/voice/notify/batch' \
-H 'Authorization: Bearer {API_KEY}' \
-H 'Content-Type: application/json;charset=utf-8' \
-d '{
"bulkId": "first-voice-call-001",
"messages": [
{
"templateId": "Tpl_0001",
"destinations": [
{ "to": "8613800138000", "variables": ["张三", "A12345"] }
]
}
]
}'variables 数组按序对应模板占位符 {1}…{n}；模板无变量时省略。呼叫国家由模板推导，无需传国家编码。
返回 code 为 000000 即受理成功，记录 data.callId 用于后续排查：
{
"code": "000000",
"message": "success",
"data": {
"bulkId": "first-voice-call-001",
"callId": "YYYX931******64224",
"acceptedCount": 1
}
}呼叫会真实外呼并产生费用，请先用测试号码验证模板与变量效果。
查看发送结果
在 Console 语音产品控制台的发送记录页查看呼叫明细（呼叫结果、结束码、通话时长、发起时间），支持按被叫号码与呼叫结果筛选；也可调用发送记录查询接口按任务/号码获取话单，见 语音消息。
下一步
最后更新于