> ## 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.

# 质量与送达控制

> 了解已获批消息被延迟或拦截的原因，并根据质量信号做出响应，避免盲目重试。

有效的 API 请求和已获批的模板并不保证每条消息都能送达接收者。

WhatsApp 使用质量信号和送达控制来保护客户免受垃圾消息的骚扰。在修改模板、增加支出或重试营销活动之前，请先排查受影响的层级。

## 可能影响送达的控制机制

**限速控制 (Pacing)** 允许 WhatsApp 在释放更多消息之前评估用户对模板的响应。不要将每一次延迟都视为传输故障。

在收到负面反馈或互动度较低时，**暂停或停用** 可能会导致模板不可用。在安排后续发送之前，请检查当前的模板状态。

即使您自己的账户配额充足，**接收者层级的营销限制** 也可能会阻止客户接收其他营销消息。这些限制旨在保护客户的整体体验，而不仅仅针对来自您企业的消息。

Meta 在[模板基础知识](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/)中说明了这些机制。相关阈值和可用性可能会发生变化；请勿向每个客户承诺固定的配额。

## 根据结果排查问题

| 观察现象 | 首选应对措施 |
| - | - |
| 请求已接受但尚未送达 | 关注状态更新并检查是否处于待处理状态；请勿立即重复发送。 |
| 模板已暂停或停用 | 停止依赖该模板的发送任务，并检查反馈和内容。 |
| 失败集中在单个模板 | 检查该模板的类别、质量、状态以及近期受众。 |
| 失败集中在个别客户 | 排查特定接收者的错误信息以及其沟通偏好设置。 |
| 失败影响多个模板和号码 | 检查账户容量配额、账户状态、集成健康状况和账单设置。 |

有关单条消息的生命周期，请参阅[消息送达状态](/zh/documentation/whatsapp-business-platform/messaging/message-delivery-statuses)。联系支持团队时，请保留准确的错误代码及相关标识符。

## 常见错误代码及后续检查项

YCloud 可能会返回自身的错误以及上游 WhatsApp 的错误。请保留实际的代码和详细信息；以下是常见的 **Meta** 错误代码，而非所有可能的 YCloud 返回结果。

| 错误代码 | 检查项 |
| - | - |
| `130429` | 超出吞吐量限制；请降低发送速率。 |
| `131026` | 无法送达；请勿直接断定接收者拉黑了您。 |
| `131042` | 账单或付款设置问题；不一定属于政策封禁。 |
| `131047` | 服务窗口已过期；请选择合适的已获批消息模板。 |
| `131049` | 接收者/互动度送达控制；请避免立即重试。 |
| `131050` | 接收者已退订您企业的营销消息；请勿重试该营销发送。 |
| `132000` | 消息模板参数数量不匹配。 |
| `132001` | 消息模板名称、语言或获批状态不匹配。 |
| `132015` / `132016` | 消息模板已暂停或停用；请停止依赖该模板的发送任务。 |

对于 `131049`，Meta 建议在怀疑触及接收者限制时至少等待 24 小时后再尝试重新发送。等待 **并不能** 保证一定送达；首先请确认用户的授权许可、内容相关性以及再次尝试是否合理。这与表示接收者已退订营销消息的 `131050` 不同。

来源：[Meta 错误代码](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)。

## 进行针对性诊断

按模板、发送者、受众来源、时间和错误信息，对比一小批具有代表性的消息。切勿通过重复联系同一个失败的接收者来进行测试。

例如，如果单个模板在多个号码上均发送失败，而其他模板正常，请首先调查该模板的状态和参数。如果账单发生变更后许多模板均发送失败，请在重写文案之前先检查账单和账户配置。

建立简要的事件记录：观察到的故障、受影响范围、最后一次已知成功发送的时间、近期变更、控制措施以及下一步负责人。这样可以将“WhatsApp 无法工作”转化为具体且可测试排查的问题。

## 改善客户体验

在追求发送量之前，先从内容相关性入手：

* 发送符合客户在选择加入（Opt-in）时所预期的内容。
* 结合客户近期的意向，并提供明确的联系理由。
* 统筹协调营销活动与自动化流程之间的发送频率。
* 清晰表明您的企业身份。
* 确保内容准确、实用且易于采取行动。
* 提供简便直接的退订方式并及时生效。

同时监控送达结果与客户回复。高送达率伴随退订人数增加并不代表这是一次健康的营销活动。

## 审慎进行重试

仅在错误提示属于可恢复情况且消息仍具时效价值时才进行重试。请设置重试次数上限，并避免向客户发送重复通知。

切勿反复重新发送已被拦截的营销消息、轮换商业号码，或将促销内容重新标记为效用类消息以绕过管控机制。

如果客户主动发起新对话，请使用允许的消息类型针对其具体请求进行回复。切勿将该互动视为可以重新启动无关营销活动的许可。

## 相关主题

* [模板审核与生命周期](/zh/documentation/whatsapp-business-platform/messaging/message-templates/template-review-and-lifecycle)
* [消息发送限制与吞吐量](/zh/documentation/whatsapp-business-platform/pricing-limits-and-quality/messaging-limits-and-throughput)
* [客户退订](/zh/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-out)
* [账户限制与申诉](/zh/documentation/whatsapp-business-platform/consent-policies-and-account-health/account-restrictions-and-appeals)


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