WhatsApp Business App 共存
概述
WhatsApp Business App 共存（Coexistence）支持将正在使用的 App 号码接入 EngageLab。同一个号码既可以继续在手机 App 上与客户沟通，也可以通过平台或 API 收发消息，无需停用原有 App 账户。
共存适合已经使用 WhatsApp Business App 服务客户，希望保留原号码和手机沟通方式，同时增加平台群发、会话管理或 API 集成能力的团队。如果不需要保留手机 App，可选择 API 模式接入。
- 保留原号码和 App：继续使用现有 Business App 账号，与客户保持联系。
- 手机与平台配合使用：受支持的一对一消息可在 App 和平台之间同步。
- 按需共享历史记录：接入时可选择共享聊天记录，再在规定窗口内发起历史同步。
关于 Meta 共存能力及限制，可查阅 Meta 官方文档。
接入前准备
| 准备事项 | 要求与说明 |
|---|---|
| 正在使用的 Business App 号码 | 号码已在 WhatsApp Business App 中正常使用；普通 WhatsApp Messenger 账号与纯 API 号码不能直接按此流程接入。资格及地区支持以 Meta 注册页面为准。 |
| 主手机与 App | 保留注册该号码的主手机，使用 2.24.17 或更高版本的 WhatsApp Business App，建议更新到最新版本。接入及同步时保持 App 打开、网络正常。 |
| Facebook 账户与业务资产权限 | 使用有权管理本次业务资产的 Facebook 账户登录并授权，提前确认业务资产组合、WhatsApp 商业账户及其管理权限。 |
| 业务资料 | 准备账户名称、时区等信息，并在注册页面核对。 |
| 历史共享选择 | 确认是否需要导入接入前的聊天记录；不共享不影响接入后的共存消息收发。 |
接入前请阅读下文的功能变化和设备限制。原关联副设备会在接入时解绑；如 App 已配置问候语、离开消息等自动回复，也应提前明确与平台自动化的分工。
接入流程
1. 在平台发起接入
登录 EngageLab 并进入 WhatsApp 服务，在注册方式中选择【App 模式】。
2. 输入号码并确认账户信息
输入你在 WhatsApp Business App 中正在使用的电话号码。
核对页面显示的账户名称、电话号码等信息。若信息有误，请修改电话号码。
确认本次接入使用的业务资产组合。
请填写已在 WhatsApp Business App 中正常使用的号码；号码是否具备共存资格，以 Meta 页面提示为准。
3. 在 WhatsApp Business App 中完成连接
页面显示二维码后，使用手机上的 WhatsApp Business App 扫码连接。
请扫描你实际接入页面中显示的二维码。
在 WhatsApp Business App 中，通过 Facebook 官方商业账户的消息连接到商业平台，并选择是否向平台共享聊天记录：
- 共享：平台可同步你最近 180 天的历史消息。
- 不共享：平台不会获取你的历史聊天记录。
4. 确认账户并完成授权
回到注册页面，核对 WhatsApp 商业账户名称和时区。
核对将向 EngageLab 共享的业务资产及权限，并完成授权。
授权完成后，页面显示账户已连接到 EngageLab。
5. 发起历史同步并确认可用
接入完成后，平台会同步联系人。如果接入时同意共享聊天记录，请在 24 小时内进入【配置管理】→【发送号管理】，点击【历史同步】。
同步期间请保持 WhatsApp Business App 打开并联网，完成时间取决于历史消息量及网络情况。同步范围见下文【数据同步】。接入结束后，在【发送号管理】检查共存状态，并分别测试客户来信、App 回复和平台/API 回复，确认收发及同步正常后再开展业务。
接入后的使用与限制
功能变化
下表区分接入后手机 App 的变化与 Cloud API 的支持范围；App 中仍可使用的功能，不代表平台或 API 也支持。
| WhatsApp Business App 原有功能 | 接入 Cloud API 后 App 上的变化 | 该功能是否在 Cloud API 上受支持 |
|---|---|---|
| 一对一（1:1）聊天 | 现在支持消息编辑/撤回 | 支持。最近 6 个月的所有聊天消息可同步；收发消息在 Cloud API 与 App 之间镜像同步 |
| 联系人 | 无变化 | 支持。所有有 WhatsApp 号码的联系人可同步 |
| 群聊 | 无变化 | 不支持，群聊不会被同步 |
| 阅后即焚消息 | 所有 1:1 聊天将关闭该功能 | 不支持 |
| 一次性查看消息 | 所有 1:1 聊天将禁用该功能 | 不支持 |
| 实时位置消息 | 所有 1:1 聊天将禁用该功能 | 不支持 |
| 广播列表 | 将被禁用，无法新建；已有广播列表变为只读 | 不支持 |
| 语音/视频通话 | 无变化 | 不支持 |
| 商业工具（如目录、订单、状态） | 无变化 | 不支持 |
| 消息工具（如营销消息、问候语、离开消息、快捷回复、标签） | 无变化 | 不支持 |
| 商业资料（如名称、地址、网站） | 无变化 | 不支持 |
| 频道 | 无变化 | 不支持 |
数据同步
共存的一对一消息同步与接入前的历史导入是两项不同能力：接入后的受支持消息可在 App 与平台间同步，历史记录则需要在接入时同意共享并发起【历史同步】。
| 数据 | 同步范围 |
|---|---|
| 联系人 | 有 WhatsApp 号码的联系人可同步到平台 |
| 历史一对一消息 | 接入前最近 180 天（约 6 个月）的记录 |
| 历史媒体资源 | 接入前 14 天内的图片、视频、文件等可下载资源；更早记录不保证保留可下载媒体 |
| 群聊 | 不同步，仍在手机 App 中使用 |
【历史同步】须在同意共享后的 24 小时窗口内发起，超过窗口无法通过刷新补回。未共享或超过窗口的历史记录无法通过该入口补同步。
消息发送与计费
- 发送速度：共存号码的 Cloud API 吞吐量固定为 20 条/秒（20 mps），不能按普通 API 号码升级吞吐量。
- 客服窗口：接入后收到用户新消息，才会为 API 打开 24 小时客服窗口；导入的历史聊天及商家从 App 发出的回复不会打开或延长窗口。API 窗口外需使用审核通过的模板。
- App 回复：Business App 的一对一回复不受 API 客服窗口限制。
- 计费：Business App 发送的消息仍免费；平台/API 发送按对应的 Cloud API 计费规则执行。
关联设备
主手机是注册该号码的手机；关联设备是通过主手机授权使用同一账号的副设备，添加副设备不属于更换主手机。接入共存时，原关联设备会被解绑，需要重新关联支持的设备。
| 设备类型 | 是否支持及说明 |
|---|---|
| Android 主手机上的 WhatsApp Business App | 支持。保留注册该号码的原主手机，App 保持最新版本，至少每 14 天打开一次。 |
| iPhone 主手机上的 WhatsApp Business App | 支持。保留注册该号码的原主手机，App 保持最新版本，至少每 14 天打开一次。 |
| WhatsApp Web（电脑浏览器） | 支持。通过主手机扫码关联，可收发一对一消息；Windows、Mac 电脑均可通过浏览器使用。 |
| WhatsApp Desktop for Mac（Mac 客户端） | 支持。通过主手机扫码关联，可收发一对一消息。 |
| WhatsApp Desktop for Windows（Windows 客户端） | 不支持。共存模式下该客户端的消息无法正常同步到平台，Windows 电脑请改用 WhatsApp Web。 |
| 配套手机（关联副手机） | 支持。通过“作为配套设备进行关联”使用同一账号，不要将号码重新注册为主账号。 |
| WhatsApp for Wear OS（智能手表客户端） | 不支持。不在共存模式支持的关联客户端范围内，消息可能无法同步。 |
最多支持 4 个关联副设备，不含主手机；每个独立关联的客户端或浏览器会话占一个名额，满额后可在主手机上退出旧设备再添加。电脑端显示二维码后，用主手机 Business App 的【已关联的设备】→【关联新设备】扫码即可；iPhone 从【设置】进入，Android 从右上角【⋮】进入。副手机选择【作为配套设备进行关联】。详见 WhatsApp 官方关联设备教程。
不支持设备上的消息可能无法同步到平台，或显示引导到主设备查看的占位提示。通用 WhatsApp 关联教程中的设备范围不等于共存兼容范围；手机浏览器暂不作为推荐使用方式。
自动回复与团队协作
检查 App 的问候语、离开消息，以及平台或所接客服系统的自动回复规则，明确由哪个端负责响应。同一条消息可能同时触发不同系统的回复，接入共存不会自动消除重复回复。正式使用前，请测试 App 人工回复、平台回复和自动化衔接。
保持连接与退出共存
保持连接
保留主手机上的 WhatsApp Business App，至少每 14 天打开一次。主手机不必始终在线，但仅使用电脑副设备不能替代主手机 App 的活跃使用。
更换主手机、重装 App、重新注册号码、更换号码、转到普通 WhatsApp Messenger，或主动解除业务平台连接，都可能导致共存连接中断。请继续使用原主手机，并在操作前确认对平台消息收发的影响。
退出共存（Offboard）
Offboard 是解除 WhatsApp Business App 与商业平台的共存连接。操作在主手机 App 中按 Meta 流程完成，无需在 EngageLab 平台执行 offboard：
- 在主手机打开 WhatsApp Business App，进入【设置】→【账号】→【业务平台（Business Platform）】。
- 选择【断开连接（Disconnect Account）】，按 App 提示确认；入口名称以实际 App 版本为准。
断开后，原连接上的平台/API 消息收发与同步将停止，手机 App 可继续使用。EngageLab 检测到对应 WhatsApp 商业账户（WABA）失效后，会自动在平台隐藏该账户，无需另行在平台删除。
退出共存不同于注销 WhatsApp 账号或退出电脑等关联副设备。请在断开前停止依赖该号码的发送任务，并安排后续通过手机 App 处理客户消息。
常见问题
接入后还能继续使用原号码和 WhatsApp Business App 吗？
可以。同一个号码可继续在原主手机的 Business App 中收发消息，同时使用 EngageLab 平台/API。无需注销原 App 账号，但部分 App 功能会变化，具体见上文【功能变化】。
接入后，从 App 发消息也需要付费吗？
通过 WhatsApp Business App 发送的消息仍免费；平台/API 发送的消息按对应 Cloud API 规则计费。接入共存不会将 App 消息变成 API 发送，也不会让平台/API 消息自动免费。
原有聊天记录会丢失吗？能全部导入平台吗？
接入共存无需删除原 App 账号，可继续在 App 查看已有聊天记录。平台历史导入需在接入时同意共享，并在 24 小时窗口内发起【历史同步】；导入范围为最近 180 天的一对一消息及规定时间内的媒体资源，群聊不导入。具体见上文【数据同步】。
群聊、通话、广播列表等功能在平台也能使用吗？
App 仍支持的功能不一定能在平台/API 使用。群聊和手机 App 的语音/视频通话不会因接入共存而成为平台/API 能力；广播列表无法新建或发送，已有列表只读。各项功能的 App 变化和 API 支持范围见上文【功能变化】。
为什么提示号码不具备共存资格？
共存用于正在使用的 Business App 号码，普通 WhatsApp Messenger 或纯 API 号码不能直接按此流程接入。新注册、活跃度不足、存在账号限制或处于不支持地区的号码可能无法接入，最终以 Meta 注册页面判断为准。请核对 App 版本、号码注册类型、业务资产归属和错误提示，避免反复注销或重新注册号码。
完成 Meta 授权后，为什么平台还没有显示账号或号码？
授权完成后，还需确认账号和号码已出现在 EngageLab、共存状态正常，并完成实际收发测试。账号未出现、仍在等待确认或报错时，请保留号码、操作时间及错误信息联系技术支持；不要反复创建账号或将普通 API 注册作为替代流程。
为什么部分消息或历史记录没有显示在平台？
先确认是否已完成初始同步，再核对历史共享选择、24 小时发起窗口、历史时间范围及消息类型。群聊、不支持的设备消息或媒体资源可能不在同步范围内；部分首次来信也可能短暂延迟。请先在主手机核对原消息和连接状态，消息缺失不等于账号已断连。
已经有聊天记录，为什么平台回复仍要求使用模板？
历史导入不会打开 API 的 24 小时客服窗口，商家在 App 中回复也不会打开或延长该窗口。接入后收到用户新消息才会打开 API 客服窗口；窗口外，平台/API 需要使用审核通过的模板发送。App 与 API 的发送规则不同。
原来关联的设备为什么退出了？还能重新关联吗？
接入共存时，原关联副设备会自动解绑，可通过原主手机重新关联支持的设备。WhatsApp Web 和 Mac 客户端受支持，Windows 客户端和 Wear OS 不受支持；设备名额和关联方式见上文【关联设备】。副设备退出登录与共存连接中断是不同问题。
如何停止共存？为什么账号从平台列表消失了？
在主手机 Business App 中按 Meta 流程断开业务平台连接，无需在 EngageLab 操作 offboard。断开后，平台/API 收发和同步停止；EngageLab 检测到对应 WABA 失效后，会自动隐藏该账号，手机 App 可继续使用。操作示例见上文【退出共存（Offboard）】。如果没有主动断开却发现账号消失，请保留相关信息联系技术支持核查。
已经连接其他服务商的号码能直接接入 EngageLab 吗？
原合作伙伴授权、业务资产归属或信用额度可能影响接入，不能保证解除旧连接后就能立即接入 EngageLab。切换前请联系双方服务商核对账号情况，不要通过删除 WABA、转到个人版或反复注册号码尝试解决。
共存账号能保留 Meta Verified 认证吗？
Meta Verified 订阅认证与 Official Business Account（OBA）是不同类型，不能相互替代。认证保留及申请资格以 Meta 对该账号的实际结果为准；不要为重新开通认证而自行断开、删除或重新注册共存号码。
