Meta will begin rolling out 'username' starting late June 2026
It is an optional feature that allows user to hide their phone numbers when messaging businesses
When user adopts an username, their phone number will no longer appear in webhook payloads, instead, a Business Scoped User ID (BSUID) is returned
A BSUID is a unique Meta-generated identifier for a user-business pair that allow businesses to message users without their phone number, is valid within the same business portfolio and becomes invalid if the user changes their WhatsApp phone number
It should be stored for future communication when the user's phone number is unavailable
A parent BSUID is a Meta-generated identifier that represents a WhatsApp user across multiple business portfolios linked to the same Parent BSUID account, allowing any WhatsApp Business Account (WABA) phone number in those portfolio to message the user using the same identifier, unlike a regular BSUID which can only be used by a single business
It is recommended to store both the Parent BSUID and BSUID, using the Parent BSUID for messaging and BSUID as fallback if the portfolios are later unlinked
More information regarding the rollout of BSUID can be found here on Facebook Developer Guide
For further assistance, do raise a support ticket with our Support Team at support@moceanapi.com.