尊敬的客户：
您好！
WhatsApp 将在 2026 年晚些时候推出的“用户名账号（Username）”功能。由于该变更会影响消息 Webhook 中用户身份字段的呈现方式，并可能涉及您现有系统对“用户标识”的存储与映射逻辑，Chat App 正在进行相关能力对接与兼容改造。我们将在对接完成后第一时间发布进一步通知与改造指引，请您及时关注后续动态。
用户名功能是针对用户或企业的一项可选功能。如果 WhatsApp 用户启用了该功能，则在应用中将显示用户名，而不是其电话号码。不过，企业用户名并非出于保护隐私的目的。如果企业账号启用了该功能，并不会导致业务号码在应用中被隐藏。
以下是 Meta 官方对该功能的部分描述，可访问其业务范围用户编号页面以详细了解。
用户名
用户名是 WhatsApp 用户可以设置的唯一可选名称，以便在应用中显示用户名而非电话号码。在为特定用户个性化消息内容时，可以使用账号代替个人主页名称。
WhatsApp 用户仅限使用 1 个用户名，能够定期更改。更改用户名不会影响用户的电话号码或业务范围用户编号（BSUID），也不会影响该用户在 WhatsApp Business 开放平台上与其他 WhatsApp 用户或企业沟通。
用户名会被赋值到 API 响应和 Webhook Payload 中的 username 属性。启用后，WhatsApp 用户的用户名会显示在所有收到的消息 Webhook，以及所有已送达和已读状态消息 Webhook 中。
业务范围用户编号（BSUID）
BSUID 是一种唯一用户标识符，可在您不知道某 WhatsApp 用户的电话号码时用来向该用户发消息。BSUID 将分配至 user_id 参数，并显示在所有消息 Webhook 中，无论用户是否已启用账号功能。
BSUID 在单个业务资产组合（BM）内有效。这意味着，资产组合内的任何商家电话号码都可以用于向同一资产组合范围内的 BSUID 发消息，使用其他资产组合拥有的商家号码向该 BSUID 发消息会失败。
BSUID 的特点如下：
系统自动生成。
前缀为用户的 ISO 3166 alpha-2 双字母国家/地区代码和一个英文句点，后跟最多 128 个字母数字字符（例如 US.13491208655302741918）。
在每个“业务资产组合 - 用户”匹配维度内保持唯一（业务资产组合之前称为“商务管理平台”）。
如果用户更改电话号码（这会触发系统状态消息 Webhook），则会重新生成 BSUID。
BSUID 可用于发送任何类型的消息，除了一键轻触、零轻触和复制验证码身份验证模板，身份验证模板仍然需要使用电话号码发送。
使用 BSUID 发出 API 请求时，应使用完整的 BSUID 值：国家/地区代码、英文句点和所有字母数字字符。如果您省略或更改国家/地区代码、英文句点或字母数字字符，请求将失败。如果您是拥有多个业务组合的企业，并且希望使用可在所有业务组合中使用的 BSUID，请参阅“父级业务范围用户 ID”。
父级业务范围用户 ID（Parent BSUID）
如果您是拥有多个业务组合的企业，您可以通过工单或联系您的业务对接人确认您是否符合 Meta 申请条件，提供Meta 所需的申请材料并通过申请且您的业务资产组合已完成关联后，父级 BSUID 将会包含在所有消息 Webhook 中，并被赋值到新的 parent_user_id 属性。
父级 BSUID 可以替代常规 BSUID 来向用户发消息。在功能上，父级 BSUID 与常规 BSUID 的属性相同，但可被关联资产组合中的任意商家电话号码使用。
请注意，您仍可使用限定在您业务资产组合范围内的常规 BSUID 向用户发送消息。
电话号码
如果 WhatsApp 用户启用用户名功能，则除非您之前与该用户有过互动（见下方说明），否则该用户的电话号码不会包含在 Webhook 中。因此，无论用户是否已启用该功能，用户的 BSUID 都会包含在通常包含其电话号码的任何 Webhook 中，并被赋值新的 user_id 属性。
为降低与启用用户名功能的现有用户丢失对话上下文的机率，当满足以下任意条件时，Webhook 中将包含用户电话号码：
在 Webhook 触发后的 30 天内，您向用户的电话号码发送了消息或发起了通话。
在 Webhook 触发后的 30 天内，您曾收到用户的电话号码发来的消息或来电。
您在用户的 WhatsApp 联系人名单中。
用户在您的通讯录中。
自 2026 年 3 月 31 日起，Meta 返回的 Webhook 中将开始出现 BSUID。但是，Meta API 在 2026 年 5 月（确切日期待定）之前暂不支持向 BSUID 定向发送消息。5 月份 Meta API 支持 BSUID 后，您将能使用用户的 BSUID、电话号码或同时使用这两者向用户发消息。
请求用户提供电话号码
为了更方便地向 WhatsApp 用户请求电话号码，新增了一种按钮 REQUEST_CONTACT_INFO，可以添加到 utility 和 marketing 模板中。
如果用户轻触此按钮，他们的虚拟联系人名片和 WhatsApp 电话号码将在消息对话中共享，并将触发联系人 Webhook，其中包含用户的电话号码和虚拟联系人名片 (vcard)。
如果企业使用通讯录功能，若未启用本地存储，用户的电话号码会自动添加到您的通讯录中。如果您已启用本地存储功能，在请求用户提供电话号码成功后还需要向用户的电话号码发送消息才能将用户的电话号码和 BSUID 添加到您的通讯录。
通讯录
2026 年 4 月初，为支持消息对话的连续性，Meta 将推出用于存储 WhatsApp 用户联系方式的通讯录功能。
此功能可用后，如果您向某个用户的电话号码发送消息/发起通话，或者从某个用户的电话号码接收消息/接听通话，该用户的电话号码和 BSUID 将添加到您的通讯录中。系统记录此数据后，会将其用于填充包含该用户电话号码或 BSUID 的任何 Webhook Payload 和 API 响应，无论该用户是否已启用用户名功能。
通讯录数据将保留至您禁用此功能或停用账户为止。您可以根据意愿，在 2026 年 3 月 16 日之后随时禁用此功能，路径为：Meta Business Suite > 业务设置 > 业务信息面板。禁用通讯录后，它将停止存储用户信息，任何已存储的现有用户信息也将被删除。如果您之后重新启用通讯录，它会再次开始存储用户信息，但之前存储的信息无法恢复。
限制：
如果您使用本地存储功能，且用户通过轻触“请求联系方式”按钮与您共享其电话号码，则该用户的联系方式不会被添加到您的通讯录。您可以在用户与您共享其电话号码后，向该电话号码发消息。这样一来，其电话号码和 BSUID 就会被记录到您的通讯录中。
通讯录的作用范围限定于业务资产组合。也就是说，如果您有多个关联的资产组合，用户的电话号码和 BSUID 必须单独记录到每个资产组合的通讯录中；用户联系方式不会在各个关联的资产组合之间共享或同步。
国家/地区代码
如果 WhatsApp 用户启用用户名功能，其电话号码（以及国家/地区拨打代码）可能不会出现在 Webhook 中。在这种情况下，用户的 BSUID 将改为以用户的 ISO 3166 alpha-2 双字母国家/地区代码作为前缀（例如 US.13491208655302741918）。
商家用户名
商家也可以启用商家用户名。如果您启用该功能，不会使您的商家电话号码在 WhatsApp 或 WhatsApp Business App中隐藏。
在整个 WhatsApp 体系内中，一个商家用户名对应单一商家电话号码，也就是说一个电话号码在任何时候只能有一个用户名，并且两个 WhatsApp 电话号码（包括消费者或企业号码）不能使用相同用户名。
业务账号必须遵循以下格式：
只能包含英文字母 (a-z)、数字 (0-9)、句点 (.) 和下划线 (_) 字符
长度须介于 3 至 35 个字符之间
须包含至少一个英文字母 (a-z、A-Z)
不得以句点开头或结尾，亦不得包含连续 2 个句点
不得以 www 开头
不得以网域结尾（如 .com、.org、.net、.int、.edu、.gov、.mil、.us、.in、.html 等）
对比账号时，会忽略大小写，但不会忽略英文句点和下划线字符；例如，myID 和 myid 视为相同 *账号，但 myid、my.id 和 my_id 视为不同账号
预留用户名
在用户名功能正式开放使用之前，您可以选择认领 WhatsApp 为您预留的用户名。或者，您也可以采用符合自身品牌要求的其他用户名。可以通过 WhatsApp 管理工具、Meta Business Suite 认领预留用户名。一旦用户名功能开放使用，获批的已认领用户名将变为有效账号。
如果预留用户名已用于您的 Facebook 公共主页或 Instagram 账户，您必须将自己的商家电话号码与 Facebook 公共主页或 Instagram 账户绑定，然后才能认领该用户名。
您可以在使用 Meta Business Suite 或 WhatsApp 管理工具认领时关联电话号码，或者通过访问 Facebook 公共主页或 Instagram 账户并直接添加电话号码来完成此操作。
如要绑定您的电话号码，您必须拥有该公共主页或账户的完全控制权，或具有 manage_phone 权限的基本部分访问权限。参阅业务资产组合和业务资产权限简介，详细了解控制权/访问权限和其他权限。
聊天窗口显示优先级
在应用的聊天窗口中显示商家主页信息时，将遵循以下优先级（按优先级的降序排列）。商家电话号码将始终显示在业务主页中。
已保存的联系人姓名。
已认证的商家名称或官方商业账户名称（OBA）。
商家用户名。
电话号码。