Meta 在 14 天后断开的号码如何重新连接(PRIMARY_INACTIVITY)
主手机上的 WhatsApp Business 应用约 14 天未被打开时,Meta 会终止 Coexistence 号码的 Cloud API 部分,并以 PRIMARY_INACTIVITY 作为原因报告。要恢复,请在该手机上打开应用并等待同步,然后使用同一号码重新运行 Embedded Signup 流程。应用、其中的聊天以及号码本身均不受影响。
easyCoexistence 一旦收到 Meta 报告的中断,就会向所有者发送邮件,号码页面也会说明原因:「Meta 断开了此号码,因为手机上的 WhatsApp Business 应用约 14 天未被打开」,旁边有一个「重新连接此号码」按钮。
PRIMARY_INACTIVITY 断开原因背后是主设备长期未使用。
Meta 的 PARTNER_REMOVED 负载示例中,PRIMARY_INACTIVITY 对应的 initiated_by 为 SYSTEM,即由平台终止,而非个人。
企业在取消接入后重新接入同一合作伙伴时,Meta 发送的是 account_update 事件。
接入后用于同步联系人与聊天记录的时间窗口,每次接入仅可使用一次。
控制台建议的打开频率,比 Meta 规则留有余量。
PRIMARY_INACTIVITY 是什么意思?
这是 Meta 在主设备长时间未活动时,从 Coexistence 号码中移除 API 所给出的原因。Meta 会发送一条 account_update Webhook,其中事件为 PARTNER_REMOVED,disconnection_info 内的原因为 PRIMARY_INACTIVITY,文档说明为主设备约 14 天处于非活动状态。在 Meta 的示例负载中,initiated_by 为 SYSTEM。
主设备是在 WhatsApp Business 应用中持有该号码的手机。它本身不会有任何变化:客户照常发消息,团队照常回复,聊天记录也保持原样。中断的是 API 一侧的全部功能:通过 Cloud API 发送的消息会失败,Webhook 停止送达,自动化、AI 回复和相连系统在该号码上都会静默,直到重新连接为止。
为什么没人注意到中断?
因为最接近号码的人都在用手机,而手机照常工作。API 一侧中断时,应用不会显示任何提示,因此店铺可能连续数日以为自动化在回复,而客户只有在有人恰好拿起手机时才能得到回复。
常见情况是:企业接入了号码,设置了 AI 回复或 Webhook 对接自身系统,之后团队改用 WhatsApp Web 或第二台设备工作,主手机则被放进抽屉。关联设备并不能让主手机保持活跃。WhatsApp 还表示,主设备长时间未活动,会使其关联设备登出,因此抽屉里的那台手机最终也会带走这些关联设备。
重新连接后需要重做什么?
重新连接属于通过 Embedded Signup 的一次新接入,因此以下几项会作为新的决定重新设置,而不会自动沿用。
- Webhook 目的地。Meta 将其存为服务商应用订阅上的覆盖配置,而
PARTNER_REMOVED会将其与应用一同卸载。必须重新设置。 - 聊天记录。应用会再次询问是否分享,并开启一个新的 24 小时窗口,用于同步联系人和聊天记录。
- 旧连接发放的访问令牌可能已失效。重新连接后请重新获取凭据。
- 对于 Coexistence,Meta 会保留原有的消息账户 ID,因此 WhatsApp Business 账户与之前相同。
中断期间收到的消息怎么样了?
这些消息和其他消息一样到达了手机上的 WhatsApp Business 应用,因此对企业而言没有丢失。不过,您的系统在此期间没有收到任何内容,因为服务商的应用已从账户中卸载。自动化无法回复这些聊天,AI 代理也从未看到它们。
重新连接后,请在应用中阅读中断期间到达的聊天,并回复仍在等待的消息。如果您自己的系统需要这些消息,随新接入提供的历史同步是唯一能将其拉取过来的方式:最多可同步 6 个月的一对一聊天,前提是企业接受分享,并且在重新连接后 24 小时内保存了直接的 Webhook 目的地。开启了自动化的号码不会获得导入。
如何避免再次发生?
定期在主手机上打开 WhatsApp Business 应用,并保持手机在线,让它完成同步。Meta 以主设备为准来制定规则,而据我们的监控,通过 API 收发的消息不计作主设备的活动。Meta 公布的是约 14 天这一近似值,而非确切的小时数,因此每周一次的习惯能留出充足余量。
企业常用的做法包括:为手机的负责人设置定期日历提醒;把主手机放在前台而不是抽屉里;至少从手机上回复部分聊天,而不是只在 WhatsApp Web 上操作。能当天报告中断的监控,可以把一周的静默变成几分钟的停机。
与其他断开情况有何不同?
原因字段可以区分主手机长时间未用与号码真正失效,二者各有对应的修复方法。
PRIMARY_INACTIVITY:应用约 14 天未打开。请打开应用,然后重新连接同一号码。COMPANION_INACTIVITY:关联设备约 30 天未使用。请在手机上打开应用,然后重新连接。USER_RE_REGISTERED:号码已在新设备上注册。请从现在持有该号码的手机重新连接。CHANGE_NUMBER或BUSINESS_DOWNGRADE:号码已更换,或已切换回消费版应用。需要建立新的连接。- 限制属于执行决定,而非断开连接。重新连接不会解除限制。
设置方法
- Open the app on the primary phoneOpen WhatsApp Business on the phone that holds the number, with mobile data or Wi-Fi on, and wait until the chats finish syncing.
- Start the connect flow againOn the number's page in the dashboard, click "Reconnect this number", or start Embedded Signup from your provider, and log in with a Meta account that administers the business portfolio.
- Choose the same portfolio and numberPick the same business portfolio and WhatsApp Business Account. In our experience Meta recognizes the number and offers, pre-checked, to restore what it had before.
- Confirm on the phoneScan Meta's QR code from inside the WhatsApp Business app, confirm the connection and decide whether to share chat history.
- Check delivery end to endConfirm the webhook destination is set, send a test message from a customer phone, and check that your automation or system answered it.
常见错误
- 在手机仍离线或应用未打开时运行连接流程。请先打开应用并等待同步,否则重新连接可能在手机步骤失败。
- 以为 Webhook 目的地会随连接一同恢复。Meta 会随应用一起将其移除,因此在重新设置前,您的系统将保持静默。
- 将 PARTNER_REMOVED 且原因为 PRIMARY_INACTIVITY 误认为客户已离开。这是所有断开情况中最容易恢复的一种。
- 依赖 WhatsApp Web 的活动来保持号码存活。该规则监测的是主手机,而闲置的主手机也会使其关联设备登出。
重新连接后,已保存的消息目的地会自动恢复,自动化也会重新回复。每个号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
是确切的 14 天吗?
Meta 记录的是主设备约 14 天未活动,并不公布确切的小时数。至少每 10 天打开一次应用,或每周打开一次,即可避开临界点。
客户会察觉到断开吗?
不会直接察觉。他们的消息仍照常到达手机上的应用。他们会注意到的是,在号码重新连接之前,自动回复会停止。
我的代理商或开发者能替我重新连接吗?
他们可以用管理 Business Portfolio 的 Meta 账号完成浏览器部分的操作,但确认步骤需要在 WhatsApp Business 应用中完成,因此持有手机的人必须参与。
号码中断期间会被收费吗?
使用 easyCoexistence 时,号码在中断期间仍计入您的套餐,因为发现此类中断正是监控的用途;重新连接不会产生额外费用。如需停止计费,请移除该号码。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间