Action required: WhatsApp now uses BSUID as the primary identifier

Action required: WhatsApp now uses BSUID as the primary identifier

 Important
If your support team uses WhatsApp to engage with customers, there is an important platform change you need to know about. BSUID support is now mandatory for all WhatsApp Business Platform partners and businesses.

WhatsApp is introducing usernames, which allow customers to interact with businesses without sharing their phone numbers. To handle this, supporting the Business-Scoped User ID (BSUID) is now mandatory for all WhatsApp Business Platform partners and businesses, including Click-to-WhatsApp (CTWA) advertisers.

Going forward, BSUID should be treated as the primary customer identifier, while phone numbers should be stored as supporting information whenever they are available. See Meta's official documentation ↗



What is a BSUID?

A Business-Scoped User ID (BSUID) is a unique identifier that Meta generates for every customer and business relationship. It appears in webhook payloads as the user_id parameter and can be used to identify and message WhatsApp users even when their phone number is unavailable.


Note
A note on storing BSUID: IM receives the BSUID in the user_id webhook field, but storing it against a contact record requires your integration to be explicitly configured to do so. See the Action Checklist below.

When will you still see a phone number?

Phone numbers are no longer guaranteed in every webhook payload. A phone number will continue to appear when one of the following conditions is met:

Condition Explanation
30-day interaction window Your business phone number has sent a message or call to the customer, or received a message or call from the customer, within the previous 30 days. The window resets with each qualifying interaction in either direction.

Important
The 30-day interaction window is evaluated per business phone number, not per business portfolio. If a customer interacts with one business number, another number under the same portfolio does not automatically inherit that window. Reference ↗
Condition Explanation
Contact Book mapping exists The customer's phone number and BSUID have been stored in Meta's Contact Book through a real interaction after April 2026.


What is the Contact Book?

The Contact Book is a Meta-hosted mapping between a customer's phone number and their BSUID. It is enabled by default, scoped to the business portfolio level, and requires no additional integration work. Any real message or call between your business and a customer after April 2026 automatically stores the phone-to-BSUID mapping. This helps preserve phone number visibility in future webhooks, even after a customer adopts a username.

  1. Interactions that occurred before April 2026 are not recorded retroactively. Customers returning after a long gap who now use a username may initially appear as new contacts.
  2. Disabling the Contact Book permanently removes all stored mappings and they cannot be recovered. To manage this setting, go to Meta Business Suite > Business Settings > Business Info.
  3. Contact Book data is scoped per business portfolio. Any interaction between any business phone number within the portfolio and a customer triggers storage. Mappings are not shared across different portfolios, even when those portfolios belong to the same Meta Business Account.

See also: Learn more about Contact Book ↗


The three scenarios you will encounter

As usernames become more common, businesses are likely to encounter one of the following scenarios. Refer to the diagram in the original article for a visual breakdown.



What happens when you only have a BSUID?

A BSUID allows your business to continue existing conversations, route tickets while maintaining conversation history, and send most WhatsApp message types.

Info
The only exception is one-tap, zero-tap, and copy code authentication templates, which continue to require a phone number.

If your business process depends on a phone number, you can request it using the REQUEST_CONTACT_INFO button, available in utility and marketing templates and interactive messages. When the customer shares their number, a contacts webhook is triggered and the phone number and BSUID mapping is stored in the Contact Book automatically. If the customer declines, the conversation continues using the BSUID.


What this means for your day-to-day work in Zoho Desk

Area Impact
Finding customers Searching by phone number may no longer work for customers who have adopted usernames and fall outside the phone number sharing window. Searching by BSUID becomes increasingly important.
Conversation history Customers who last interacted before Contact Book became available and return using a username may initially appear as new contacts.
Automations and workflowsz Any custom workflow, macro, integration, or automation that relies exclusively on phone numbers should be reviewed to ensure it also supports BSUIDs.
Click-to-WhatsApp ads Zoho Desk IM does not currently support CTWA. Until it is available, conversations from CTWA ads where the customer has adopted a username and falls outside the phone number sharing window may not be processed correctly. No action is needed from administrators at this stage.
Broadcast messages Existing broadcasts to known phone numbers continue to work without any change. Broadcasting to BSUID-only contacts requires the outbound BSUID API, which went live in July 2026. Review your broadcast workflows if you plan to reach customers who do not have a phone number on record.
Authentication workflows No change. One-tap, zero-tap, and copy code authentication templates still require phone numbers.
Multiple business portfolios Without Parent BSUID, the same customer appears as separate identities across different portfolios.

Managing multiple business portfolios

If your organization manages more than one Meta Business portfolio, Parent BSUID links customer identities across portfolios that belong to the same Meta Business Account. See Meta's guidance on Parent BSUID ↗



Parent BSUID is not enabled by default. Your team will need to request access through your Meta point of contact. If eligible, your portfolios can be enrolled and parent BSUIDs will begin appearing in all message webhooks alongside the standard BSUID.
Note
Without Parent BSUID, the same customer appears as separate identities across different portfolios. Contact your Meta point of contact to check eligibility and request enrollment.

Action checklist

Use the following checklist to prepare your IM WhatsApp integration for BSUID support:

           ✅  Action Checklist
Confirm your IM WhatsApp integration parses and stores the user_id (BSUID) field from all incoming webhook events.
Update customer records to store BSUID alongside phone numbers.
Review workflows, routing rules, automations, macros, and integrations that currently depend only on phone numbers.
Keep Contact Book enabled. It is on by default and preserves phone number to BSUID mappings.
If you manage multiple business portfolios, check with your Meta point of contact about enabling Parent BSUID.
Decide how your business will request phone numbers for BSUID-only customers when required for downstream processes.
Test your webhook handling using Meta's App Dashboard, which now supports BSUID-only, username-enabled, and Parent BSUID scenarios.
Actively interact with existing customers through your WhatsApp business numbers to maintain the 30-day window. Sending or receiving a message or call in either direction resets the window and helps preserve phone number visibility for customers who adopt usernames.
This article is based on Meta's official WhatsApp Business Platform documentation, last updated June 29, 2026. As Meta continues its phased rollout of usernames and BSUID support, some implementation details and timelines may change. We recommend reviewing Meta's latest documentation for the most up-to-date information.

    • Recent Topics

    • Virtual Option for Fields

      Hi, I would like to be able to choose another option other than Read-Only or Disabled, such as Virtual. And with Virtual, the field is shown on the form and avilable in rules, but NOT saved to the Database. A use case is having multiple Large Lists of

    • Upcoming update to field values in Zoho Books - Zoho Analytics integration

      Hello Users, We'd like to inform you of an upcoming update to the tax_category values in the Zoho Books integration for Zoho Analytics from October 20, 2026. What's Changing? tax_category field values are being renamed to align with the conventions already

    • Prefix & Suffix on Single Line, Number, etc.

      Hi, I would like to have the same Prefix and Suffix that was added to the Unique ID on Text and Number Fields. Use case could be as basic as temperature, as per another Idea I have to use Single Line (Text) for a number that might have leading zeros today,

    • Announcing the new SKILL.md for Zoho CRM and the updated OAS repository!

      We are introducing a new zoho-crm skill to make working with Zoho CRM Developer tools (like APIs, functions, widgets, client scripts, queries etc) easier and faster, with the help of AI in your preferred AI harness like Claude Code, Codex, Cursor, VSCode

    • Handle Leading Zeros in a Number Field

      Hi, If I use a Number Field, set with Min 7 Digits and Max 7 Digits, and enter 0000001, it will result in 1 and an error as it removes the leading zeros, the same with entering 0012340 will result in 12340 and error. So I have to use a Text Field and

    • Introducing Microsoft Word Integration in Zoho Contracts

      We are excited to announce a new feature that brings contract authoring and negotiation in your familiar environment — the Microsoft Word Integration. What This Integration Brings The Microsoft Word Integration connects Zoho Contracts with the Microsoft

    • Kaizen #259 - Working with Zoho CRM APIs using zoho-crm skill

      In the previous Kaizen, we introduced the zoho-crm skill and discussed how it can work with different CRM developer capabilities. The zoho-crm skill makes it easier to work with Zoho CRM without having to remember every API endpoint, request structure,

    • How can I populate dropdown data with information from another source or app?

      I want to maintain a list of items in another app (say in excel or another database) and sync those as items in a drop down menu, instead of copy pasting to import. Is this kind of a feature available?

    • Zoho Community Digest - September 2026 | Part 1

      Hi everyone, and welcome back! September opens with a strong set of updates. Zoho CRM brings workflow automation down to the subform row level and ships a new SKILL.md for AI-assisted development, Zoho Desk introduces conditional branching with Automation

    • Tip #88 – Manage Incoming Support Requests Efficiently with the Service Queue – 'Insider Insights'

      Hello Zoho Assist Community! Not every team has a dedicated IT department or a fully built-out sysadmin setup. For smaller teams, when something breaks, there's no internal ticket system to log into, no helpdesk queue to route through, and no clear way

    • Delete CRM Portal

      How do I delete portals from my CRM? I created one just to test, it is not in use and is disabled but it's existence is preventing me from marking fields in modules as "required" unless I make it 'read/write' in the portal first. I'd rather just delete

    • Creating new Teams meeting from CRM doesn't enable Team functions in the meeting

      Hi I'm trying to set up the meeting integration and I've seen that when I create a Meeting in the CRM and set the location to Online and the Provider to Teams, and complete the boxes, add a participant etc, whilst the meeting is created in Teams, the

    • Zoho Books | Product updates | July 2026

      Hello users, We’re excited to bring you the latest updates in Zoho Books for July 2026! This month's release introduces Terminal Payments, CMP-08 filing for composition taxpayers, SEPA Credit Transfer support, and Self-Billed Credit Notes and Debit Notes

    • Calendar invites from Contacts not being assigned to Account in CRM

      Hi all It's that time of year again when I try to get calendar and meetings sorted in CRM. I have two way sync enabled. I have the option set to check for customer meeting invitation mail and to add them as meetings. However, whilst those meetings show

    • Kaizen #258 - Getting Started with zoho-crm SKILL.md

      Howdy tech wizards, Welcome to a fresh week of Kaizen. This week, we are taking a look at the zoho-crm SKILL.md, an Agent Skill designed to help AI coding agents work with Zoho CRM’s developer capabilities. What is zoho-crm SKILL.md? The zoho-crm skill

    • Zoho Tables is now live in Australia & New Zealand!

      Hey everyone! We’ve got some great news to share — Zoho Tables is now officially available in the Australian Data Center serving users across Australia and New Zealand regions! Yes, it took us a bit longer to get here, but this version of Zoho Tables

    • Dashboard/Component filter by probability

      Hi all Can I request the ability to add a Component or Dashboard filter for Deal Probability? Would be useful to be able to see data of deals more than 60% probable. Olly

    • Stock (on-hand) Items not updated after using Composite items

      Hi there, I created a Composite item (consist of 3 items). After I created the Composite item, I invoiced it and shipped the items. However the actual stock on hand of the 3items didn't change at all. Have you guys encountered this? Thank you Regards,

    • Is there a way to show contact emails in the Account?

      I know I can see the emails I have sent and received on a Contact detail view, but I want to be able to see all the emails that have been sent and received between all an Accounts Contacts on the Account Detail view. That way when I see the Account detail

    • Important changes for users with Zoho accounts in the UAE and other Data Centers

      What's changing? Previously, the same email address could be used to create separate Zoho accounts in both the UAE data center and another Zoho data center (such as US, EU, IN, AU, JP, CA, SA or SG). With this change, an email address can be associated

    • 👍 Zoho CRM's Notes now gets Reactions and a new look

      Available in SA and JP DCs. Rolling out to other DCs in phases. Hello everyone, Notes help users capture important updates, collaborate with teammates, and maintain context for records. Now with Note Reactions, users can quickly acknowledge updates, express

    • Conditional Layouts On Multi Select Field

      How we can use Conditional Layouts On Multi Select Field field? Please help. Moderation update: Multi-select picklist fields are now supported in Layout Rules. Additionally, Layout Rules is now available in the Professional Edition. These updates have

    • Zoho Marketing Automation WhatsApp Campaign Import Sync for Zoho Analytics

      WhatsApp is a critical channel in modern marketing, yet WhatsApp Campaign metrics from Zoho Marketing Automation currently cannot be natively imported into Zoho Analytics via the default advanced analytics connector. Integrating this into the standard

    • merge the Multiple POs to single PO if Vendor of PO"s --in Zoho Inventory

      HI Merge the Multiple POs to single PO if Vendor of PO"s are Same ----in Zoho inventory Please provide any work around to achive this .

    • Delug script

      I have been looking at auto-update a amount (home currency) field from another module. Zoho native multicurrency was used in the other module (we have 4 here). Custom script was input with no error, but the field was not updated on trigger. Script as

    • Is there a CRM Deluge function available to convert an RTF (rich text field) to plain text (with no formatting tags)?

      I know that we can run reports so that RTF fields can either show as plain text or the text or the text with the formatting fields included (which is wonderful, btw, as it helps me adjust tags when I need to troubleshoot and just see what I need to see

    • 【Zoholics Japan 2026】ITreview 口コミ投稿キャンペーンを実施します！

      ユーザーの皆さま、こんにちは！ 2026年9月25日（金）開催の「Zoholics Japan 2026」会場にて、 Zoho CRM・Zoho Workplace・Zoho Mail を対象とした「ITreview 口コミ投稿キャンペーン」を実施します！ Zoholics にご来場いただく皆さま、ぜひこの機会に普段お使いの Zoho 製品について、率直なご感想をお聞かせください。 【キャンペーン内容】 対象製品： ・Zoho CRM ・Zoho Workplace ・Zoho Mail キャンペーン実施時間：

    • Contact removed when picking ticket template.

      hi new to Desk rolling out to company, replacing Freshdesk. Is there way to keep the in context contact when selecting a template? When you choose a template you lose the contact!

    • Using IMAP configuration for shared email inboxes

      Our customer service team utilizes shared email boxes to allow multiple people to view and handle incoming customer requests. For example, the customer sends an email to info@xxxx.com and multiple people can view it and handle the request. How can I configure

    • Zoho Tables is now available in Zoho One!

      Hello Zoho One users, We’re excited to announce that Zoho Tables is now included as a part of Zoho One suite! As teams grow, managing projects, approvals, inventories, campaign trackers, and operational workflows across multiple spreadsheets become difficult.

    • Zoho Publish is now available in Zoho One!

      Hello Zoho One users, We’re excited to announce that Zoho Publish is now included as part of the Zoho One suite! As businesses grow, managing Google Business Profiles across many locations becomes challenging. Business information needs to stay accurate,

    • Global Sets for Multi-Select pick lists

      When is this feature coming to Zoho CRM? It would be very useful now we have got used to having it for the normal pick lists.

    • Bank Transaction Rules Link Under Each Bank Account

      Hello, can you'll move the "transaction rules" button or link back under each bank account? It is now on Bank Overview, if I am working on a specific bank account, I don't want to go out to overview to check the rules. That button displays rules for all

    • Nested notebooks

      Dear Sir/Madam, I would like to know if it is possible to nest notebooks. It would be very helpful when there are too many, as it would improve organization. Thank you for your response. Best regards.

    • Zia Agents looks promising, but I still cannot deploy my first agent or connect WhatsApp after weeks of support tickets

      Hi Everyone, I am posting here because I am stuck and need practical help from someone who has successfully deployed a Zia Agent with WhatsApp. Zia Agents looks like a very promising product. I have watched the platform expand quickly, and I have noticed

    • Zoho CRM

      Cuándo voy a adjuntar un archivo .pdf en un registro en el campo Archivo obtengo el siguiente error:

    • Implement Meeting Polls in Zoho Bookings

      Dear Zoho Bookings Support Team, We'd like to propose a feature enhancement related to appointment scheduling within Zoho Bookings. Current Functionality: Zoho Bookings excels at streamlining individual appointment scheduling. Users can set availability

    • Recording Salaries and wages in zoho books with bank fees

      Hello Community, I am posting this questions to understand the best way to record the salary and payroll expenses in zoho books. The way it works here, For example if I have 3 employees and each employee salary is lets say $1000. I usually use the bank

    • API - Available Stock Definitions

      Okay, Zoho team... your copywriters fell down on the job for this one :) I think these warrant a bit more explanation as to what they include and what they don't.

    • [BUG] WebTabs in ZohoCRM now have a spurious "\" displayed along with some additional HTML Head code included

      An example of the issue can be seen below:

    • Next Page