WhatsApp Business App 共存
概述
WhatsApp Coexistence 功能支持将已经在WhatsApp Business App中使用的号码接入API，允许同一号码在API和App上同时运行。EngageLab WhatsApp 基于 Meta 该功能接入，底层能力与 Meta 官方文档 一致。
接入成功后，商家可以：
- 使用我们平台通过 Cloud API 规模化地向其客户发送消息；
- 同时保留使用 WhatsApp Business App 进行一对一消息收发的能力；
- 两端（App + Cloud API）的消息历史保持同步。
定价
- 通过 WhatsApp Business App 发送的消息仍然免费；
- 通过平台/API 发送的消息按 Cloud API 定价收费。
接入流程
开始前请确认
- 你的 WhatsApp Business App 版本为 2.24.17 或更高；
- 待接入的电话号码当前正在你的 WhatsApp Business App 中正常使用；
- 接入过程中请保持 WhatsApp Business App 处于打开状态，以便完成后续数据同步；
- 提前了解开通后 App 的功能变化与限制。
流程概览
1. 在平台发起接入
登录我们平台，开始接入流程，选择 WhatsApp Business App Coexistence。
2. 输入号码，使用 App 扫描二维码
输入你 WhatsApp Business App 正在使用的电话号码。系统验证成功后,使用 WhatsApp App 扫描二维码。
若系统报错，请检查该号码是否已经在WhatsApp Business App中使用。
3. 在 WhatsApp Business App 中完成连接
打开你手机上的 WhatsApp Business App，按以下顺序操作：
- 你会收到一条来自官方 Facebook Business Account 的消息，点击 Connect（连接）；
- 点击 Connect to the Business Platform（连接到 Business Platform） 按钮，继续接入；
- 点击 Confirm（确认），此时可以选择是否将聊天记录共享给平台：
- 共享：平台可同步你最近 180 天的历史消息；
- 不共享：平台不会获取你的历史聊天记录；
4. 完成平台侧剩余流程
回到平台，完成接入流程的剩余步骤。
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 聊天将关闭该功能 | 不支持 |
| 一次性查看消息（View once） | 所有 1:1 聊天将禁用该功能 | 不支持 |
| 实时位置消息 | 所有 1:1 聊天将禁用该功能 | 不支持 |
| 广播列表（Broadcast lists） | 将被禁用，无法新建；已有广播列表变为只读 | 不支持 |
| 语音/视频通话 | 无变化 | 不支持 |
| 商业工具（如目录、订单、状态） | 无变化 | 不支持 |
| 消息工具（如营销消息、问候语、离开消息、快捷回复、标签） | 无变化 | 不支持 |
| 商业资料（如名称、地址、网站） | 无变化 | 不支持 |
| 频道（Channels） | 无变化 | 不支持 |
限制
聊天记录同步
开通时如果你同意共享聊天记录，平台会同步你的历史消息，但有以下限制：
- 仅同步接入时间起最近 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 "companion"（关联）客户端链接到 WhatsApp Business App 账号；
- WhatsApp for Windows 和 WhatsApp for WearOS 这两类关联客户端不受支持；
- 开通共存的那一刻，所有关联设备会被自动解绑，之后你可以重新链接受支持的设备；
- 如果对方用户使用不受支持的关联设备给你发消息，该消息不会同步到平台，你在平台界面上看不到；
- 你发出的消息若在不受支持的关联设备上查看，会显示占位提示文字，引导用户到主设备查看。
注意事项
历史同步24小时窗口
在App端同意共享聊天记录后，您需24小时内在发送号管理点击历史同步，超过时间窗口平台将无法同步您的历史消息。
避免意外断开连接
以下情形会触发账号与 Cloud API 断开：
| 断开原因 | 说明 |
|---|---|
| 主设备长期不活跃 | 主设备约 14 天无活动 |
| 关联设备长期不活跃 | 关联设备约 30 天无活动 |
| 用号码注册了消费者版 WhatsApp | 即用个人版 WhatsApp 重新注册了该号码 |
| 更换电话号码 | 你更改了绑定号码 |
| 在新设备上重新注册 | 在新设备重新注册了该号码 |
| 政策执行 / 主动删除账号 | 因违规被处置，或你主动删除了 WhatsApp 账号 |
为避免意外掉线，建议保持主设备与关联设备的正常活跃使用，且不要用个人版 WhatsApp 重新注册同一号码。
旧合作伙伴信用额度冲突
如果你过去曾与其他合作伙伴合作，且仍在共享之前的信用额度（credit line），切换到新平台时可能会报错。
首次消息可能短暂延迟
开通后，用户首次给你发消息（尤其是通过"点击到 WhatsApp"广告进来时），可能出现短暂的消息异常，通常几秒内自动恢复，属正常现象。
如有更多疑问，请联系技术支持。
