The implementation of Meta’s Usernames feature — the new @ usernames — introduced a new way of identifying users in the WhatsApp Business ecosystem. As part of this evolution, Meta now provides the Business Scoped User ID (BSUID), a unique identifier associated with a user within the scope of a Business Account.

To learn more about what Usernames are and what changes in your operation, check our documentation.

This change also impacts journeys within Zenvia Customer Cloud. See the details below.

Impacted journey — Contacts

1. Read-only BSUID field

To access this field, go to Contacts > Contact Database > Edit Contact.

When editing a contact, the system now displays a new section called WhatsApp Identifiers, which contains the BSUID (Business Scoped User ID) field.

Field display

The BSUID field is displayed in read-only mode, allowing only the viewing of the identifier assigned by Meta.

Because the BSUID is generated and managed exclusively by Meta, manual editing is not allowed.

The BSUID value is obtained exclusively from Meta through the WhatsApp Connector.

This identifier cannot be created, imported, or modified by the user through the Zenvia Customer Cloud interface or through manual contact update operations.

Whenever the system receives an event from Meta containing the BSUID, the Contact Manager is automatically updated to store this identifier in the corresponding contact record.

2. Column and filter customization

To access this feature, go to Contacts > Contact Database > Customize Filters and Columns.

As part of Meta’s Usernames implementation, the Contact Database list now offers two new columns that can be added to the table:

• BSUID (Business Scoped User ID)

• Username

These columns can be added to the table view and used as filter criteria, allowing you to find contacts using Meta WhatsApp ecosystem identifiers.

Flow 1 — Add columns

When you click Customize Filters and Columns, the system opens the table configuration window and displays the list of available columns.

Example:

• ☑ Contact (Name, Phone, Email) (preselected)

• ☑ Source (preselected)

• ☐ BSUID

• ☐ Username

• ☐ Last Purchase Date

• ☐ RFV Classification

• ☐ Contact Sentiment

• ☐ Company

The user can select BSUID and Username, and after clicking Apply, the Contact Database table will display these new columns.

Flow 2 — View columns

After applying the configuration, the contact list will display the new fields in the table.

Display rules

• When the contact has a synchronized BSUID, the identifier is displayed normally.

• When the contact does not yet have a BSUID received from Meta, the column displays an unavailable state (for example: - or Waiting for synchronization).

• The same behavior applies to the Username field.

Flow 3 — Filter by BSUID

When clicking the BSUID column header, the system provides the Filter option.

The user can enter a specific BSUID value to filter the table results.

The table will display only the contacts that have the specified BSUID.

Example:

BSUID: BR.5551999988076.