> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Business App 共存

> 确定是否在继续使用 WhatsApp Business App 的同时，将其现有号码连接到 API。

共存模式允许您在继续使用 WhatsApp Business App 的同时，将符合条件的 App 号码连接到 WhatsApp Business 开放平台。

您可以保留同一个面向客户的号码，并添加基于 API 的工作流。

## 共存适用的场景

当您的团队已经在日常使用 WhatsApp Business App，并希望在不立即将所有业务全部迁出 App 的情况下添加 YCloud Inbox、自动化或 API 集成时，可以考虑使用共存模式。

## 关于同步的预期

支持的一对一消息可以在 App 与平台之间同步镜像。历史记录共享是一个独立的接入选项；它并不保证每条历史消息、媒体文件或 App 功能都会出现在 YCloud 中。

Meta 的共存文档区分了一对一聊天与仅在 App 端提供的功能。现有的 App 群聊不会同步为 API 群组会话。App 内通话与 [WhatsApp Calling](/zh/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-calling) 也不是同一种集成。

在依赖群发、关联设备、阅后即焚消息或其他 App 功能之前，请查看 Meta 的[最新功能对比](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/)。

<Frame caption="History sharing is an explicit onboarding choice. This Meta example illustrates the choice, not a completed YCloud synchronization.">
  <div style={{ position: "relative", width: "100%", maxWidth: "340px", margin: "0 auto" }}>
    <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-coexistence-history-choice.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=2bb198a4799294d08df4e9baeed0282a" alt="Meta Business App 对话框提供“共享聊天”、“不共享聊天”和“取消”。" style={{ width: "100%", height: "auto", margin: 0 }} width="622" height="1296" data-path="product-assets/whatsapp-platform-2026-09-22/meta-coexistence-history-choice.png" />
  </div>
</Frame>

来源：[Meta 官方示例](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users)。

## API 消息规则依然适用

使用 App 并不会免除 API 的模板、许可同意、定价或服务时间窗口要求。

从 App 发送的商业消息不会开启或延长 API 客户服务窗口。接入期间导入的历史聊天记录也不会创建 API 窗口。在 API 接入完成后收到的客户消息会正常开启服务窗口。

有关完整的窗口规则，请参阅[服务消息](/zh/documentation/whatsapp-business-platform/messaging/service-messages)；有关 API 消息收费，请参阅 [WhatsApp 定价](/zh/documentation/whatsapp-business-platform/pricing-limits-and-quality/whatsapp-pricing)。

不要假设共存号码具有与标准 Cloud API 号码相同的吞吐量或功能。在安排大规模营销活动之前，请确认其当前的限制。

## 团队准备工作

在连接之前：

* 确认该号码使用的是 **WhatsApp Business App**，而非个人版 WhatsApp App。
* 保留对主手机以及用于接入的 Meta 业务资产的访问权限。
* 了解历史记录共享选项及其对已关联设备的影响。
* 明确分工，确定谁在 App 中回复，谁在 YCloud 中回复。
* 检查人工接管时自动化流程将如何暂停。
* 测试客户消息、App 回复、API 回复以及送达报告。

这种交接方案有助于防止团队成员与自动化工作流同时响应同一客户而导致的重复回复。

## 通过 YCloud 连接

请按照[连接 WhatsApp Business App 号码](/zh/documentation/channels/whatsapp-accounts-management/coexistence/onboard-whatsapp-business-app)中的 YCloud 接入流程进行操作。

请根据 App 和接入流程中显示的最新提示进行操作。不要将删除现有 App 账户作为共存接入的常规步骤。如果流程中未提供预期的连接选项，请暂停操作并在更改号码注册状态前联系支持团队确认资质。

### 连接流程概览

1. 在 YCloud 中，选择 **创建渠道** 并选择 **WhatsApp Business APP 共存**。
2. 选择 **WhatsApp Business App 号码** 路径并输入现有的 App 号码。
3. 使用主手机上的 Business App 完成二维码连接提示操作。
4. 决定是否共享可用的聊天历史记录。此步骤与授权未来的 API 消息发送相互独立。
5. 完成 Meta 业务授权提示，检查业务详情，然后完成配置。
6. 等待 YCloud 返回账户列表。如果授权了历史记录同步，请保持 Business App 处于打开状态并等待同步完成。

YCloud 当前指南指出，初始同步完成后，新消息才会出现在 Inbox 中。此外，早于 **14 天** 的媒体文件不会被同步。请勿承诺完整的历史媒体存档。

### 了解业务权衡

| 领域 | 规划建议 |
| - | - |
| 吞吐量 | YCloud 目前针对共存号码记录的固定吞吐量为 **每秒 5 条消息** 。即使拥有更高的消息限制层级，也无法解除此吞吐量限制。 |
| 一对一历史记录 | 在将 Inbox 用作历史记录依据之前，请先核对实际同步的内容。 |
| App 群组 | 现有的 App 群组不会转为 YCloud API 或 Inbox 群组会话。 |
| 回复管理 | 明确下一次响应由哪个客服人员或自动化流程负责，避免 App 和 Inbox 用户同时回复。 |
| 成本 | 从 App 发起的消息与从 API 发起的消息适用不同规则；通过 API 发送仍需遵循适用的平台定价。 |
| 适用资格 | 更新应用程序并检查实际的接入结果。不要假定每个现有的应用程序号码都可以连接。 |

### 移交给团队前进行验收测试

让测试客户向已连接的号码发送消息。确认同步后入站消息在预期工具中正常显示。分别从应用程序和通过 YCloud 回复一次，检查镜像同步的内容以及在人工回复期间自动化流程是否保持静默。

然后测试已获批的模板、媒体消息以及服务窗口已过期的会话。在启动营销活动之前，保持较小的测试规模并记录任何不受支持的行为。

[YCloud 共存指南](/zh/documentation/channels/whatsapp-accounts-management/coexistence/onboard-whatsapp-business-app)是控制台操作顺序和 YCloud 同步行为的参考来源。

## 断开连接之前

审查哪些工作流依赖于 API 连接、团队后续将如何处理消息，以及需要保留哪些记录。断开连接属于运维变更；不应将其作为常规的排错重试手段。

## 常见问题

<AccordionGroup>
  <Accordion title="接入后可以看到最近的应用程序聊天记录。为什么 API 仍可能需要模板？">
    可见的历史记录不能证明 API 服务窗口处于开启状态。Meta 规定，在商家接入 Cloud API 之前发送的消息不会开启该窗口。请检查接入后是否有符合条件的新客户消息；否则请使用合适的已获批模板。源自应用程序的回复也不会延长 API 窗口。
  </Accordion>

  <Accordion title="我现有的应用程序群组以及所有已关联设备的消息都会出现在收件箱（Inbox）中吗？">
    请不要抱有这种预期。应用程序群组不会作为 API 或收件箱群组导入，支持的同步取决于消息、客户端和连接。请测试团队使用的具体设备并审查不受支持的消息行为。部分历史记录视图并不代表所有应用程序数据都已迁移。
  </Accordion>

  <Accordion title="如果接入失败，我应该删除 Business 应用程序账户吗？">
    不应将其作为共存排错步骤。删除操作违背了保留应用程序账户的目的，并可能销毁历史记录。请先检查支持的应用程序版本、资格、所有权以及实际的接入错误；在更改账户之前，请联系支持团队并提供已脱敏的上下文信息。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.