Skip to main content
批量个性化短信让你可以在一次 POST /v5/sms/sends 请求中发送最多 100 条定制化消息。你无需为每个收件人分别发起 API 调用,而是定义一个全局模板,并有选择性地为任何单个收件人覆盖内容、模板名称或个性化标签。

批量短信的工作原理

每个批量请求都由两个层次组成:
  1. 全局层 —— 默认的 content 字符串或 templateName,以及可选的 params 标签值,应用于每个未提供自己覆盖的收件人。
  2. 逐收件人层 —— toList 中的单个条目可以携带自己的 contenttemplateNameparams,对该收件人而言,优先于全局值。

参数优先级(从高到低)

使用 {{tag}} 占位符

在任何 content 字符串中包含 {{tagName}} 标记,即可在发送时注入动态值。

发送个性化批量消息

端点: POST /v5/sms/sends

请求参数

顶层字段

toList 条目字段

小技巧

  • 每批保持在 100 条以内。
  • 受监管内容优先使用模板。
  • 使用 sandboxMode 进行测试。
  • 减少冗余的逐收件人覆盖。