Sign inGet Started
立即开始
指南
API 参考
SDK
CLI
知识库
更新日志

WhatsApp 共存模式故障排查

共存模式的设置在 Meta 的窗口中进行。你输入号码后，由 Meta 决定该号码是否走 WhatsApp Business 应用流程，因此无需事先在 Bird 工作区中开启任何设置。连接你的 WhatsApp Business 应用号码介绍了一次成功设置的完整过程。

以下各节引用了 Meta 的提示信息及 # 后面的代码，请找到与 Meta 显示内容一致的那一节。对于同样影响未通过应用连接的号码的问题，例如 Meta 的安全检查或商业账号被锁定，请参阅 WhatsApp 号码故障排查。

如需查询本页未涵盖的代码，请参阅 WhatsApp 连接和共存模式错误。

如果 Meta 显示 "Bird B.V. can't onboard customers right now" 或 "Bird B.V. can't onboard customers at the moment"，请稍后重试。

Meta 显示 Text message 和 Phone call 选项

输入号码后，Meta 的电话步骤会列出 Text message 和 Phone call 两种验证选项。这看起来与标准号码设置相同，此时还不会出现二维码。

出现此界面属于正常情况。Meta 在切换到 WhatsApp Business 应用流程之前，会显示同样的电话步骤。

  1. 选择 Enter a new phone number，然后输入你在 WhatsApp Business 应用中使用的号码。如果 Meta 将你的号码列为不符合共享条件，请忽略该条目，直接输入号码。
  2. 保持验证选项不变，然后选择 Next。
  3. 继续完成商业资料和业务组合的步骤，之后会出现二维码。

如果后续界面要求你输入六位数验证码，说明 Meta 已改为启动标准注册流程。请关闭该窗口，并按照 Meta 要求输入六位数验证码 操作。

Meta 提示该账户类型不支持与合作伙伴共享

输入号码后，Meta 在电话步骤中显示以下内容（#2655115）："This account type doesn't support partner sharing. Contact support for options."

如果该号码使用 WhatsApp Business 应用，请检查你在 Bird 中选择的流程。Set up a number 会启动标准号码设置流程。要继续使用该应用，请选择 Keep using the Business app：

  1. 关闭 Meta 的窗口。
  2. 在 Bird 中依次选择 New number 和 Keep using the Business app，然后重新开始。

如果该号码不使用 WhatsApp Business 应用，或选择应用流程后仍出现此错误，请联系支持，并提供 Meta 的错误代码和 Bird 中显示的 Session ID。

Meta 无法加载配对信息

Meta 停止 WhatsApp Business 应用的连接，并显示错误 #4563004。

请重试。

Meta 报告缺少配对权限

Meta 报告缺少用于 Cloud API 伴随设备配对的 Graph API 权限（#4563039）。

之前尝试连接时遗留的 WhatsApp Business App 消息账户可能导致此错误。该账户中的号码显示为 Offline。Bird 的应用具备所需权限。

  1. 在 Meta Business Suite 中，打开将你的号码显示为 Offline 的 WhatsApp Business App 消息账户。此账户没有 Two-step verification 选项卡。
  2. 选择 Remove from business portfolio。如果该账户仍显示为已停用，请再次移除。
  3. 等待 5 分钟，然后将号码重新连接到 Bird。

Meta 提示该号码已注册到 WhatsApp 账户

你一输入号码，Meta 就会在电话字段下方显示以下内容（#2494064）："This phone number is already registered to a WhatsApp account. To use this number, disconnect it from the existing account. Then, return to this page and try again. It can take up to 3 minutes for the number to refresh."

此错误通常表示该号码注册在个人应用 WhatsApp 中，而不是 WhatsApp Business 应用中。共存功能连接的是 WhatsApp Business 应用账户，因此 Meta 会拒绝个人 WhatsApp 号码。

  1. 在手机上检查该号码注册在哪个应用中。
  2. 如果是 WhatsApp，请将账户迁移到 WhatsApp Business 应用。WhatsApp 的指南将 WhatsApp Messenger 账户迁移到 WhatsApp Business 介绍了如何备份并迁移聊天记录。
  3. 在 Bird 中依次选择 New number 和 Keep using the Business app，然后重新开始。

不要按照消息提示删除账户来断开号码。删除账户会清除其中的聊天记录，而共存要求号码继续保留在 WhatsApp Business 应用中。

如果号码已经在 WhatsApp Business 应用中运行，说明 Meta 没有把它识别为 Business 应用号码。当 Meta 显示 #2388091 或 #2655095，或者没有出现二维码步骤时，也按以下步骤处理：

  1. 将 WhatsApp Business 应用更新到最新版本。
  2. 在应用中关闭两步验证。
  3. 在 WhatsApp Manager 中打开 Phone numbers，删除该号码所有标记为待处理或已断开的条目。如果 Bird 将该号码显示为 Failed，也在 Bird 中断开它。
  4. 等待 5 分钟。
  5. 在 Bird 中选择 New number 并重新开始。对话框默认选中 Set up a number，因此请先切换到 Keep using the Business app。

路径正确时，Meta 会先显示 Verify your account details，然后显示二维码。如果 Meta 要求输入六位验证码，请按照 Meta 要求输入六位验证码 处理。

Meta 要求输入六位验证码

在电话步骤中选择 Next 后，后续页面要求你输入 Meta 通过短信或电话发送的六位验证码，且没有出现二维码。

电话步骤本身显示 Text message 和 Phone call 选项属于正常情况，你只需在该页面选择 Next。如果后续页面要求你输入验证码，说明 Meta 启动的是标准号码注册，而不是 WhatsApp Business 应用路径。请不要填写验证码，关闭 Meta 的窗口，然后逐项检查以下内容：

  1. 在 Bird 中，先选择 Keep using the Business app，再选择 Connect WhatsApp。
  2. 将 WhatsApp Business 应用更新到最新版本。Meta 要求版本为 2.24.17 或更高。
  3. 在应用中打开 Settings > Account > Business Platform。如果已连接某个企业平台，请断开连接并等待 15 分钟。
  4. 在 WhatsApp Manager 中打开 Phone numbers，查找该号码标记为已断开、待处理或未验证的条目。打开其 Two-step verification 选项卡并选择 Turn off two-step verification，这样该号码无需 PIN 即可重新注册。然后删除该条目。
  5. 在电脑上使用 Chrome 或 Safari，在 Bird 中重新开始。

Meta 无法发送验证码

Meta 在其手机号验证步骤中显示 "Request code failed: Our servers are temporarily unavailable..."（#2388091）。

此错误来自标准号码注册的验证码步骤，说明注册流程没有走 WhatsApp Business 应用路径。再次请求验证码并不能以共存方式连接该号码。请按照 Meta 要求输入六位验证码 中的检查项操作，然后重新开始。

扫描二维码后，Meta 要求您联系 Bird B.V.

您扫描二维码后，Meta 窗口提示联系合作伙伴 Bird B.V. 以解决手机号连接问题。该号码未出现在 Bird 中。

之前某次尝试留下的该号码条目仍在某个 WhatsApp Business Account 上，阻止了 WhatsApp Business 应用的连接。

  1. 在 WhatsApp Business 应用中打开 Settings > Account > Business Platform。如果已连接某个企业平台，请断开连接并等待 15 分钟。
  2. 在 WhatsApp Manager 中打开 Phone numbers，找到该号码标记为已断开、待处理或未验证的条目。
  3. 打开该条目的 Two-step verification 标签页，选择 Turn off two-step verification，使该号码无需 PIN 即可重新注册。然后删除该条目。
  4. 在 Bird 中选择 New number，再选择 Keep using the Business app，然后重新开始。

号码显示 Failed 并提示 Cannot Create Certificate

完成 Meta 的设置后，Bird 中的号码显示 Failed，并提示 "Cannot Create Certificate: This number is registered to an existing WhatsApp account."

Meta 将这次尝试作为标准号码注册处理，而标准注册无法接收正在 WhatsApp Business 应用中使用的号码。这次尝试还在 WhatsApp Manager 中留下了该号码的条目，会阻止下一次尝试。

  1. 在 Bird 中断开失败的号码。
  2. 在 WhatsApp Manager 中打开 Phone numbers，找到该号码标记为已断开、待处理或未验证的条目。
  3. 打开该条目的 Two-step verification 标签页，选择 Turn off two-step verification，使该号码无需 PIN 即可重新注册。然后删除该条目。
  4. 等待几分钟，然后在 Bird 中选择 New number，再选择 Keep using the Business app，重新开始。

Meta 报告资格错误

Meta 会在您输入号码时检查每个号码。Meta 不公布支持的国家/地区列表，Bird 也无法提前检查号码是否符合条件。Meta 的 Business 应用接入错误参考文档列出了其中大部分消息：

Meta 的消息处理方法
您的电话号码不符合连接 WhatsApp Business Platform 的条件。(#3441045)继续在 WhatsApp Business 应用中使用该号码，稍后再试。Meta 需要该号码在应用中有更多活动才能做出判断，且未公布最低要求。
此电话号码不符合注册或迁移条件。(#3441034)按照 Meta 提示号码不符合注册或迁移条件 操作。
您的电话号码未在 WhatsApp Business 中注册。(#2655095, #2655048)在 WhatsApp Business 应用中注册该号码，或输入已在该应用中注册的号码。
此功能不适用于该地区的电话号码。(#3441042)改用其他地区的号码。该地区的号码不支持共存。
请将您的 WhatsApp Business App 更新到最新版本。(#4563015)更新应用后重试。
请断开您的商业平台连接以继续。(#2655094)在应用中打开 Settings > Account > Business Platform，断开已连接的平台，然后等待 15 分钟。
该企业已在与合作伙伴共享此 WhatsApp Business 账号。(#2655093)如果您要连接到 Bird，请在应用的 Settings > Account > Business Platform 下断开当前合作伙伴，等待 15 分钟后重新开始。如果您离开 Bird 后其他服务商显示此消息，请按照将号码迁移到其他服务商操作。
此电话号码已在该产品中注册。(#3441049)在应用的 Settings > Account > Business Platform 下断开已连接的平台，然后等待 15 分钟。
此电话号码已关联到某个 Facebook 公共主页。(#2655082)在 Meta Business Suite 的 Settings > Accounts > Pages 下，将该公共主页从商务资产组合中移除，或输入其他号码。移除前，请先检查该资产组合中还有哪些内容在使用此公共主页。
您的电话号码已关联到自动事件。(#3441061)请按照 Meta 报告 Business AI 智能体或自动事件操作。

Meta 提示号码不符合注册或迁移条件

Meta 显示 "This phone number is not eligible to register or migrate."（#3441034）。Meta 的窗口还可能将您的 WhatsApp Business 应用账号标记为 Ineligible。

出现 Ineligible 条目属于正常情况，您无需删除 WhatsApp Business 应用。

  1. 不要选择 Ineligible 条目，而是输入电话号码。
  2. 在 WhatsApp Business 应用中，打开 Facebook 和 Instagram 设置并解除两者的关联。根据应用版本不同，它们位于 Settings 或 Business tools 下。
  3. 在你的 Facebook 主页上，打开 Settings > Linked accounts，确认 WhatsApp 显示为 Not connected。
  4. 使用对拥有该号码的业务资产组合具有完全控制权的 Facebook 账号登录 Meta。
  5. 在 Meta Business Suite 中打开 Settings > Accounts > Messaging accounts。如果列出了该号码的 WhatsApp 账户，请先确认没有其他内容在使用它，然后选择 ⋯ > Remove from business portfolio。如果该账户仍显示为已停用，请再次移除。移除该账户不会影响该号码在 WhatsApp Business 应用中的使用。
  6. 在 Bird 中，选择 New number，然后选择 Keep using the Business app，输入号码并扫描二维码。

Meta 提示该号码已被其他账号使用

你想继续在 WhatsApp Business 应用中使用该号码，但 Meta 提示它已被其他账号使用。

该号码仍与 Facebook 或 Instagram 关联。请在 WhatsApp Business 应用的 Facebook 和 Instagram 设置中，以及 Facebook 主页的 Settings > Linked accounts 下解除关联，使 WhatsApp 显示为 Not connected。然后在 Bird 中选择 Keep using the Business app 重新开始。

Meta 报告正在注销号码

Meta 拒绝该号码并显示 #3441055。该号码仍在从之前的连接中移除，移除完成后 Meta 会再次接受它。请等待，然后在 Bird 中重新开始。

Meta 报告 Business AI 智能体或自动化事件

Meta 拒绝该号码并显示 #3441060 或 #3441061。该号码在 WhatsApp Business 应用中仍与 Business AI 智能体或自动化事件关联。

  1. 在应用中取消关联 Business AI agent。
  2. 在 Business tools > Lists 下关闭 Meta 消息中提到的自动列表。
  3. 在 Bird 中选择 New number，然后选择 Keep using the Business app，重新开始。

Meta 提示缺少 CoEx gate evaluation

Meta 中止设置，并提示缺少 CoEx gate evaluation。这是 Meta 对您 Facebook 账户的安全检查，目前尚未完成。请按照 Meta 要求您确认身份 完成提示，然后使用拥有该号码的业务组合重新开始。

Meta 提示您无权查看此资产

Meta 显示 "You don't have the necessary permissions to view this asset. Contact the asset owner to get permission or complete this action with the owner's account."（#3441038），通常在您输入号码后立即出现。

您登录所用的 Facebook 账户无法打开 Meta 关联到该号码的业务组合。

  1. 使用对您的 WhatsApp Business app 账户所属业务组合拥有完全控制权的 Facebook 账户登录 Meta。
  2. 在 WhatsApp Business app 中打开 Facebook 和 Instagram 设置。根据应用版本不同，它们位于 Settings 或 Business tools 下。如果未关联任何 Facebook 主页，请关联您企业的主页，然后重新开始。
  3. 如果该号码所属的业务组合团队中无人能访问，请通过 Meta 恢复访问权限。Bird 无法查看或释放该业务组合。

号码已在 WhatsApp Business app 中连接，但未出现在 Bird 中

Meta 的最后一个界面显示您的账号已连接到 Bird B.V.，应用的 Business Platform 下也列出了 Bird B.V.，但 Bird 的 Numbers 中没有显示该号码。Bird 还可能显示 "Meta did not complete the app connection. Start the flow again."

Meta 的窗口将结果返回给打开它的 Bird 页面时，Bird 才会添加该号码。如果使用手机或应用内浏览器、弹出窗口被拦截、Bird 页面被刷新，或在点击 Meta 的最后一个按钮前关闭了窗口，结果都可能无法传回 Bird。

  1. 使用装有 Chrome 或 Safari 的电脑，并允许 bird.com 显示弹出窗口。
  2. 在 Bird 中，依次选择 New number 和 Keep using the Business app，然后选择 Connect WhatsApp。
  3. 保持 Bird 页面打开，Meta 的窗口打开期间不要刷新该页面。
  4. 在 Meta 的最后一个界面上，选择 Continue to feature setup。如果直接关闭窗口，Bird 可能收不到结果。

每次尝试都会断开应用的已关联设备，因此号码显示 Connected 后，请重新连接这些设备。

号码因币种不匹配而失败

号码显示 Failed，并附有 credit_currency_mismatch 和类似 "This WhatsApp Business Account already bills in BRL, and the credit line we attach bills in USD, EUR, or GBP." 的消息

Bird 使用以 USD、EUR 或组织账单币种计价的信用额度，向 Meta 支付通过 Bird 发送消息的费用，本例中的组织账单币种为 GBP。Meta 允许每个 WhatsApp Business Account 使用一种币种。共存连接的是 WhatsApp Business 应用已经使用的账号，因此在设置过程中选择新账号无法避免币种不匹配。

请先尝试更改现有账号的币种：

  1. 在 Bird 中断开失败的号码，并在 WhatsApp Business app 的 Settings > Account > Business Platform 下断开 Bird B.V.。
  2. 在 Meta Business Suite 中，打开该 WhatsApp Business Account 的业务设置，并移除其付款方式。
  3. 将账号币种设置为 Bird 消息中列出的币种之一。
  4. 在 Bird 中，选择 New number，然后选择 Keep using the Business app，重新开始。

如果 Meta 不允许更改币种，只要该账号仍以 Bird 消息中未列出的币种计费，该号码就无法通过共存连接到 Bird。请联系支持讨论可用方案。

更改商业资料时返回 E15088

通过 CLI 或 MCP 工具更新共存号码的商业资料时，会返回 412 及 E15088："This number's business profile is managed in the WhatsApp Business app and cannot be updated through the API." 在控制台中，该号码的 Business profile 会显示其详细信息，但编辑功能已关闭，并附有提示 "Manage this profile in the WhatsApp Business app"。读取资料不受影响。

对于 WhatsApp Business app 号码，Meta 不支持通过 API 更改商业资料，因此重试会返回相同的错误。请在 WhatsApp Business app 的 Business tools > Business profile 中编辑名称、描述、地址、网站或头像。

导入的聊天记录不在消息列表中

你在设置过程中共享了聊天记录，Conversations 中也显示了较早的聊天。但列出 WhatsApp 消息只返回号码连接当天及之后的消息，按更早的日期筛选则没有结果。

WhatsApp 消息列表从号码连接时开始记录，因此不包含导入的历史记录。请改为从会话中读取导入的历史记录：

WhatsApp 消息保留 30 天，因此导入只会带入最近 30 天内共享的消息，更早的消息仍留在 WhatsApp Business app 中。选择 Coexistence 卡片上的联系人数量，即可打开存放导入联系人的受众。

连接后，客户发来的部分首条消息可能显示为不可用，并带有错误 131060。对于 WhatsApp Business app 号码，这是 Meta 预期的行为。请参阅不支持的消息。

号码显示 Disconnected

原本显示 Connected 的共存号码现在显示 Disconnected。

当有人断开 Bird 与该号码的连接时，Meta 会通知 Bird，例如在 WhatsApp Business app 的 Settings > Account > Business Platform 下选择 Disconnect Account。

  1. 在 Bird 中对该号码选择 Reconnect。
  2. 在手机上打开 WhatsApp Business app，并完成 Meta 的步骤。
  3. 向该号码发送一条消息，确认它能到达 Bird。

如需自行断开共存号码与 Bird 的连接，请在 WhatsApp Business app 的 Settings > Account > Business Platform 下选择 Disconnect Account。该号码在应用中仍可继续使用。在 Bird 中，它会显示 Disconnected，并停止收发消息。如果只在 Bird 中选择 Disconnect number，应用中的 Bird B.V. 仍保持连接。之后如需将该号码用于其他服务商，请按照将号码迁移到其他服务商操作。

无法通过 Bird 使用群组

使用共存号码时，你无法从 Bird 创建 WhatsApp 群组或向其发送消息，WhatsApp Business app 中已有的群组也不会显示在 Bird 中。

如共存限制所述，群聊仅保留在应用中，并且 Meta 不通过 API 向 WhatsApp Business app 号码提供群组功能。要使用来自 Bird 的群组，需要一个通过标准设置连接且具有Official Business Account 状态的号码。

号码已在未使用共存模式的情况下连接

您通过 Set up a number 连接了该号码，现在希望团队从 WhatsApp Business 应用回复消息。

通过标准设置连接的号码无法直接切换为共存模式。请重新连接：

  1. 在 Bird 中断开该号码。在新连接完成之前，该号码无法通过 Bird 发送消息。
  2. 在手机上的 WhatsApp Business 应用中注册该号码。如果是座机号码，请选择电话验证。
  3. 在 Bird 中，选择 New number，然后选择 Keep using the Business app，并按照共存设置操作。

该号码会在 Bird 中获得新的 ID。如果 Meta 将其连接到另一个 WhatsApp Business Account 下，请在该账户中重新提交您的模板。

后续步骤

相关资源

继续查看此主题的文档、指南和示例。

动手实践并获取实施简报