登录开始免费试用
Meta Tech Provider

连接后号码显示待处理或离线

在 WhatsApp Manager 中,离线是 WhatsApp Business 应用号码加入 Cloud API 之前的正常状态,它不代表是否符合条件。Coexistence 连接完成后,Meta 的检查项为 is_on_biz_app 为 true、platform_type 为 CLOUD_API,只有状态为 connected 的号码才能收发消息。如果号码持续显示待处理或离线,请在重新连接前先查看这些字段。

easyCoexistence 全天候监控每个已连接号码,在时间线上记录 Meta 的断开原因,并让你自己的 AI 通过 get_number_health 读取实时状态。

connected

Meta 要求商务电话号码的状态为 connected,才能通过 API 收发消息。

PENDING

Meta 号码 API 所列的连接状态之一,其他状态包括 CONNECTED、DISCONNECTED、FLAGGED、RESTRICTED 和 RATE_LIMITED。

is_on_biz_app

当 platform_type 为 CLOUD_API 时,Meta 会测试该号码能否同时用于 Cloud API 和 WhatsApp Business 应用。

Skip

Meta 告知平台跳过 Coexistence 号码的注册,因为该号码已经注册。

133010

Cloud API 在号码已关联账户但从未注册时返回的错误。

BLOCKED

号码未通过一项或多项消息发送要求时,Meta 健康状况返回的 can_send_message 值。

待处理和离线显示在哪里?

它们是 Meta 的标签,显示在 WhatsApp Manager > 号码中,并反映在 Meta API 为该号码返回的状态里。它们不是 easyCoexistence 的标签。我们的控制台有自己的标签:已连接、降级、已断开、已封禁/受限、已暂停和未知,根据我们对质量、断开事件和封禁的监控设定。

两个视图回答的是不同的问题,因此短时间内可能不一致。WhatsApp Manager 显示 Meta 当前如何对该号码分类。我们的控制台显示连接是否正常、是否健康,并在号码的时间线上记录每次变化。两者不一致时,以下文所述的实时字段为准。

未连接前显示离线正常吗?

正常。只存在于 WhatsApp Business 应用中的号码尚未在 Cloud API 上,所以如果 WhatsApp Manager 列出了它,可能显示离线或离线 / 未验证。这种状态不会阻止 Coexistence,也不代表是否符合条件;只有 Meta 的连接步骤能做出判断。

不要试图在 WhatsApp Manager 中通过注册或请求验证码让它上线。那是迁移路径,会把号码移出 WhatsApp Business 应用。Coexistence 通过 Meta 的注册窗口连接号码,在应用中扫描二维码,Meta 也会告知平台跳过对它的注册。

完成连接后应显示什么?

Meta 给出一项明确的检查,手机也会用通俗的文字确认。如果连接后几分钟 WhatsApp Manager 仍显示旧标签,请先刷新页面再采取行动;下列字段才是可靠的检查方法。

  • Meta 在号码上的字段:is_on_biz_app 为 true,platform_type 为 CLOUD_API。
  • Meta 的状态:connected,这是通过 API 收发消息的必要条件。
  • 在手机上:WhatsApp Business 应用提示该号码已连接到 API。
  • 在应用中:设置 > 账户 > Business Platform 会列出服务提供商。

如果字段显示号码已离开商务应用怎么办?

那么该号码很可能是用短信或语音验证码而非二维码完成验证的。这属于迁移路径,而非 Coexistence:号码会离开 WhatsApp Business 应用(is_on_biz_app 为 false),在 Cloud API 上却未注册,首次发送会失败并返回错误 133010。我们已于 2026 年 10 月 19 日验证过一个真实案例。

之后无法再以 Coexistence 方式完成。有两种出路,且都需要服务提供商的团队参与:让号码仅保留在 API 上并完成注册,或将其退回应用并通过二维码重新连接。在 Coexistence 连接过程中,切勿在 Meta 的窗口中请求验证码。

数周后显示离线或已断开

曾经正常工作后又掉线的号码,情况不同。如果手机上的 WhatsApp Business 应用约 14 天未打开,Meta 会断开 Coexistence 号码,并在 account_update Webhook 中报告为 PRIMARY_INACTIVITY。Meta 报告的其他原因还包括:关联设备约 30 天未使用、手机上更换了号码,以及该号码在另一台设备上重新注册。

在 easyCoexistence 上,控制台会将该号码显示为已断开,并附上 Meta 的原因,所有者还会收到一封邮件。针对不活跃的修复方法是:在该手机上打开应用,让它同步,然后重新连接。API 消息不算打开应用。

你或你的 AI 如何检查实时状态?

让你的 AI 运行 get_number_health,或用通俗的话请它检查你的 WhatsApp 号码健康状况。该工具读取 Meta 对号码的实时快照(status、platform_type、is_on_biz_app 和 quality),并返回其监控时间线最近 15 条事件。coexistence_link_ok 字段汇总了号码是否仍与应用保持关联。另外,easyCoexistence 会读取 Meta 的健康状况,并在发送变为 BLOCKED 时向所有者发送邮件。

Part of a get_number_health result for a healthy Coexistence number (illustrative)
{
  "live_snapshot": {
    "status": "CONNECTED",
    "platform_type": "CLOUD_API",
    "is_on_biz_app": true,
    "quality_rating": "GREEN"
  },
  "coexistence_link_ok": true
}

常见错误

  • 在连接前于 WhatsApp Manager 中注册号码以清除离线状态。这是迁移路径,会把号码移出 WhatsApp Business 应用。
  • 在 Meta 的窗口中请求短信或语音验证码。Coexistence 连接使用在应用中扫描的二维码。
  • 一看到待处理就移除并重新连接,而没有先读取 is_on_biz_app 和 platform_type。
  • 把控制台标签当作 Meta 的状态。二者来自不同的检查;以实时字段为准。
使用 EasyCoexistence 完成这些操作

号码保留在 WhatsApp Business 应用中,你的自动化通过 Meta 官方 API 在其上运行。每个号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。

常见问题

号码显示待处理时能发送消息吗?

Meta 要求状态为 connected 才能通过 API 收发消息,因此在此之前 API 发送会失败。手机上的应用仍照常工作。

离线是否意味着手机已关机?

本身并不意味着。API 不要求应用在每一刻都保持打开;Meta 强制的是至少每 14 天在该手机上打开一次应用。

为什么控制台显示已连接,而 WhatsApp Manager 显示待处理?

当 Meta 完成注册后,控制台会将号码标记为已连接,之后再跟踪质量、断开和封禁情况。get_number_health 直接读取 Meta 的实时状态。

客户的消息仍能送达手机吗?

能。无论 API 显示什么状态,WhatsApp Business 应用都会在手机上继续接收和发送消息。

继续阅读

准备开始了吗?

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

开始免费试用

验证时间