Meta Tech Provider
WhatsApp 错误 131056:向同一收件人发送的消息过多
错误 131056 表示您的业务号码在短时间内向同一收件人发送了过多消息。这是针对每个号码对的速率限制,与账户整体吞吐量分开,通常表示某项自动化流程在重复执行。
为什么按号码对限制
因为它要防止的不是一般性的消息量,而是某个人被大量消息淹没。账户整体吞吐量可能仍在限制以内,但如果在 1 分钟内向同一收件人发送 30 条消息,对方仍会把它视为垃圾消息,与账户总量无关。
因此,限制针对号码对,而不是账户。这也解释了为什么消息量很低、从未接近整体速率限制的号码,也可能出现此错误。
通常是什么原因
几乎总是由自动化流程引起,而不是人为输入。
- 重试循环把投递失败当成发送失败,因而再次发送。
- Webhook 处理程序发送回复,并因同一事件被多次调用而重复发送。
- 聊天机器人在很短时间内将一条回复拆成多条短消息。
- 开发期间,测试脚本反复向同一号码发送消息。
如何避免
在对话层级限流,而不只是账户层级限流。在发送前限制每位收件人每分钟可接收的消息数,几乎不会增加成本,却能防止此错误及其带来的客户体验问题。
消息去重同样重要。Webhook 事件可能被投递多次。如果处理程序发送回复前不检查自己是否已处理该 message id,负载升高时就会产生这种情况。
常见错误
- 重试,导致向已经被大量消息淹没的收件人再发送一条消息。
- 只在账户层级限流。此限制按收件人计算。
- 处理 Webhook 事件时,没有按 message id 去重。
使用 EasyCoexistence 完成这些操作
EasyCoexistence 会将每个消息事件发送到您自己的端点,并完整保留其 message id,因此去重依据是 Meta 发送的数据,而不是我们重新整理后的副本。
常见问题
这是我的账户速率限制吗?
不是。账户速率限制的代码是 130429。此限制按收件人计算。
为什么消息量低也会出现?
因为限制针对号码对,而不是账户总量。
如何停止此错误?
按对话限流,并按 message id 对 Webhook 事件去重。
我应该重试吗?
不应该。重试会向同一收件人再发送一条消息。
继续阅读
WhatsApp error 130429: throughput limit reachedError 130429 means the messaging throughput limit was reached. What sets the cap, why it is temporary, and why Coexistence numbers hit it sooner.WhatsApp error 131016: service unavailableError 131016 means a WhatsApp service is temporarily unavailable. It is transient, and one of the few errors that a backoff retry actually resolves.The messages webhookEverything a customer sends arrives on this field. What the payload carries, how to acknowledge it, and why it never reaches a provider on a routed number.WhatsApp Coexistence: the app and the API on one numberCoexistence runs the WhatsApp Business app and the Cloud API on the same number at once. What it changes, what it does not, and how a number gets connected.WhatsApp error 80007: rate limit on the WhatsApp Business AccountError 80007 means the WhatsApp Business Account hit a rate limit. It applies to management calls rather than messages, and polling is the usual cause.WhatsApp error 100: invalid parameterError 100 means a parameter was unsupported, misspelled or malformed. It is the broadest error on the platform and it never clears by retrying.
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间