Support WhatsApp BSUID for Contact Matching (Meta Username Privacy Update)
M
Michiel de AutomateDoctor
As of June 2026, Meta is rolling out WhatsApp usernames, allowing users to hide their phone numbers by default. When a user adopts a username, businesses will no longer receive their phone number via webhook. Instead, Meta will deliver a Business Scoped User ID (BSUID), a unique identifier per business account.
Currently, GHL identifies and matches contacts exclusively by phone number. This means that once a contact adopts a WhatsApp username and hides their number, any incoming message from that contact will either fail to match an existing contact record, create a duplicate, or simply land as an unassigned conversation in the inbox.
For businesses using GHL with direct Meta integration, this is not a hypothetical edge case. It will affect real conversations, automations, and workflow triggers that rely on contact identification.
Requested solution:
Store and index the BSUID returned by Meta's webhook as a secondary contact identifier, alongside the phone number. When an incoming WhatsApp message carries a BSUID, GHL should attempt to match it against existing contacts before creating a new record. This would preserve conversation history, workflow context, and contact data integrity as Meta's username rollout expands.
This is a foundational fix that will become increasingly necessary as WhatsApp username adoption grows throughout 2026 and beyond.
Log In
S
Salvador Castillo
Here is the presentation for the update: https://view-su2.highspot.com/viewer/1c982bf1882e351f5dbe8e4421205861?content_id=4lCWCXfgVt5TBey
And I also got an email with documentation for BSUID: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids
E
Eddy CEO WhatSnap.ai - Connect YOUR phone to GHL
Oh wow, didn't realize Meta was pushing this timeline up. We're already seeing clients ask about username privacy options. The duplicate contact nightmare is real - our workflows break completely when contacts can't be matched properly.