WhatsApp usernames and BSUIDs: what changes for Shopify order messages

WhatsApp usernames mean a reply may arrive with no phone number. What that means for order notifications, COD replies and the Beacon Messenger log.

WhatsApp is adding usernames. Through 2026 users can pick a unique handle and, if they want, hide their phone number from businesses they talk to. For a business sending through the Cloud API the visible change is in the webhook: a message from a user who adopted a username may arrive with the phone number missing and a new identifier in its place, a business-scoped user ID or BSUID. If you run a Shopify store and send order messages over WhatsApp, the question is what that does to the messages you send, the replies you receive and the records you keep. For Beacon Messenger the answer is: less than it sounds, with one case worth knowing about.

What a username and a BSUID are

A username is an optional display handle. The account still has a phone number behind it; the username is a layer on top that lets a person be found and shown without the number. Businesses can adopt one too, for branding, but a business's phone number stays visible to users regardless.

A BSUID is the identifier Meta gives a business for a user when the phone number is not to be shared. It looks like a country code, a dot and a long string: US.13491208655302741918. It is scoped to one business portfolio, so the same person has a different BSUID with every business they talk to, and it cannot be used with another portfolio's numbers. It survives a username change and is regenerated if the person changes their phone number. Microsoft's overview for its WhatsApp channel and Vonage's explainer both carry the same warning from Meta's documentation: the from field of an inbound message may now be empty, so do not assume it holds a phone number.

Outbound order messages: nothing changes

Every message Beacon Messenger sends starts from the phone number on the Shopify order. The shopper typed it at checkout, Shopify stored it on the order, and the app sends the template to that number. A username does not enter into it: the app is not looking anyone up by handle, and a customer who has hidden their number from businesses in general has still given it to you on the order. Order confirmations, shipping updates, COD checks and abandoned checkout reminders all go to the number on the record, exactly as before. The no phone number post remains the relevant one when a message is skipped: the cause is a missing or malformed number on the order, not a username.

What the customer sees at their end does not change either. Your messages arrive from your business number with your display name, as the display name post describes. Whether the customer has a username is between them and WhatsApp.

Inbound COD replies: matched by the message, not the number

The one place Beacon Messenger reads inbound messages is the cash on delivery confirmation. The app sends a COD check with buttons or a question, the customer replies, and the app tags the order confirmed or cancelled. It matters how that reply is matched to the order. The app does not look at who sent it; it looks at what the reply is a reply to. WhatsApp attaches the ID of the quoted message to a reply, the app finds its own sent message with that ID in the log, checks that it was a COD check from your shop, and reads the order from there. The reply matching post walks through the whole sequence.

Because of that, a reply with no phone number in it is matched exactly as well as one with. The classification runs, the reply is stored on the log row, and the order is tagged. A customer who adopted a username yesterday and taps Confirm on your COD check today is confirmed like anyone else.

The one gap: the thank-you message

After tagging the order the app sends a short acknowledgement, a free-form text such as thanks, your order is confirmed, in the language of the template. It sends that to the sender's number as reported in the reply. If WhatsApp has withheld the number, there is no number to send to, the send fails, and the failure is written to the server log. The order is already tagged by then, so the automation has done its job; what the customer misses is the one-line confirmation of their confirmation.

How often this happens depends on how many of your customers adopt usernames and choose to hide their number from businesses, which for a store they have just given their number to is likely to be a small share. Meta's own rules also make the number available in some situations even when a username exists, so an empty from field is the exception rather than the new normal. We are tracking it, and the app's handling of the acknowledgement is the piece that will change if it becomes common. Everything on the tagging side already works without a number.

What this means for the message log

The log records the recipient of every outbound message, which is the order's phone number, and stores the classified reply on the same row. Nothing in the log is keyed on the inbound sender, so a reply with no number leaves the same trail as before: the row shows sent, delivered, read, and the reply text with its classification. If you search the log for a customer, search by order or by the number on the order, as the log search post suggests; that has always been the reliable key.

What to tell your team

  • Order messages still go to the number on the Shopify order. Keep collecting it at checkout; the phone field settings in the no phone number post are still the ones to review.
  • COD replies are tagged by what they reply to, so a hidden number does not stop the order being confirmed or cancelled.
  • If a customer says they confirmed but got no thank-you, check the order tags before anything else. A tagged order means the reply was received and processed.
  • A customer cannot be messaged by username. If someone writes in with a handle and no number, ask for the number; templates need it.

Frequently asked questions

Can Beacon Messenger send a Shopify order notification to a WhatsApp username?

No, and neither can any other app yet. Messages are sent to a phone number, which comes from the Shopify order. A username is a display handle on top of a number, not an address you can send to. The customer has already given you their number at checkout, so this does not affect order messages.

Will cash on delivery replies still be tagged if the customer has a username?

Yes. The app matches a reply by the ID of the message it quotes, not by the sender's phone number. It finds its own COD check in the log, reads the order from it, classifies the reply and tags the order. A missing phone number in the reply does not change any of that.

What is a BSUID?

A business-scoped user ID, the identifier Meta gives your business for a user whose phone number is not shared with you. It has the form of a country code, a dot and a long string, is unique to your business portfolio, stays the same if the user changes their username and is regenerated if they change their phone number.

Does WhatsApp hide every customer's phone number now?

No. Usernames are optional and most users have not adopted one. Even when a user has, Meta's rules make the number available to businesses in some situations. The change is that a webhook may arrive without a number, so software must not assume one is always present.

More guides