简介

最近更新时间:2025-09-16 03:11:44

我的收藏

概述

语音消息(Voice Message Service,VMS)通过腾讯云提供的语音专线,为客户提供语音告警、语音通知、语音验证码等服务。语音消息具有高到达率、超低延时、秒级触达的优势,致力于提供优质的语音消息服务。
本章节介绍的语音消息API 接口均为API 3.0接口
现有旧版 API 接口功能依然保持,未来可能停止维护,如您仍需使用旧版接口可参考:旧版API文档
您可以调用 API 对语音消息进行操作,例如发送语音验证码、指定模板发送语音通知。
语音消息支持的所有接口信息,请参见 API 概览

术语表

语音消息API 接口的常见术语请参见下表:

术语 描述
VoiceSdkAppId VoiceSdkAppId 是腾讯云后台用来区分不同 语音消息应用的唯一标识,在 语音消息 控制台创建应用时自动生成。不同 VoiceSdkAppId之间的数据不互通。
CalledNumber CalledNumber 是被叫手机号码,采用 e.164 标准格式,需包含国家码,例如:+8613711112222。
CodeMessage CodeMessage 是语音验证码内容,仅支持数字,系统会在播报时自动添加前缀“您的验证码是”。
TemplateId TemplateId 是语音模板 ID,在控制台审核通过后获取,用于指定发送的语音通知模板。
SessionContext SessionContext 是用户会话内容,发送请求时传递,腾讯云服务器会在回调中原样返回。

使用限制

频率限制:每个接口默认请求频率限制为 20 次/秒(API + 地域 + 子账号维度)。
内容限制:语音验证码仅支持数字,语音通知内容长度不超过 350 字。
播放次数:可选 1–3 次,默认为 2 次。
支持的号码:仅支持中国大陆地区手机号码。

API 快速入门

您可以使用 API Explorer 工具在线调用 API。
本文以 语音消息发送语音验证码为例,通过 API Explorer 工具调用 API 接口的步骤如下:

  1. 进入 API Explorer 工具页面。更多 API Explorer 工具使用信息,请参见 使用 API Explorer
  2. 调用发送语音验证码,实现语音验证码的发送。
  3. 选择 Region: 华南地区(广州)。
  4. 输入参数,具体示例可参见发送语音验证码
  5. 发起调用即可。