WhatsApp Business App 共存
概述
WhatsApp Business App 共存功能支持将正在使用的 App 号码接入 EngageLab。同一个号码既可以继续在手机上与客户沟通，也可以通过平台或 API 发送消息，无需停用原有 App 账户。
如果你已经使用 WhatsApp Business App 服务客户，希望在保留日常使用习惯的同时增加批量发送能力，可以选择这种接入方式。关于共存功能的官方说明，可查阅 Meta 官方文档。
使用共存功能的好处
- 继续使用原号码：保留现有的 WhatsApp Business App 账户和号码，无需为了接入 API 停用 App。
- 手机和平台配合使用：日常沟通仍可在手机上完成，通过平台或 API 收发的消息可与 App 同步。
- 增加批量发送能力：需要向多个客户发送消息时，可以使用平台或 API，同时保留 App 中一对一沟通的方式。
定价
- 通过 WhatsApp Business App 发送的消息仍然免费；
- 通过平台/API 发送的消息按 Cloud API 定价收费。
接入流程
开始前请确认
请准备以下账户信息和设备：
| 准备事项 | 说明 |
|---|---|
| Facebook 账户 | 用于登录 Meta 注册页面并完成授权，请确认可以正常登录。 |
| 正在使用的 App 号码 | 该号码需要已在 WhatsApp Business App 中正常使用。 |
| 安装 App 的手机 | WhatsApp Business App 版本需为 2.24.17 或更高。接入时需要用手机扫码并确认连接，请保持 App 打开。 |
| 业务账户信息 | 提前确认本次接入使用的 Meta 业务账户、WhatsApp 商业账户名称和时区，便于在注册过程中核对。 |
| 聊天记录共享选择 | 接入时可以选择是否共享聊天记录，建议提前确认是否需要将历史消息同步到平台。 |
接入前，请先了解下文的功能变化与限制。
流程概览
1. 在平台发起接入
登录 EngageLab 并进入 WhatsApp 服务，在注册方式中选择【App 模式】。
2. 输入号码并确认账户信息
输入你在 WhatsApp Business App 中正在使用的电话号码。
核对页面显示的账户名称、电话号码等信息。若信息有误，请修改电话号码。
确认本次接入使用的业务资产组合。
若系统报错，请检查该号码是否已经在WhatsApp Business App中使用。
3. 在 WhatsApp Business App 中完成连接
页面显示二维码后，使用手机上的 WhatsApp Business App 扫码连接。
请扫描你实际接入页面中显示的二维码。
在 WhatsApp Business App 中，通过 Facebook 官方商业账户的消息连接到商业平台，并选择是否向平台共享聊天记录：
- 共享：平台可同步你最近 180 天的历史消息。
- 不共享：平台不会获取你的历史聊天记录。
4. 确认账户并完成授权
回到注册页面，核对 WhatsApp 商业账户名称和时区。
核对将向 EngageLab 共享的业务资产及权限，并完成授权。
授权完成后，页面显示账户已连接到 EngageLab。
5. 等待数据同步
接入完成后，平台会自动同步你的联系人与聊天记录。
- 同步可能需要几分钟，时长取决于你的消息量、网络速度等；
- 同步期间请保持 WhatsApp Business App 打开；
- 同步完成后，我们会通知你流程已结束。
6. 历史数据同步
如果您在接入时选择了共享聊天记录，您需24小时内在发送号管理点击历史同步。
注意：该时间窗口为 Meta 平台规定，超过24小时，平台将无法同步您的历史消息。
功能对照
下表说明接入 Cloud API 后，商家在 WhatsApp Business App 上各功能的变化情况：
| WhatsApp Business App 原有功能 | 接入 Cloud API 后 App 上的变化 | 该功能是否在 Cloud API 上受支持 |
|---|---|---|
| 一对一（1:1）聊天 | 现在支持消息编辑/撤回 | 支持。最近 6 个月的所有聊天消息可同步；收发消息在 Cloud API 与 App 之间镜像同步 |
| 联系人 | 无变化 | 支持。所有有 WhatsApp 号码的联系人可同步 |
| 群聊 | 无变化 | 不支持，群聊不会被同步 |
| 阅后即焚消息 | 所有 1:1 聊天将关闭该功能 | 不支持 |
| 一次性查看消息 | 所有 1:1 聊天将禁用该功能 | 不支持 |
| 实时位置消息 | 所有 1:1 聊天将禁用该功能 | 不支持 |
| 广播列表 | 将被禁用，无法新建；已有广播列表变为只读 | 不支持 |
| 语音/视频通话 | 无变化 | 不支持 |
| 商业工具（如目录、订单、状态） | 无变化 | 不支持 |
| 消息工具（如营销消息、问候语、离开消息、快捷回复、标签） | 无变化 | 不支持 |
| 商业资料（如名称、地址、网站） | 无变化 | 不支持 |
| 频道 | 无变化 | 不支持 |
限制
聊天记录同步
开通时如果你同意共享聊天记录，平台会同步你的历史消息，但有以下限制：
- 仅同步接入时间起最近 180 天（约 6 个月）内收发的消息；
- 群聊消息不会被同步；
- 媒体文件（图片/视频/文件等）的可下载资源仅覆盖接入前 14 天内发送的媒体；更早的媒体只保留文字记录；
- 同步期间请保持 WhatsApp Business App 打开，以便顺利完成同步；
- 你也可以选择不共享聊天记录，此时平台不会获得你的历史消息。
消息发送
发送数量
WhatsApp Business App 账号每秒可发送消息上限为 5 条（包括手机端 app 发送的消息以及通过平台绑定后发出的消息，一起计算）
发送速度（吞吐量）
为保持与 WhatsApp Business App 的兼容性，共存号码的发送速度固定为 20 条/秒（20 mps），无法升级。大规模群发会受此速度上限影响。
客服窗口
- 只有当 WhatsApp 用户在你开通共存之后给你发消息，才会打开 24 小时客服窗口，此时你可以用普通（非模板）消息回复；
- 如果用户是在你开通之前发的消息，由于当时未打开客服窗口，你只能用已审核通过的模板消息回复；
- 通过 WhatsApp Business App 发送的消息不受 24 小时客服窗口限制，可随时一对一回复。
关联设备
- 你最多可将 4 个 WhatsApp 关联客户端链接到 WhatsApp Business App 账号；
- WhatsApp for Windows 和 WhatsApp for WearOS 这两类关联客户端不受支持；
- 开通共存的那一刻，所有关联设备会被自动解绑，之后你可以重新链接受支持的设备；
- 如果对方用户使用不受支持的关联设备给你发消息，该消息不会同步到平台，你在平台界面上看不到；
- 你发出的消息若在不受支持的关联设备上查看，会显示占位提示文字，引导用户到主设备查看。
注意事项
历史同步24小时窗口
在App端同意共享聊天记录后，您需24小时内在发送号管理点击历史同步，超过时间窗口平台将无法同步您的历史消息。
避免意外断开连接
以下情形会触发账号与 Cloud API 断开：
| 断开原因 | 说明 |
|---|---|
| 主设备长期不活跃 | 主设备约 14 天无活动 |
| 关联设备长期不活跃 | 关联设备约 30 天无活动 |
| 用号码注册了消费者版 WhatsApp | 即用个人版 WhatsApp 重新注册了该号码 |
| 更换电话号码 | 你更改了绑定号码 |
| 在新设备上重新注册 | 在新设备重新注册了该号码 |
| 政策执行 / 主动删除账号 | 因违规被处置，或你主动删除了 WhatsApp 账号 |
为避免意外掉线，建议保持主设备与关联设备的正常活跃使用，且不要用个人版 WhatsApp 重新注册同一号码。
旧合作伙伴信用额度冲突
如果你过去曾与其他合作伙伴合作，且仍在共享之前的信用额度，切换到新平台时可能会报错。
首次消息可能短暂延迟
开通后，用户首次给你发消息（尤其是通过"点击到 WhatsApp"广告进来时），可能出现短暂的消息异常，通常几秒内自动恢复，属正常现象。
如有更多疑问，请联系技术支持。
