> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 消息限制与吞吐量

> 在规划消息发送时，了解消息限制与吞吐量。

在规划大规模发送之前，请区分可以触达的客户数量与发送消息的速度。

## 消息限制在整个业务资产组合中共享

Meta 在 **业务资产组合** 层级计算消息限制。其包含的电话号码共享可用容量。

该限制针对在滚动 24 小时周期内在客户服务窗口之外送达消息的唯一接收者。它不是总在午夜重置的日历日计数器。

例如，如果两个团队使用同一资产组合中的不同号码，一个团队的营销活动可能会消耗另一个团队所需的容量。添加另一个号码并不会创建单独的资产组合额度。

## 当前层级与扩容

Meta 记录了以下层级：

* 新创建的业务资产组合为 250。
* 完成符合条件的扩容途径并通过 Meta 质量评估后为 2,000。
* 通过进一步的自动扩容可达到 10,000、100,000 以及无限制。

### 达到 2,000 接收者层级

Meta 记录了三种准入途径：验证企业、完成适用的合作伙伴主导的验证流程，或建立符合条件的消息使用量。

使用量途径要求在滚动的 30 天内，使用高质量模板向服务窗口之外的唯一 WhatsApp 用户送达 2,000 条消息。完成某一途径会触发质量评估，但并不保证一定获批。

如果 Meta 拒绝或推迟提升额度，请查看具体的资格通知。通知中可能会要求提供进一步的身份信息或符合条件的使用量。请勿仅为了累积发送量而发送不受欢迎的消息。

### 扩容超过 2,000

Meta 会评估整个资产组合中各个号码和模板的消息质量，同时评估企业在过去 7 天内是否已使用其当前限制的至少一半。其官方说明的自动扩容流程会在 6 小时内将符合条件的资产组合提升一个层级。

这是平台的条件性流程，并非 YCloud 按需提升限制的承诺。在安排依赖该层级的工作负载之前，请先确认调整后的层级。

在 **WhatsApp 管理工具 → 账户工具 → 消息限制** 中查看当前限制。请参阅 Meta 的 [消息限制文档](https://developers.facebook.com/docs/whatsapp/messaging-limits/) 获取最新的扩容规则。

<Note>
  较旧的文档和集成可能会显示电话号码级别的层级（例如 1,000）或较旧的消息限制字段。请勿将它们作为当前资产组合容量的参考依据。
</Note>

## 吞吐量是独立的限制

吞吐量衡量发送速度，通常以每秒消息数（MPS）表示。实际速度可能取决于号码的连接模式、Meta 容量、YCloud 发送路径、排队情况以及针对接收者的特定控制。

请勿假定 Meta 公布的最大 Cloud API 吞吐量就是每个 YCloud 号码都可用的速度。特别是，在规划突发流量之前，请单独查阅 [共存](/zh/documentation/whatsapp-business-platform/accounts-and-business-identity/whatsapp-business-app-coexistence) 相关内容。

对于时间敏感的发送任务，请确认实际配置支持的速率并测试具有代表性的流量。请求进入队列并不代表能在截止时间内送达。

## 分别计算接收者数量和处理时间

### 共享容量示例

假设资产组合的当前层级为 2,000，且在其滚动 24 小时周期内已计入 1,700 个不同接收者。在其他活动发生或早期活动移出时间窗口之前，其剩余的新增不同接收者容量约为 300。

如果另一个团队从同一资产组合中的第二个号码向 400 个新接收者发送消息，不能假定拥有全新的 2,000 接收者额度。需协调两个团队的发送计划。

在相关统计周期内，向已计入的同一接收者重复发送消息与添加新的唯一接收者是不同的。在预估容量时，请对跨号码的接收者集合进行去重。实际 Meta 计数器始终具有权威性，尤其是在服务窗口状态和送达时间存在差异的情况下。

### 吞吐量示例

文档标明为每秒 5 条消息的共存号码至少需要：

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
3,000 messages ÷ 5 messages/second = 600 seconds = 10 minutes
```

这是在持续速率下的理论提交时间下限，并非送达承诺。排队、其他流量、错误或接收者控制可能会使实际过程更长。

在庞大队列清除之前，生成已 10 分钟的 OTP 或在 2 分钟内过期的优惠可能会失效。请根据消息的有效生命周期来评估工作负载规模，而不能仅看资产组合层级。

## 针对具体限制采取正确应对措施

| 限制 | 有效措施 |
| - | - |
| 滚动接收者容量耗尽 | 等待容量释放并协调全资产组合的发送计划；单独检查扩容资格。 |
| 超过吞吐量 | 降低分发速率并应用有界退避策略。 |
| 短时间内向同一用户发送过多消息 | 放缓该接收者的发送序列；检查为何多个工作流同时发送。 |
| 接收者维度的营销控制 | 遵循接收者控制指南；更高的业务资产组合等级无法绕过此限制。 |
| 模板或账户受限 | 暂停并解决受影响的模板或资产问题。提高队列速度无法解决此问题。 |

不要将“无限制”视为无限制的速度、无约束的联系权限或保证送达的营销消息。

## 规划安全的发布方案

* 在安排发送计划前检查业务资产组合等级。
* 协调共享该业务资产组合的所有号码的发送任务。
* 移除重复的接收者并应用退订设置。
* 先从相关度高的受众开始发送，并观察质量评级。
* 为重试、排队和送达延迟预留空间。
* 当反馈或错误提示存在问题时，暂停或减少发送量。

对于速率限制（rate-limit）错误，在重试前请确认触发了哪项限制。短暂的吞吐量限制与已耗尽的滚动接收者额度需要采取不同的应对措施。

## 如果可用容量不符合预期

记录业务资产组合、WABA、号码、当前等级、受影响的时间段以及示例消息错误。将其与同一业务资产组合中的其他活动进行对比。

如果账户受到限制，请参考 [账户限制与申诉](/zh/documentation/whatsapp-business-platform/consent-policies-and-account-health/account-restrictions-and-appeals)，而不是将每次失败都当作需要申请更高等级。

## 常见问题

<AccordionGroup>
  <Accordion title="添加另一个号码会使我的消息发送上限翻倍吗？">
    如果号码共享同一个业务资产组合，则不会。需要对照业务资产组合共享的接收者额度来协调它们的主动发送任务。添加号码属于注册上限相关的问题，并不会为每个发信方创建独立的额度。
  </Accordion>

  <Accordion title="等级显示为无限制，为什么我仍会看到发送错误？">
    无限制的接收者容量并不等同于无限制的 API 发送速度或无约束的送达。请检查错误是否由吞吐量、单接收者发送频率、营销送达控制、暂停的消息模板、账单问题或账户受限引起。提升业务资产组合等级无法解决所有这些情况。
  </Accordion>

  <Accordion title="额度会在我所在时区的午夜重置吗？">
    它是按 24 小时滚动计算的，而不是按自然日计数的。请检查整个业务资产组合中相关的已送达主动活动。仅在午夜过后立即安排同一大批受众的发送任务，并不会自动为您提供全新的额度。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.