发起呼叫：单次与批量

本页说明如何从单通试呼到批量任务的完整发送实践，以及批量处理、失败重试的语义。

开始前的准备

• 已有审核通过的模板（见 使用语音控制台）
• 测试阶段建议将号码加入测试白名单（见 使用语音控制台）

选择发送方式

两种方式走同一呼叫链路，结果语义一致。

号码与国家

• 被叫号码为 E.164 格式（国家区号 + 本地号码，请求中不含 +），如 8613800138000；区号表见 国家/地区编码
• 呼叫国家由模板决定：发送时无需传国家编码；被叫号码的区号须与模板国家匹配，否则返回 120003
• 单次 API 请求最多 1000 个被叫；Console 任务支持更大的批量导入

模板与变量

• 模板变量用 {1}、{2} 序数占位符，按号码传值：{"to": "8613800138000", "variables": ["张三", "A12345"]}
• 变量顺序必须与占位符一致；无变量模板省略 variables
• 播放次数可在模板默认值基础上按次覆盖

定时发送