预警通知模板变量使用：自定义变量个性化播报

告警文案不能每次手拼

磁盘使用率告警的文案里要带服务器IP和实际占用率，订单异常告警要带订单号和金额，设备离线告警要带设备编号与位置，生产批次告警要带批次号和产线。如果每次都在程序里拼接字符串，既容易漏字、错拼，又难以统一管理签名和话术，一旦告警规范调整就要改多处代码，还容易因文案不一致被网关拒绝。互亿无线预警通知API支持模板与变量，先在控制台配置模板，发送时传入变量值，系统自动替换后下发或播报。

本文说明模板变量的配置方式、语音播报的字数对应关系，以及个性化通知的写法。

模板与变量的对应关系

以磁盘告警为例，先在控制台申请模板，模板内容形如：

【监控告警】服务器${ip}磁盘使用率已达${rate}%，请及时处理。

发送时通过templateid指定模板编号，content填入替换后的完整内容：

import requests

data = {
    "account": "API_ID", "password": "API_KEY",
    "mobile": "13800138000", "templateid": "1234",
    "content": "【监控告警】服务器10.0.0.8磁盘使用率已达91%，请及时处理。"
}
print(requests.post("https://api.ihuyi.com/sms/Submit.json", data=data).json())

模板平均2小时完成审核，审核通过后即可调用。变量替换后的内容需与已审核模板结构一致，避免因文案不一致被网关拒绝。模板审核期间可用测试条数先验证替换效果，等正式模板通过后再切到生产。

语音播报的变量与字数

语音接口 https://api.ihuyi.com/voice/vm 的content为播报文本，同样可由变量拼装。TTS约70字对应20秒播报，无需提前录音。在拼装语音播报文案时要注意：

• 数字、IP、金额建议读法清晰，例如把IP按段念出，金额念出单位，避免听感模糊。
• 一条播报控制在70字左右，过长会拉长通话时长、增加被挂断概率。
• 告警等级、告警对象、处置建议三要素要在播报中说清，让被叫听完知道做什么。

voice = "数据库告警。订单库连接数达到阈值三百八十。请值班人员立即排查。"
requests.post("https://api.ihuyi.com/voice/vm", data={
    "account": "API_ID", "password": "API_KEY",
    "mobile": "13800138000", "content": voice
}, timeout=(3, 5))

个性化通知的实践建议

使用模板变量时，建议遵循以下做法：

1. 变量取值做长度与字符校验，避免传入超长文本导致长短信按多条计费。
2. 不同告警级别维护不同模板：P1用语音模板说清处置动作，P3用短信模板留档。
3. 同一事件通知多人时，可按角色替换称呼和责任动作，但核心告警信息保持一致。
4. 变量内容不要拼接营销话术，保持告警信息纯粹，减少被拦截概率。

变量替换常见问题

实际使用中，变量替换容易出两类问题：一是变量值里带了换行或特殊符号，导致整条内容与模板不匹配被拒；二是数字太长，短信变成了长短信按多条计费。建议在代码里对变量值做一次清洗：去掉首尾空白、限制长度、把多段内容合并成一行。另外，语音播报里不要出现"%"这类符号，TTS可能读不出来，改成"百分之九十一"更稳妥。互亿无线的免费技术支持可协助审核模板与变量写法。

模板与变量的维护建议

随着告警种类增多，模板数量会慢慢积累。建议给模板起清晰的名字，例如"P1-数据库主从异常"，并在控制台备注使用场景。变量命名也要统一，比如ip、rate、device_id，避免不同人写出来的模板变量名不一致。维护好这些规范，后续新增告警类型时直接复用模板，不必重复提交审核。

互亿无线提供11种语言代码示例，模板审核与变量替换在控制台一站式完成，免费技术支持可协助模板配置。注册免费试用，领取测试条数后即可配置模板并体验个性化语音播报。