批量发送预警通知：一次调用通知多人/多设备

一次告警往往要通知多个人

凌晨核心数据库主从切换失败，需要同时通知值班DBA、运维组长、业务负责人；一个工业园区的消防告警，要推送到当班安保、园区经理和值班工程师的手机；一次生产事故后的复盘演练，也要把结果同步给整个应急小组。如果程序里逐个号码循环调用发送接口，不仅代码啰嗦，还会因多次网络往返拉长告警延迟，值班人员收到通知的时间参差不齐，先收到的人也不知道其他人是否已知晓。互亿无线预警通知API支持批量发送，一次调用即可通知多人或多个设备，让相关责任人几乎同时收到告警。

本文说明批量发送的参数写法、多通道批量通知的配置，以及多人同时通知的工程做法。

批量号码的传参方式

短信提交接口 https://api.ihuyi.com/sms/Submit.json 的mobile字段支持传入多个号码，号码之间以英文逗号分隔，content为统一的告警文案。语音接口 https://api.ihuyi.com/voice/vm 同样支持批量号码，系统会依次向各号码发起呼叫。闪信接口 https://api.ihuyi.com/flash/Submit.json 用法一致。

import requests

data = {
    "account": "API_ID", "password": "API_KEY",
    "mobile": "13800138000,13900139000,13700137000",
    "content": "【数据库告警】主从复制中断，请DBA立即介入。"
}
print(requests.post("https://api.ihuyi.com/sms/Submit.json", data=data).json())

返回结果中会为每个号码分配对应的smsid，后续可凭smsid分别查询各号码的送达状态，清楚知道哪一位责任人已收到、哪一位尚未送达。这一点在事故复盘时很关键：如果某个关键岗位的回执一直是未送达，就知道要直接打电话找到本人。

多通道批量通知

对于P0紧急告警，需要短信、语音、闪信同时触达多名联系人。通过模板配置可实现发送语音时同步推送闪信与短信，一个接口调用完成多通道、多人推送：

• 值班人员：接收语音呼叫，电话振铃强提醒，及时响应。
• 组长与负责人：接收短信与闪信，短信留档、闪信弹屏可见。
• 备班人员：主联系人未接或未确认时，自动升级通知到备班。

批量发送的工程要点

批量发送虽方便，但要注意以下几点：

1. 单次批量号码数量建议控制在合理范围，超大列表分批提交，避免单次请求体过大或超时。
2. 长短信按多条计费，批量场景下要预估费用，套餐无有效期可灵活抵扣。
3. 不同联系人的告警内容可能需要个性化，此时配合模板变量逐人替换content后再提交。
4. 批量任务要记录每个号码的发送结果，失败号码单独走重试或换通道，而不是整批重发。

在告警风暴场景下，批量发送容易放大通知量，短时间内给多名值班人员推送大量重复告警。建议先做告警去重与合并，把同一对象、同类别的多条告警合并为一条汇总通知，再对合并后的事件批量通知责任人。这样既确保关键信息不遗漏，又避免通知疲劳。

批量通知的值班排班场景

在实际值班排班中，一次告警可能需要按班次通知不同的人。建议在维护一张值班表，记录每个时段的主班、副班和备班号码。告警发生时，程序按当前班次取出号码列表，逗号拼接后一次性提交，主班先收语音，副班和备班收短信。如果主班语音未接，系统在几分钟后自动把同一事件通知副班。这样既不会漏人，也不会让下一个班次的人被无关告警打扰。批量发送后，记得按号码回执确认主班是否真的收到。

互亿无线预警通知API按成功计费、失败不计费，批量发送后未成功的号码不产生费用，注册即送免费测试条数。注册免费试用，领取测试条数后即可体验一次调用通知多人的能力。