关于WhatsApp用户名与BSUID的完整指南

Team YCloud

Team YCloud

·

2026年3月27日

·

18 分钟阅读

·

更新🚀

 

WhatsApp Username  And BSUID Explained.png

如果您的业务系统仍将电话号码作为客户身份标识,此更新将导致重大故障!
 
自2026年6月起,WhatsApp推出了用户名功能,这将彻底改变用户身份识别方式。
随着用户名功能的推出,用户无需共享电话号码即可向企业发送消息或拨打电话。这意味着企业将无法始终获取电话号码,转而会接收到名为 BSUID(业务域用户标识)的新标识符。
 
这看似微小变化...实则影响深远!
 
若您的CRM系统、聊天机器人及自动化工作流仅依赖电话号码,此变更将破坏客户识别与追踪机制。与此同时,用户名让客户能更轻松无碍地发现并联系企业,无需保存号码且享有更强隐私保护。
 
因此...本指南将详解变更内容、BSUID实际运作机制、未做准备的潜在风险,以及如何正确升级系统而不过度复杂化。
 
接下来让我们了解WhatsApp推出用户名的原因。
 
 

WhatsApp为何推出用户名功能?

并非所有用户都愿意向每个联系企业透露电话号码。WhatsApp正着手解决这一问题。
迄今为止,通过WhatsApp与企业对话默认意味着共享个人号码。对注重隐私的用户而言,这一直是痛点——他们可能希望咨询问题、了解产品或联系客服,但不愿为此暴露私人号码。
 
这正是用户名功能的用武之地!
 
通过本次更新,用户可创建用户名来替代电话号码与企业沟通。这一机制赋予用户更多隐私控制权,从一开始就提供更舒适的使用体验。
 
此项变革同样惠及企业。
WhatsApp不仅为用户引入用户名功能,企业也可采用用户名,便于客户搜索联系。客户无需记忆或保存企业电话号码,直接通过用户名搜索即可发起对话。
 
这降低了接触门槛、提升了企业可发现性,使客户触达更为便捷。
 
但更深层次的后台变化在于: 企业识别客户的方式。
 
接下来,我们将解析实际变更内容,以及为何BSUID成为核心关键。
 
 

有哪些变化?

本次更新改变了一个重要事项: 企业如何识别WhatsApp上的客户。
用户现在可选择用户名与企业联系,无需共享手机号码。因此用户名功能上线后,手机号码将不再被自动分享。
 
企业将开始接收一个新的后端标识符 BSUID(业务范围用户ID)。对使用云API的企业而言,这将成为新的身份层,可在工作流中替代客户手机号码使用。
 
简言之:
之前 → 手机号 = 客户身份
现在 → 手机号或BSUID = 客户身份
 

BSUID (Business Scoped User ID)

 
这才是实质性的转变!
 
若新用户使用用户名发起与企业对话,您可能仅收到BSUID,不会自动获取其手机号。
若业务仍需手机号(例如发送OTP),需在对话中明确请求用户共享,最终决定权在用户手中。
 
但请注意,这 并非 意味手机号会完全消失!
若您已通过历史对话、其他渠道/平台、广告点击、订单记录、账户注册、CRM数据库或用户先前自愿提供等途径获得客户手机号,无论用户是否启用用户名功能,您仍可使用该手机号联系客户。因此本次更新主要影响 新用户发起对话 的运作方式。
 
 

认证消息(验证码/OTP)必须通过手机号发送

还存在一个重要限制:认证消息仍需使用手机号。
仅凭BSUID无法发送OTP或验证码认证消息。若此流程对业务至关重要,需建立明确的手机号请求与存储机制。

 

某些情况下,WhatsApp仍可能与企业共享手机号,例如:

  • 用户主动选择共享时
  • 用户与企业已有历史对话时
  • 企业已保存在用户的 WhatsApp 联系人中

 

因此,企业现在需要同时支持这两种情况:

  • 仅通过 BSUID 识别的客户
  • 通过电话号码和 BSUID 同时识别的客户

 

这就是为什么这不仅是一个产品更新,而是一个系统更新。

 

 

What is BSUID (Business Scoped User ID)

 

 

接下来,我们来看看 BSUID 本身,并了解其背后的工作原理。
 
 

什么是 BSUID(企业范围内的用户 ID)

为了支持用户名,WhatsApp 引入了一个新的标识符,称为 BSUID(企业范围内的用户 ID)。这现在是企业在电话号码不可用时识别用户的基础。

 

What is BSUID (Business Scoped User ID)


BSUID 是 唯一 ID ,为用户在特定企业中分配,旨在建立企业与客户之间的安全连接。即使没有用户的电话号码,它也能让你与用户通信并跟踪。
 
以下是重要部分:
同一用户将拥有 针对不同企业的不同 BSUID。
这是有意设计的。
它确保了隐私。企业 A 无法使用 BSUID 来跟踪用户与企业 B 的活动或互动。每个关系都是独立的。

 

What is BSUID (Business Scoped User ID)

 

 

BSUID 的工作原理

  • 它由 WhatsApp 自动生成
  • 它出现在 webhook 有效负载中 (作为 user_id)
  • 即使电话号码缺失它也能正常工作
  • 它与特定的业务组合相关联

 

因此,从系统的角度来看,这将成为您的 新用户标识符,用于传入的对话。

 

 

BSUID 格式(外观)

BSUID 遵循固定的结构:

  • 以用户的 ISO 3166 alpha-2 开始 两位字母的国家代码
  • 后面跟着一个 点号 (.)
  • 然后是一个 唯一的字母数字字符串(最多 128 个字符)

 

Example:
US.13491208655302741918

在 API 中使用它时, 必须严格按照原样使用整个值。
任何更改或截断都会导致请求失败。

 

 

您应该了解的关键规则

  • BSUID 是 每个业务组合-用户对的唯一标识符 (业务组合以前称为 Business Managers)
  • 它是 如果用户更改电话号码则会重新生成 (这会触发系统状态消息 webhook)
  • 它是 限定于一个业务组合的 (不能跨不同的组合使用)
  • 它出现在 webhooks 中 即使用户没有启用用户名

 

 

BSUID 的限制

BSUID 功能强大,但并不能完全取代电话号码。

  • 你 无法使用 BSUID 发送验证消息(OTP、验证码) 使用 BSUID
  • 这些流程仍然需要电话号码
  • 因此,如果你的用例依赖于 OTP,你必须从用户那里收集电话号码

 

 

观看此视频以了解更多关于 BSUID 的信息:

 
接下来,让我们看看哪些内容不会改变,以便你确切知道哪些方面保持稳定。
 
 

不变的内容

虽然此次更新改变了用户识别方式,但 WhatsApp 的大部分核心功能保持不变。根据 WhatsApp 的官方通知,以下功能将保持不变:
 

消息发送和接收机制

  • 消息模板的使用保持不变。
  • 对各种消息类型(文本、图片、视频、文档等)的支持保持不变。
  • 消息发送 API 接口的结构基本一致,只是 identifier 参数需要与 BSUID 兼容。
  • 已从现有对话中获取用户电话号码信息的企业不会丢失这些信息,并且能够继续使用它们来联系其联系人。

 

 

对话计费规则

  • 24 小时对话窗口机制保持不变。
  • 对话计费方式保持不变。
  • 无论客户使用电话号码还是用户名,计费逻辑保持一致。

 

 

还有哪些内容?

  • 电话号码仍然是 WhatsApp 工作方式的一部分。
  • 如果用户尚未采用用户名,企业将收到他们的电话号码和业务范围的标识符。

 

 

这意味着企业应将主要精力集中在客户识别和数据关联上;核心消息通信能力和业务逻辑将继续照常工作

 

接下来,我们来看看企业在适应这一新识别系统时将面临的挑战。

 
 

企业面临的挑战

一旦你理解了 BSUID,真正的问题就变成了:企业如何在这一新框架下继续准确识别客户?
因为从这里开始,事情就变得复杂了。
 

挑战 1:无法直接获取新用户的电话号码

当新用户使用用户名联系时,你只会收到一个 BSUID。

默认情况下,你不会得到他们的电话号码。

你仍然可以使用 BSUID 进行回复并继续对话。但如果你的业务需要电话号码(例如 OTP 或验证),你现在必须 在聊天中明确要求 并等待用户同意。

 

 

挑战 2:将 BSUID 与现有客户数据映射

今天的大多数 CRM 系统都是围绕电话号码构建的。

  • 客户资料
  • 聊天记录
  • 订单
  • 细分

 

一切都以电话号码为主键。

 

现在有了 BSUID,你需要决定:

  • 是将 BSUID 添加为新字段?
  • 还是在电话号码和 BSUID 之间创建一个单独的映射层?

 

这不仅仅是一个技术决策,它还会影响 数据一致性、查询逻辑和系统复杂性。

 

 

挑战3:当客户在不同身份标识间切换时保持会话连续性

对用户而言毫无变化,仍是同一对话

但对您的系统而言,可能出现故障

 

示例:

  • 首次交互 → 通过BSUID识别
  • 后续 → 用户提供手机号

 

若系统未正确关联两者,同一用户可能被当作 两个不同客户处理

 

后果:

  • 重复记录
  • 聊天记录断裂
  • 客户体验恶化

 

挑战4:验证与OTP流程处理

BSUID不可用于认证消息

 

若您的流程涉及:

  • OTP验证
  • 登录验证
  • 账户关联

 

您必须首先 收集用户手机号码

 

这意味着您现有流程可能需要重新设计以:

  • 明确请求授权
  • 获取号码
  • 正确存储与映射

 

 

接下来,我们来看看如果未能妥善应对这些挑战,具体会导致哪些问题。

 

 

故障后果(若忽视此问题)

若不适配BSUID,系统不会立即崩溃,而是会静默失效。

If you don’t adapt to BSUID, things won’t fail loudly; they’ll fail silently.

 

具体会出现以下故障:

  • 对话可能丢失
    通过用户名访问的新用户无法在系统中正确映射。

 

  • 消息流中断
    服务消息和CTWA(点击直达WhatsApp广告)流程可能无法按预期触发。

 

  • 聊天记录断连
    同一用户可能显示为多个身份。

 

  • CRM数据不可靠
    客户档案可能无法正确存储或映射数据。

 

  • 重复用户增加
    一个用户=手机号与BSUID对应的多条记录。

 

  • 自动化流程停摆
    基于手机号的工作流将无法触发。

 

  • 端到端流程崩溃
    从线索获取到后续跟进,整体流程将逐步瓦解。

 

  • 销售团队丧失可视性
    潜在客户无法被准确识别或追踪。

 

这就是为什么实际影响远超表面所见。
这不仅是数据问题,更会波及整个客户旅程。

 

接下来,我们将探讨如何正确解决这一问题并进行客户身份识别。

 

 

客户识别解决方案

这里没有放之四海皆准的方法。
企业现在需要处理 两种客户识别场景 并为两者构建解决方案。
 

场景一:新客户首次通过用户名发起联系(仅BSUID)

当新客户使用用户名发起对话时,您的系统可能仅会收到 BSUID。

这种情况下,BSUID将成为该客户档案的起点。

 

处理方法如下:

  • 您的数据模型应支持 同一客户拥有多个标识符 。
  • 您的CRM系统需能够 使用BSUID创建客户档案。
  • 您的系统应支持 通过BSUID进行查询和识别。
  • 若业务需要电话号码(例如要求提供配送地址或发送验证码时),应在对话适当时机向客户索取。
  • 若用户提供号码,则存储该号码并 将其关联至原有基于BSUID的档案。

 

 

场景二:已掌握电话号码的客户

若企业已存有客户电话号码,可继续使用该号码。

这部分保持不变。

即使用户启用了用户名,您仍可通过已知号码发送消息。但若该用户后续使用用户名发起对话,系统需能将新获取的 BSUID 与现有基于电话号码的记录关联。

 

处理方法如下:

  • 您的数据模型仍应支持 一个客户的多个标识符。
  • 当BSUID出现时,将其链接到现有的客户记录。
  • 您的系统应支持通过 电话号码或BSUID查找。
  • 优先使用 电话号码进行外发消息,尤其是在验证或认证流程中

 

 
目标很简单:
一个客户应始终保持为一个客户,即使他们使用两个标识符出现。
 
这就是您的系统现在需要支持的逻辑。
 
在上线之前,值得在测试环境中测试这些场景,以确保正确处理边缘情况。
 
接下来,让我们看看实施时间表以及您在每个阶段应采取的行动。
 
 

时间表与行动计划

WhatsApp已分阶段推出此功能,这为您提供了足够的时间来准备,但前提是您已尽早开始。

 

时间表

  • 2026年3月31日→ BSUID已开始在Webhook中出现。
  • 2026年5月→ BSUID测试可用(您可以开始使用BSUID发送)。
  • 2026年6月→ 测试国家/地区的人们可以开始采用用户名。用户名推出开始。
  • 2026年剩余时间→ 全球的人们可以开始采用用户名。

 

BSUID Timeline

 

企业应采取的行动

最好分阶段处理。
 
  1. 准备阶段(当前)

  • 了解并掌握BSUID机制及其技术细节。
  • 识别工作流中电话号码的使用场景。
  • 定义如何处理电话号码与BSUID的关系。
  • 评估修改现有系统所需的范围和工作量。
  • 制定数据库调整和API兼容性计划。
  • 开始技术研究和解决方案设计。
  • 协调内部团队(产品、工程、营销)并规划企业用户名策略。

 

 

  1. 实施阶段(功能上线前)

  • 更新CRM和数据库以支持BSUID。
  • 完成API集成层的兼容性改造。
  • 实施电话号码授权请求流程。
  • 确保验证码消息使用电话号码发送。
  • 完成测试环境的验证。
  • 准备分阶段发布(灰度发布)计划。

 

 

  1. 测试

  • 使用真实场景进行端到端测试。
  • 验证:
    • 基于BSUID的用户创建
    • 电话号码收集流程
    • 标识符之间的映射
    • 消息和自动化流程

 

 

  1. 上线阶段(功能上线后)

  • 分阶段推出(不要一次性切换所有内容)。
  • 监控系统运行状况,如档案创建准确性、OTP成功率和工作流性能。
  • 处理用户反馈并处理异常情况。
  • 优化客户识别逻辑。
  • 持续提高数据关联的准确性。
  • 监控电话号码授权率,并优化请求的时机和消息内容。
  • 认领并设置您的企业用户名。

 

 

上线前检查清单

在上线之前,请确保:

  • BSUID 已集成到您的系统中。
  • 您仍可以在没有电话号码的情况下发送和接收消息。
  • 所有工作流程都已针对两种标识符进行了测试。
  • 聊天机器人和旅程可以在需要时请求电话号码。
  • 现有工作流程已审核并更新以避免中断。

 

 

优先级

  • 高优先级 → CRM 和数据库结构调整、API 兼容性修改、验证码发送逻辑调整(影响核心功能)。
  • 中优先级 → 客户支持系统适配、营销系统更新(影响业务效率)。
  • 低优先级 → 数据报告优化、历史数据清理(可以逐步完善)。

 

 

这不是最后一刻才需要解决的问题。
您越早适应,过渡就会越顺利。

 

 

在哪里找到更多资源

如果您正在实施此操作,请不要依赖假设,使用官方文档。

以下是入门的关键资源:

 

 

 

 

这些都应该是您更新系统时的主要参考。

 

接下来,让我们快速总结一下这次更新对您的业务究竟意味着什么。
 
 

总结一下!

这不是一次小的更新。
这是 WhatsApp 识别用户方式的转变。
如果您的系统仅理解电话号码,您将丢失用户、数据和对话。
现在就开始支持 BSUID 吧!
 
 

术语表

以下是您将在 webhook 和 API 中看到的关键术语,用简单的方式进行解释:

  • contacts (新数组)
    涉及消息的用户列表。可以将其视为 webhook 中的“客户信息部分”。

 

  • profile
    contacts 中用户的基本信息。

 

  • username
    新属性。用户的 WhatsApp 用户名(如果已启用)。
    如果用户未设置用户名,则不会显示此字段。

 

  • wa_id
    新属性。用户的电话号码。
    如果电话号码可用,您将在此处看到它。
    如果用户使用的是用户名且未共享号码,此处可能为空。


 

  • user_id (BSUID)
    新属性。未来最重要的字段。
    这是 BSUID,代表您业务中用户的唯一ID。
    该字段始终存在,当电话号码不可用时应用来识别用户。


 

  • parent_user_id
    可跨多个业务组合使用的高级BSUID(如启用)。
    除非管理多个业务组合,大多数企业不会使用此字段。

 

 

简单理解方式:

  • wa_id → 电话号码(可能不可用)
  • user_id → BSUID(始终可用,新默认值)
  • username → 用户公开显示的信息

 

 

这些字段将是未来系统识别和追踪用户的依据。
 
 
 

Frequently Asked Questions

默认情况下不会。您将收到一个BSUID替代。
不过,用户可以选择在对话过程中分享其电话号码,某些情况下WhatsApp仍可能提供该号码。
是的。如果您已拥有客户的电话号码,可以继续使用该号码发送消息。
本次更新主要影响用户新发起的对话。
身份验证信息(如OTP)必须通过电话号码发送。
您需要在触发此类流程前向用户收集电话号码。
不会。您的现有数据保持不变。
引入BSUID是为了支持新的交互方式,而非取代您现有的客户记录。
不。消息传递的工作方式相同。
BSUID仅改变用户识别方式,不影响消息传递机制。
这取决于您现有系统的复杂性。我们建议首先进行全面的评估,涵盖影响范围、技术难度和测试工作负载,然后再制定详细的时间表和资源计划。中小型企业可能需要1-2名开发人员参与,而大型企业则可能需要跨团队协作。
在实际投入使用前,有几个关键注意事项需牢记。
OTP和身份验证仍需电话号码
BSUID无法用于验证流程。若您的应用场景依赖OTP,则必须收集用户电话号码。
 
部分用户仍会共享其电话号码
并非所有交互都仅使用BSUID。您的系统应能同时处理两种标识符。
 
通讯录将同时存储两种标识(即将更新)
未来WhatsApp或通过联系人历史记录协助建立电话号码与BSUID的映射关系。
 
请勿仅依赖电话号码
这是关键转变。您的系统应视BSUID为核心标识符,而非备用方案。

不,用户名是可选的。

采用用户名的用户可设置一个可选密钥,作为防止收到不必要用户名消息的额外保护层。来自WhatsApp Business应用的新用户或企业若未事先保存该用户联系人,则需提供密钥方可发起对话。请注意,通过WhatsApp Business Platform对接的API企业无需知晓用户密钥,因其BSUID(或电话号码)可验证现有连接并绕过密钥验证。

YCloud 将帮助您完成这一过渡:

  • BSUID 机制的技术文档和最佳实践指南
  • API 接口的兼容性支持和升级计划
  • 系统转型的技术咨询和实施建议
  • 上线过程中的技术支持和问题排查

如果您不确定如何调整您的系统,YCloud 团队可以助您加速完成。

YCloud 是你能找到的最好的BSP。

  • YCloud 是 Meta 官方BSP
  • 极具竞争力的会话价格
  • 一体化营销、销售和支持平台,提供免费入门服务
  • 免费客户支持

相关文章

WhatsApp免费入口窗口延长至7天——了解有哪些变化?

WhatsApp免费入口窗口延长至7天——了解有哪些变化?

Meta 将 CTWA 免费消息窗口从 72 小时延长至 7 天。了解其工作原理、哪些消息是免费的以及企业需要知道的信息。

Team YCloud
Team YCloud · 2026年10月28日