什么是批量 SMS?

批量 SMS 是指在一次营销活动或工作流中向多个收件人发送消息。

一家商店可以就同一事件通知许多客户,同时为每条消息做个性化处理。每个收件人仍然需要授权许可和有效的投递路径。

向多个收件人发送时有什么不同?

你需要协调多次独立发送,而不是将一个请求视为完整的营销活动。

每个收件人可能有不同的目的地、发送方要求或同意状态。一个人的成功投递不能说明另一个人的手机情况。

个性化也会改变实际文本内容。更长的姓名或表情符号可能改变编码方式和分段数量。在估算计费量时,按完成后的消息正文计数。

应该使用广播还是 API 批量请求?

使用广播围绕受众、共享内容和发送计划协调活动。使用批量请求从您的应用提交独立消息。

SMS 活动工作流将受众准备、个性化、发布审核和收件人结果串联起来。批量端点提供更窄的操作:将多条独立请求一起接受。

批次标识符不能替代活动所有权、同意记录或发送计划。

Bird 如何接受批量请求?

您通过 POST /v1/sms/batches 提交 1 到 100 条独立消息。

将每个消息对象放入 messages 数组。一个包含 250 个收件人的活动至少需要三次请求,因为每个批次最多容纳 100 条。

Bird 在将任何条目排入队列之前会验证所有条目。一条无效消息会导致整个请求失败,返回 422。修复无效条目后重新提交该批次。

成功时,data 按提交顺序包含已接受的消息。summary.accepted_count 报告已接受的数量。批量参考文档描述了该响应。

将每个返回的消息标识符与其收件人关联保存。后续的投递事件属于这些独立消息,而非某个共享的批次结果。

批次提交成功是否意味着所有人都收到了消息?

202 响应表示 Bird 已接受这些消息进行处理。

计费、运营商提交和投递在之后发生。一条已接受的消息可能失败,而其他消息成功送达。根据每条消息的投递事件更新活动状态。

不要因为一个收件人失败就重新发送整个已接受的批次。调查该消息的错误,判断是否需要单独重试。

如何估算发送时间?

根据每个目的地发送路径适用的限制和容量,分别进行估算。

API 请求速率限制控制您提交工作的速度。投递吞吐量控制后续阶段。提高提交并发数无法消除运营商的限制。

计算容量前先确认计量单位。基于分段的限制会将一条多段消息计数多次。基于请求的限制则按批量调用计数。

Bird 将批量请求归入 sms_batch,与 sms_send 下的单条发送分开计算。请求速率限制指南说明了这些请求策略。SMS 吞吐量说明了独立的投递问题。

发布活动前应检查哪些事项?

检查每个收件人的同意状态、发送方资格和完整的消息内容。

发布排队工作时使用最新的退订状态。之前导出的列表可能包含此后已撤回许可的人。

在将收件人分批之前,先检查目的地的发送方要求。否则一条无效条目可能导致包含大量有效消息的批次被拒绝。

先从小范围群组开始。检查返回的结果,然后再扩大发送范围。这样可以在错误的发送方或消息触达整个列表之前更容易发现问题。

  1. 遵守目的地的规则和每个收件人的许可。
  2. 验证完整的消息正文。
  3. 计算消息的分段数。
  4. 在请求速率限制内提交批量请求。
  5. 按消息跟踪投递结果。逐条调查每个失败。

简而言之

  1. 每个收件人仍拥有独立的消息。

    批次被接受并不意味着所有收件人共享同一个投递结果。

  2. 一个 Bird 批次最多包含 100 条消息。

    使用批量请求发送独立的 API 消息。受众广播负责协调整个活动工作流。

  3. 验证针对整个批次进行。

    一条无效消息会导致 Bird 在任何消息入队之前拒绝整个请求。

  4. 同意状态和发送方资格仍按个体检查。

    在发布营销活动的每个部分时,重新检查权限和目的地要求。

基于同一网络构建。

测试 API 密钥即刻获取。添加付款方式并验证发送者身份后,即可解锁生产环境。

Start building with Bird in minutes.