选择如何连接您的号码
根据号码当前的注册情况,从以下三种路径中选择一种。“新号码”是指 目前尚未在 WhatsApp 注册的号码,并不一定是指新购买的 SIM 卡。1. 注册新号码
确保您能控制该号码,并能接收其 SMS 或语音验证码。完成 YCloud 连接流程,选择目标业务组合和 WhatsApp 账户(WAAC),然后注册该号码。您无需先创建 WhatsApp Messenger 或 Business 应用账户。 要将另一个号码连接到 YCloud,请使用 添加号码。2. 从其他 BSP 迁移现有 API 号码
请使用提供商迁移流程,而不是删除应用账户。在更新后的账户模型下,该号码归属于一个 WhatsApp 账户(WAAC)。YCloud 使用独立的 Messaging Account 进行集成,并获得对该号码的授权访问权限。 规划消息发送、模板、Webhook 及依赖这些功能的自动化的切换。不要假定上一个服务商的收件箱、联系人、营销活动数据或对话历史会被复制到 YCloud。在终止对旧服务商的访问之前,请导出你需要保留的记录。 号码迁移指南 包含准备步骤和 YCloud 步骤。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 账户。请先确认该号码属于应用账户还是现有的平台连接。
- 应用账户: 打开 WhatsApp Messenger 或 WhatsApp Business 应用,然后前往 设置 → 账户 → 删除我的账户。按提示删除账户,然后再卸载应用。
- 现有平台连接: 在 Meta 中,从该电话号码当前关联的消息账户中移除该电话号码。
连接该号码后,我之前的聊天记录会显示在 YCloud 中吗?
连接该号码后,我之前的聊天记录会显示在 YCloud 中吗?
不会自动进行。标准的应用账号删除不会将应用历史记录转移到收件箱,BSP 迁移也不会复制旧服务商的会话数据库。在更改或终止访问权限之前,请保留所有必需的记录。单独的共存方案有自己的同步规则;请勿将这些承诺应用于完整的从应用迁移到平台的过程。
验证码一直收不到,我应该检查哪些方面?
验证码一直收不到,我应该检查哪些方面?
确认完整的国际号码,并确认您能够接收所选的 SMS 或语音通话。对于固定电话或 IVR,请安排好接听验证电话的方式。如果连接屏幕提供了其他验证方式,请使用其他方式,并遵守任何重试计时。如果仍然失败,请向支持人员提供号码、所选方式、尝试时间和确切的错误信息——不要提供验证码或注册 PIN。
我的显示名称已获批准。为什么发送仍然失败?
我的显示名称已获批准。为什么发送仍然失败?
名称审核只涵盖所申请的商家名称,并不涵盖所有发送要求。请确认注册已完成,然后检查消息错误,确认是否涉及模板、窗口、计费、收件人或账户限制。YCloud 内部昵称也不会影响面向客户的名称审核或送达。

