easyCoexistence
登录开始免费试用
Meta Tech Provider

phone_number_quality_update Webhook

phone_number_quality_update 会报告号码的吞吐量和消息发送限额变化。截至 2026 年，尽管名称如此，它并不携带绿色、黄色或红色质量评级。评级必须直接从电话号码读取。

2026

此字段内容不再包含颜色评级的年份。

3

号码可持有的质量评级为绿色、黄色和红色，但这些评级都不会在此处传递。

131048

质量限制生效后，号码会返回的错误。

这个 Webhook 实际包含什么？

它包含吞吐量和消息发送限额信息，以事件值和携带当前限额的字段传递。

实际内容是号码容量发生了变化：号码移至不同的消息发送层级，或吞吐量级别经过调整。记录这些变化很有用，因为它们会改变集成可执行的操作，而且层级下调通常是较早出现的信号。

尽管字段名称如此，其中并不包含质量评级。根据较早文档编写的处理程序会在此处查找 GREEN、YELLOW 或 RED，却什么也找不到，随后误以为质量从未变化。

那么颜色评级从哪里读取？

按计划直接读取电话号码。

quality_rating 字段位于 Graph API 的电话号码对象中，必须轮询，不能等待推送。这就是为什么要正确监控连接，除了 Webhook 接收器，还需要轮询程序：两者传递的内容不同，单独使用任何一个都不够。

这也是大多数集成无法发现质量下降的原因。系统不会推送这个变化，手机上的 WhatsApp Business 应用也不会显示任何迹象。等到它产生错误 131048 时，受影响的发送已经失败。

常见错误

  • 在此负载中查找 GREEN、YELLOW 或 RED。截至 2026 年，这些内容并不在其中。
  • 只依靠 Webhook 构建监控。质量评级必须轮询。
  • 忽略层级下调。它通常是问题最早可见的信号。
使用 EasyCoexistence 完成这些操作

EasyCoexistence 会轮询每个已连接号码的质量评级、消息发送层级和吞吐量级别，并记录每次检查，让您在一次发送受影响前发现下降。

常见问题

为什么字段名称与质量有关？

它在变化发生前就已存在。名称保留了下来，但内容已经改变，因此容易令人误解。

应该多久轮询一次评级？

频率应足以在下降演变为限额前发现问题。我们按计划轮询，而不是按需轮询。

应用会显示评级吗？

不会。手机上的 WhatsApp Business 应用不会显示任何相关信息。

131048 有关吗？

有关。低评级导致限额后，号码就会开始返回这个错误。

继续阅读

The phone_number_name_update webhookMeta reports display name approvals and rejections here. It is the only place the decision appears, and nothing shows it in the app.The message_template_status_update webhookMeta reports template approvals, rejections and disabling here. What each status means and why it removes the need to poll.WhatsApp error 131048: spam rate limit hitError 131048 means the number's quality has dropped far enough that Meta is limiting sends. What causes the drop and how a number recovers.A number stopped working: how to find out whyA checklist in the order these failures actually happen: token, webhook override, inactivity disconnection, quality, and account restriction.

准备开始了吗？

几分钟即可设置 WhatsApp Coexistence，而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间

phone_number_quality_update