选择如何连接您的号码
根据号码当前的注册情况,从以下三种路径中选择一种。“新号码”是指 目前尚未在 WhatsApp 注册的号码,并不一定是指新购买的 SIM 卡。1. 注册新号码
确保您对该号码拥有控制权,并能接收其 SMS 或语音验证码。完成 YCloud 连接流程,选择目标业务资产组合和 WABA,然后注册号码。您无需先创建 WhatsApp Messenger 或 Business App 账户。 如果 WABA 已经连接到 YCloud,请使用添加号码。2. 从其他 BSP 迁移现有 API 号码
请使用服务商迁移路径,而不是注销应用程序账户。开始之前,请与当前服务商和 YCloud 确认所属业务资产组合、来源和目标 WABA、号码访问权限以及迁移先决条件。 规划消息收发、模板、Webhook 和依赖的自动化流程的切换。请不要假设前服务商的收件箱、联系人、营销活动数据或对话历史记录会被复制到 YCloud。在终止访问旧服务商之前,请导出您需要保留的记录。 号码迁移指南包含准备工作和 YCloud 操作步骤。“迁移 API 账户”是常见的简略说法;实际迁移的资产是号码,而不是您在服务商处的整个工作区。3. 将应用程序号码完全转至 Platform
此路径适用于您不再希望在 WhatsApp Messenger 或 WhatsApp Business App 中使用的号码。- 确认您希望停止在此号码上使用应用程序账户,且 YCloud 连接先决条件均已准备就绪。
- 在应用程序外部保存好您需要的记录。请勿依赖云端聊天备份来日后导入 Platform。
- 在主手机上打开相关的 WhatsApp 应用程序,前往 设置 → 账户 → 删除我的账户。确认准确的号码并按照提示完成注销。
- 等待号码被释放。Meta 的迁移指南指出这可能需要最多 3 分钟;如果注册仍然失败,请查看具体的错误信息,而不是反复删除或重新创建资产。
- 完成 YCloud 连接和号码验证流程。在引导客户使用新配置之前,测试入站消息以及允许的出站回复。
想要继续在同一号码上使用 WhatsApp Business App 吗?在注销应用程序账户之前,请查看单独的商业应用程序共存指南。共存是针对符合条件的 Business App 号码的一种备选连接模式,并非另一种账户类型或上述的服务商迁移路径。
号码要求与验证
您需要对号码拥有控制权,并能使用连接流程所需的验证方式。标准号码验证使用 SMS 或语音验证码。 如果该号码位于自动语音菜单或 IVR 系统之后,请确保人工可以接听验证电话。WhatsApp 无法自动操作您的电话菜单。请参阅 Meta 的商业电话号码要求。 请将这些检查项分开进行:
验证所有权并不等同于完成 Cloud API 注册。请遵循完整的 YCloud 关联流程,而不要在收到验证码后就停止操作。Meta 在注册商业电话号码中对这一区别进行了说明。
电话号码注册上限
号码注册上限控制一个业务资产组合最多可以注册多少个商业电话号码。它与控制主动触达客户规模的消息发送额度不同。 Meta 目前官方说明新资产组合的初始上限为 2 个已注册的商业电话号码。其文档中提升至 20 个上限的途径是完成企业认证或消息发送额度达到 2,000。在规划添加更多号码之前,请确认您的企业实际可用的上限。参见已注册号码上限。 请勿将更高的号码上限理解为每个号码都有独立的消息配额。显示名称
显示名称是与您的号码关联的商家名称。客户可以在商业资料中看到它。它在 WhatsApp 其他位置的可见性取决于 Meta 的展示规则。 选择一个客户能够与您的企业或品牌联系起来的名称。确保它与您网站及其他面向客户的材料上显示的身份保持一致。 例如,如果您的虚构品牌是 Example Store,使用该易于识别的品牌名称比使用与业务无关的名称更清晰。此示例属于文案建议,不保证一定会通过审核。 提交名称前:- 检查企业或品牌关联是否清晰明确。
- 检查拼写以及与您公开的商业身份是否一致。
- 查阅 Meta 的显示名称指南。
- 如果申请的名称被拒绝,请根据说明的原因进行更正,而不要重复提交相同的名称。
提交前评估显示名称
如果名称被拒绝,请查看具体原因。企业认证并不能替代或豁免显示名称规范。
在 API 响应中,
verifiedName 是号码的名称字段;它 并不 意味着该号码是官方商业账户 (Official Business Account)。请使用实际的 OBA 状态来进行确认。
商业资料
在 YCloud 中编辑资料
打开 WhatsApp 账户,选择该号码的 设置,然后打开 资料。更新相关信息并选择 保存。然后在 WhatsApp 客户端中查看面向客户的资料。修改内部备注并不等同于修改此资料。 当前 YCloud 资料 API 定义了以下限制:
个人资料字段格式有效并不意味着提议的显示名称修改已获批准。请将个人资料更新与名称审核结果分开对待。
当客户打开您的商家详情时,个人资料可以为他们提供更多背景信息。
有关可用字段和格式限制,请参阅管理 WhatsApp 电话号码。有关控制台操作步骤,请参阅电话号码个人资料设置。
Open Business Profile to review the number identity and customer-facing preview. Status and limits shown belong to this demo number.
内部昵称
YCloud 中的号码昵称可帮助您的团队识别号码。该昵称不会向客户展示,也不会更改 WhatsApp 显示名称。 例如,您的团队可以使用诸如 Support team 之类的内部昵称,而面向客户的显示名称仍为您的品牌名。请参阅电话号码昵称设置。商业用户名
商业用户名独立于显示名称和内部昵称。在支持的情况下,它会与电话号码关联。 YCloud 电话号码资源将处于激活状态的用户名与仍在审核中的已申请用户名进行了区分。待处理的申请不应被视为已激活的用户名。在面向客户的宣传材料中包含用户名之前,请检查其当前状态和可用性。电话号码状态
注册状态、显示名称审核、企业认证和质量评级描述的是同一号码的不同方面。请勿将其中一项作为其他项的证明。 如果消息发送失败,请检查失败详情和消息送达状态,而不要假定已获批准的显示名称就能保证送达。质量评级
客户反馈可能会影响号码的质量评级。请向期望收到消息的客户发送相关消息,并遵守退订请求。 质量和消息控制独立于号码注册上限。有关完整说明,请参阅质量与送达控制。消息限制
消息限制适用于商业资产组合级别,并在其商业电话号码之间共享。它们并不代表您可以注册多少个号码,也不代表 API 每秒可以处理多少条消息。 在规划主动发送消息时,请检查所属资产组合的当前配额。有关层级、扩容以及发送速度差异的信息,请参阅消息限制与吞吐量。后续步骤
- 添加其他号码。
- 编辑您的商业个人资料。
- 了解商业应用共存。
- 迁移号码。
常见问题
我卸载了 WhatsApp,但号码仍然处于注册状态。为什么?
我卸载了 WhatsApp,但号码仍然处于注册状态。为什么?
卸载只是从手机中删除了该应用程序,并没有注销 WhatsApp 账户。请先确认该号码是属于应用程序账户还是现有的 Platform 连接。对于从应用程序迁移到 Platform 的情况,请使用上述明确的账户注销流程。对于现有的 API 号码,请使用服务商迁移。请勿通过删除 WABA 来修复应用程序注册错误。
连接号码后,我之前的聊天记录会出现在 YCloud 中吗?
连接号码后,我之前的聊天记录会出现在 YCloud 中吗?
不会自动出现。标准的应用程序账户注销不会将应用历史记录转移到收件箱,BSP 迁移也不会复制旧服务商的会话数据库。在更改或终止访问权限之前,请保留所有必需的记录。单独的共存方案有其自有的同步规则;请勿将这些规则套用于完整的应用程序至 Platform 迁移。
验证码一直收不到。我应该检查什么?
验证码一直收不到。我应该检查什么?
请确认完整的国际格式号码,并确保您可以接收所选的短信或语音通话。对于固定电话或 IVR,请安排接收验证电话的权限。如果连接界面提供了其他方式,请尝试使用,并遵守重试倒计时限制。如果仍然失败,请向支持团队提供号码、所选方式、尝试时间和具体错误信息,请勿发送验证码或注册 PIN 码。
我的显示名称已获批准。为什么发送仍然失败?
我的显示名称已获批准。为什么发送仍然失败?
名称审核仅涵盖所申请的商业名称,并不代表满足了所有发送要求。请检查注册是否已完成,然后检查消息错误,查看是否存在模板、时间窗口、计费、收件人或账户方面的限制。YCloud 内部昵称对面向客户的名称审核或送达也没有任何影响。

