WhatsApp 官方规则：号码数量 & 消息条数限制
English: whatsapp-limits.md
来源：Meta for Developers 官方文档（WhatsApp Business Platform） 整理日期：2026-07-02 ｜ 适用模型：v24.0（Portfolio-based messaging limits）
一、层级结构（先理清对象关系）
Meta Business Account (Business Portfolio)
└── WABA (WhatsApp Business Account)
└── 电话号码 (Business Phone Number) = 一个 WhatsApp Sender
- 一个电话号码 = 一个 Sender（一一对应，无法一号多 Sender）。
- 一个 Twilio Account 只能绑定一个 WABA；因此 Twilio 侧的 Sender 上限 = 该 WABA 的号码上限。
二、号码数量规则（Phone Number Limits）
| 项目 | 官方上限 | 说明 |
|---|---|---|
| 每个 Meta Business Account 的 WABA 数 | 初始 20 个 | 可申请提升 |
| 每个 WABA 的号码数（未验证） | 2 个 | 跨该 Portfolio 所有 WABA 合计 |
| 每个 WABA 的号码数（验证后） | 最多 20 个 | 需组织性活跃使用后由 Meta 自动放开 |
| 每个 WABA 的模板数 | 未验证 250 个；验证后最多 6,000 个 | message templates |
号码上限提升条件（2 → 20）
- 完成 Business Verification（商家验证），或
- 已达到 2,000 的 messaging limit
- 满足后 Meta 会自动提升号码上限；要超过 20 个需持续活跃使用 + 保持高质量评分，由 Meta 逐步放开。
结构性硬约束
- 一个 WABA 只能属于一个 Business Portfolio，不能被多个 Portfolio 共有。
- WABA 无法在不同企业主体之间迁移。
三、消息限制规则（Messaging Limits）
官方将「消息限制」分为两个完全独立的维度：
- Messaging Limit —— 24h 内能主动触达多少「独立用户」（管"发给多少人"）
- Throughput —— 每秒吞吐 + 对同一用户的频率（管"发多快"）
维度 1：Messaging Limit（触达广度）
官方定义：在一个滚动 24 小时内，于客服窗口（customer service window）之外，能向多少个独立 WhatsApp 用户号码投递消息。
两个核心要点
- 按 Portfolio 共享，不按号码计：该 Portfolio 下所有号 码共用同一限额；单个号码可能耗尽整个 Portfolio 的配额。（v24.0 起的新模型；旧版为按号码计、首档 1,000）
- 仅作用于客服窗口外的主动消息（模板消息）：用户主动发起、你在 24h 窗口内的回复不计入此限额。
档位阶梯
| 档位 | 24h 内可触达独立用户数 |
|---|---|
| 初始（未验证） | 250 |
| 第一次提升 | 2,000 |
| 后续自动扩容 | 10,000 → 100,000 → 无限 (Unlimited) |
从 250 → 2,000 的 Scaling Path（任选其一）
- 通过 Business Verification（商家验证），或
- 在滚动 30 天内，用高质量评分模板向独立用户投递 2,000 条「客服窗口外」消息
- 完成后 Meta 分析消息质量，决定批准 / 拒绝自动扩容资格。
2,000 之后的自动扩容条件（两条须同时满足）
- 所有号码与模板均发送高质量消息（质量评分保持 Green / 良好）
- 过去 7 天内用掉了至少当前限额的一半
- Meta 每 6 小时评估一次，满足即自动提升一档。
质量评分（Quality Rating）影响
- 评分由 Meta 依用户信号（拉黑、举报、低互动）设定，按 recency 加权。
- 掉到 Yellow 会冻结当前档位；掉到 Red 可能下调限额。
- 质量优先于用量：质量差，量再大也无法升档。
维度 2：Throughput（发送速率）
| 项目 | 官方规则 |
|---|---|
| 整体吞吐 | 默认 80 条/秒（MPS），文字与媒体同限；满足条件（Unlimited 档 + 24h 内发送 10 万条 + 质量评分 ≥ Medium）后由 Meta 自动免费升至 1,000 MPS（无需申请）；超限报 Cloud API 130429（Twilio 63018） |
| 对同一用户频率 | 存在对同一用户的 pair rate limit，超限触发 error 131056；「每 6 秒 1 条」为第三方普遍引用值，Meta 官方未公布确切速率 |
| 突发（burst） | 6 秒内最多 45 条，但会借用未来配额，突发后须等待相应时间 |
相关错误码
63018（Twilio 侧）/ Rate Limit Exceeded — 超过每秒吞吐档位131056— 对同一用户发送过快63104— 已达该 WABA 的号码数量上限63051— 号码因 30 天内无活动被 Meta 锁定（需重新注册激活）
四、字符长度限制（补充）
| 消息类型 | 上限 |
|---|---|
| 非模板（会话内自由消息） | 4,096 字符 |
| 模板消息 | 正文 1,024 字符（变量 {{n}} 计 1 字符）；header 60 / footer 60 / 按钮文案 25 |
| Twilio API 单请求 | 1,600 GSM 字符 |
五、一句话速记
- 号码数量： 未验证 = 2 个；验证后 ≤ 20 个；每 Meta Business Account 初始 ≤ 20 个 WABA。
- 能发多少人：按 Portfolio 共享；250 起 → 2,000 →（自动）10K → 100K → 无限；仅算窗口外模板消息。
- 能发多快：默认 80 条/秒（达标后自动升至 1,000）；对同一用户存在 pair rate limit（官方未公布确切速率）。
- 接收 + 窗口内回复：不受上述限额约束。
六、对多租户 / 规模化的关键启示
- 加号码 ≠ 加容量：同 Portfolio 下 Messaging Limit 共享。要按租户隔离容量，须拆分到不同 Business Portfolio。
- Business Verification 是所有天花板的钥匙：不验证永远卡在「2 个号码 + 250 触达」，且无法进入任何升档路径。
- 规模化路径：几十~上百个独立号码需走 ISV / Tech Provider Program（多 subaccount + 多 WABA）。
- 合规前提：Meta commerce policy 对加密货币类业务限制严格，Business Verification 与模板审核均可能被拒——建议在搭建架构前优先验证主体资格。
七、容量扩展阶梯（h.work 补充：1:1 专属号模式下的扩容路径）
本节为 h.work 补充（非 Meta 规则翻译）：采用「1 个 AI Specialist = 1 个 WhatsApp 号」的专属号模式（ADR-030 方向）时，号码需求随 Specialist / 客户增长的扩容路径，按启用顺序排列。
| 阶段 | 号码规模 | 路径 | 要点 |
|---|---|---|---|
| 第 0 级（必做前置） | ≤ 20 | Business Verification | 号码上限 2 → 20，触达档 250 → 2,000；所有后续路径的前提 |
| 第 1 级 | 20 ~ 50 | Meta Direct Support 人工工单 | 无承诺 SLA；批复取决于已验证主体 + 质量评分保持 Green + 真实业务用量；需提前 4~8 周申请，不能等签约后再办 |
| 第 2 级（结构性解法） | 50+ / 客户要求自有品牌发信 | ISV / Tech Provider + Embedded Signup | 每个客户注册自己的 Business Portfolio + WABA（用客户法人验证）；号码与触达配额记在客户 portfolio、不占 h.work 的——容量随客户数线性扩展，且每客户独立配额池与独立质量评分。代价：客户各自过 Meta 验证（数天）、发信身份变为客户企业名、运维复杂度上升（Twilio 侧对应 subaccount per client） |
| 第 3 级 | 区域扩张时 | 多法人 → 多 Portfolio | 每个 portfolio 独立号码上限与配额；仅限合规 / 数据驻留驱动——为绕上限设空壳实体属 Meta 规避行为，有整个 portfolio 被封风险 |
需求侧节流（与上述并行）
- 号码回收：客户流失 / OSA 停用即释放号码（ADR-030 已设计 revocation 流程）；注意 63051 三十天闲置锁与释放后的冷却期（不能立即复用）。
- 混合溢出：高价值 Specialist 用专属号；长尾走 org 前门号（一个客户 org 一个号、org 内分流，ADR-028，当前 deferred）。
- 排队而非失败：撞上限的新 OSA 进入
number_capacity_pending状态排队等容量（ADR-030 §8.2 / Phase 2.5whatsapp_portfolio_capacity），AM 面板可见余量。
两个常见误区
- 多开 Twilio subaccount 不增加容量——上限在 Meta portfolio 层，不在 BSP 层。
- 同 portfolio 内多开 WABA 也不增加容量（见「结构性硬约束」与 ADR-030 不变量 I-4：
capacity不是合法的 secondary-WABA 理由）。
相关：ADR-030 渠道凭证隔离（WhatsApp 子文档）。
参考来源（Meta 官方文档）
- Messaging Limits — https://developers.facebook.com/docs/whatsapp/messaging-limits/
- Business phone numbers — https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers
- WhatsApp Business Accounts — https://developers.facebook.com/documentation/business-messaging/whatsapp/whatsapp-business-accounts
- About the Platform（throughput / 频率） — https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform
- Changelog（v24.0 Portfolio-based 变更） — https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog
2026-07-03 官方文档核对勘误（对照 Meta for Developers / Twilio 官方文档逐条核实）
- 模板数：250 仅适用于未验证商家；完成验证后每 WABA 上限为 6,000（原文只写 250，不完整）。
- 字符长度：会话内自由消息上限为 4,096 字符（原文写 1,024，有误——1,024 是模板正文的上限，变量 {{n}} 计 1 字符）；「约 550 字符、emoji ≤ 10」无官方出处，已更正为官方值（header 60 / footer 60 / 按钮 25）。
- 吞吐（Throughput）：现行规则为自动免费升档——Unlimited 档 + 24h 内 10 万条 + 质量 ≥ Medium → 自动升至 1,000 MPS，且文字与媒体同限；原文「纯文字 400/1000 需审批、媒体不可超 80」为旧模型。超吞吐的 Cloud API 错误码是 130429（Twilio 侧对应 63018）。
- 对同一用户「每 6 秒 1 条」：Meta 官方未公布确切 pair rate，该数字为第三方普遍引用值；131056 错误码与「6 秒内最多 45 条突发（借用未来配额）」有多方佐证，已保留并加注。
- 其余关键数字核对无误：号码 2 → 20、Portfolio 级共享限额（2025-10-07 起）、250 → 2,000 →（自动）10K → 100K → 无限、30 天滚动 2,000 条高质量模板路径、每 6 小时评估、Twilio 63018/63051/63104、Twilio 单请求 1,600 GSM 字符。