WhatsApp BSUID conversion tracking diagram showing a business-scoped user ID replacing a missing phone number in a Meta webhook

WhatsApp BSUID Conversion Tracking: 6 Smart Steps to Protect Attribution

WhatsApp BSUID conversion tracking is the new reality for anyone sending business messaging events to Meta. If you already run Click-to-WhatsApp ads and send Conversions API events, you may have noticed the customer’s phone number going missing from your webhook. Business-scoped user IDs are the reason.

This post covers the tracking side of WhatsApp BSUID conversion tracking only. It explains what a BSUID is, which webhook fields carry it, when the phone number disappears, and what to store so your attribution survives. CRM contact merging is a separate topic.

What is a WhatsApp BSUID and why did it appear?

A BSUID is a business-scoped user ID. Per Meta’s business-scoped user IDs documentation, it is an identifier for a WhatsApp user that is unique to your business portfolio, used to message someone when you do not know their phone number.

Its format is a two-letter country code, a period, then up to 128 alphanumeric characters, for example US.13491208655302741918. Meta began sharing BSUIDs and they started appearing in webhooks in early April 2026. Sending messages to a BSUID has been supported since July 2026, and business username reservations began on 29 June 2026.

Meta also states that Click-to-WhatsApp advertisers must support BSUIDs, so for ad-driven businesses this is not optional.

Which webhook fields carry the BSUID?

The BSUID shows up in several places in your webhook, depending on the event. Knowing each one keeps your parsing correct.

  • user_id in the contacts block
  • from_user_id on incoming messages
  • recipient_user_id in the statuses block
  • recipient_participant_user_id in group status webhooks
  • user_id together with previous_user_id in system messages

When you send a message, the recipient request parameter takes the BSUID, and the response contacts array returns user_id. Businesses enrolled in parent BSUID accounts also receive parent_user_id, which is shared across their enrolled portfolios.

When does the phone number disappear, and when does it stay?

This is the part that breaks tracking. Per Meta, if a user adopts a username, their phone number is left out of your webhooks.

There are two exceptions. The number still comes through if you exchanged a message or call with that number in the last 30 days, evaluated per business phone number, or if the user is already in your contact book. Outside those cases, you get a BSUID and no phone number.

Why does this matter for WhatsApp BSUID conversion tracking?

Here the two Meta documents meet. Meta’s Conversions API for Business Messaging documentation says to send ctwa_clid whenever you have it. Without ctwa_clid, the hashed customer information path requires page_id, at least one customer information parameter, an ad interaction within the last seven days, and it works only in a subset of countries, with no guaranteed match.

Now the conclusion, and this is my reasoning from the two documents, not something Meta states. Meta’s BSUID page does not mention the Conversions API or ctwa_clid at all.

The link is simple. The hashed fallback matches on customer information like the phone number. When a username hides that number, the fallback has nothing to hash. So for those conversations, ctwa_clid stops being merely the preferred option and becomes the only reliable one for WhatsApp BSUID conversion tracking.

That raises the stakes on capturing ctwa_clid from the first message after an ad click. If it goes missing, see ctwa_clid missing from the WhatsApp webhook, and for how the seven-day window behaves, Click-to-WhatsApp ads attribution. The wider setup is in the business messaging CAPI guide.

What should you store now so attribution survives a username switch?

Store three things against each contact, from the first inbound message onward.

  • The ctwa_clid, exactly as received, since it does not depend on the phone number
  • The BSUID (user_id or from_user_id), as your stable key within the portfolio
  • On a phone-number change, the previous_user_id from the system message, so you can link the old and new BSUID

A BSUID stays the same within your portfolio, but it is regenerated when the user changes their phone number. The system message carries previous_user_id precisely so the old and new identities can be stitched together. Storing it is what keeps WhatsApp BSUID conversion tracking intact across that change.

If you send events from your own Cloud API app, the baseline is in track WhatsApp conversions.

What should you check in your setup this week?

Before you rely on your WhatsApp BSUID conversion tracking, run these checks.

  • Confirm your webhook reads from_user_id and user_id, not only the phone number
  • Confirm you capture ctwa_clid on the first message and store it before replying
  • Confirm you handle system messages and save previous_user_id on a number change
  • Confirm conversations with no phone number still send a Conversions API event with ctwa_clid
  • Paste a sample payload into the CAPI debugger to check page_id and ctwa_clid are present

Running WhatsApp BSUID conversion tracking end to end, so missing phone numbers never silently break your attribution, is the kind of work I take on as a service.

Get WhatsApp conversion tracking set up

Frequently asked questions

What is a WhatsApp BSUID?

It is a business-scoped user ID, an identifier unique to your business portfolio that lets you message a WhatsApp user when you do not know their phone number. Its format is a country code, a period, then up to 128 alphanumeric characters.

Why is the phone number missing from my webhook?

If the user adopted a username, Meta leaves the phone number out unless you interacted with that number in the last 30 days, evaluated per business phone number, or the user is already in your contact book.

Does Meta say BSUIDs change the Conversions API?

No. Meta’s BSUID page does not mention the Conversions API or ctwa_clid. The connection to conversion tracking is my own reasoning from the two documents, not a Meta announcement.

How do I still track a conversion without the phone number?

Rely on ctwa_clid, which Meta advises sending whenever you have it. The hashed customer information fallback needs data like the phone number, so it cannot help when the number is hidden.

What is previous_user_id for?

When a user changes their phone number, their BSUID is regenerated. The system message carries previous_user_id so you can link the old and new BSUID and keep attribution connected.

Do Click-to-WhatsApp advertisers have to support BSUIDs?

Yes. Meta states that CTWA advertisers must support BSUIDs, so ad-driven businesses need to handle them.