模板变量：让每一通电话提醒都带上对方的真实信息 批量发通知时，最忌讳「千人一面」——所有客户听到的都是同一段话，既不专业，也听不出与自己相关。使用思锐语音通知平台的模板变量能力，可以把订单号、姓名、金额等动态内容，在呼叫时自动填入固定模板，…
模板变量：让每一通电话提醒都带上对方的真实信息
批量发通知时，最忌讳「千人一面」——所有客户听到的都是同一段话，既不专业，也听不出与自己相关。使用思锐语音通知平台的模板变量能力，可以把订单号、姓名、金额等动态内容，在呼叫时自动填入固定模板，再由 TTS 转成语音播报。
模板与变量的关系
模板报备通过后，模板里预留固定句式，例如「尊敬的{姓名}，您的订单{订单号}已完成，请及时查看」。花括号部分就是变量，呼叫时由业务系统实时传入，播报内容的其他字句保持不变。这样既满足模板报备对内容一致性的要求，又能实现个性化。
接口里如何传入变量
调用标准 HTTPS 接口（api.vm.ihuyi.com/webservice/voice.php）的 Submit 方法时，按报备模板的字段顺序，把变量值一并提交即可。返回 code=2 仅代表请求提交成功，记得保存 voiceid，用于后续查询呼叫回执。需要 JSON 响应时，显式传 format=json。
常见变量用法
- 订单取件：姓名 + 取件码 + 取件地址；
- 账单提醒：客户名 + 金额 + 缴费截止日期；
- 预约叫号：排队号 + 业务窗口 + 预计等待时间；
- 运维告警：设备名 + 告警级别 + 发生时间。
用好变量的三个要点
- 变量位置要在报备模板中固定，否则容易触发「发送内容与模板格式不符」（错误码 4072）；
- 传入内容避免生僻字与超长数字串，TTS 播报更自然；
- 金额、编号等关键信息尽量口语化改写，例如「一千二百元」比一串数字更易听懂。
一个完整的播报例子
以取件提醒为例，报备模板为「尊敬的{姓名}，您的包裹已到{站点}，取件码{取件码}，请凭码取件」。呼叫时系统传入「张先生、幸福路驿站、3861」，TTS 合成后客户听到的就是一段完整、具体的语音通知。整段话里只有变量在变，句式永远与报备模板一致，既不会触发 4072，也让客户第一时间听出这是与自己有关的事。变量还可以配合业务规则使用：夜间时段自动过滤非紧急通知、避免打扰休息；同一接口配置短信留底后，取件码会以短信形式再发一次，客户即便没听清也能照着短信取件。
思锐语音通知接口提供 Python/PHP/Node.js/Java/cURL 多语言示例，变量拼接逻辑在示例中可直接复用；专人协助模板报备，从注册到首次播报有清单式指导。免费注册即可测试：https://user.ihuyi.com/new/register.html，咨询热线 400-118-6878（9:00–18:00）。