{"id":457,"date":"2026-10-28T16:00:32","date_gmt":"2026-10-28T16:00:32","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/whatsapp-usernames-bsuid\/"},"modified":"2026-10-28T16:00:43","modified_gmt":"2026-10-28T16:00:43","slug":"whatsapp-usernames-bsuid","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/","title":{"rendered":"WhatsApp usernames and BSUIDs: what changes for API users"},"content":{"rendered":"\n<p><em>Updated on October 28, 2026<\/em><\/p>\n\n\n\n<p>Usernames are unique, optional names that people and businesses can adopt on WhatsApp; once a customer turns theirs on, their phone number may stop showing up in your WhatsApp Business API webhooks. To keep integrations able to tell who wrote in, Meta introduced the BSUID (business-scoped user ID), a user identifier that is only valid inside your business portfolio. It has appeared in webhooks since April 2026, and since July 2026 the API accepts it as a message recipient.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What WhatsApp usernames are<\/h2>\n\n\n\n<p>According to <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/business-scoped-user-ids\" target=\"_blank\" rel=\"noreferrer noopener\">Meta&#8217;s BSUID documentation<\/a>, a username is a name a user can set so it appears in the app instead of their phone number. Each person has at most one, can change it from time to time, and changing it does not affect their phone number or BSUID. Adopting a username is optional for both people and businesses.<\/p>\n\n\n\n<p>On the business side there is the <strong>business username<\/strong>. It does not hide the business phone number (Meta is explicit that business usernames are not a privacy feature), and each username maps to a single business phone number. Format rules:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>English letters, digits, periods and underscores only;<\/li>\n\n\n<li>3 to 35 characters, with at least one letter;<\/li>\n\n\n<li>cannot start or end with a period or contain two consecutive periods;<\/li>\n\n\n<li>cannot start with <code>www.<\/code> or end with a domain suffix such as <code>.com<\/code>;<\/li>\n\n\n<li>case-insensitive, but periods and underscores count: <code>mystore<\/code>, <code>my.store<\/code> and <code>my_store<\/code> are different names.<\/li>\n\n<\/ul>\n\n\n\n<p>Since June 29, 2026, businesses can reserve and adopt a username through Meta Business Suite, WhatsApp Manager, the WhatsApp Business app or the API. In the October 23, 2026 update, Meta added a limit: each business phone number can change its username up to 2 times in a rolling 14-day period (10 times for reserved usernames). Beyond that, the API returns error <code>130429<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What a BSUID is<\/h2>\n\n\n\n<p>A BSUID identifies a WhatsApp user for one specific business. Per the documentation, it is:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>generated automatically, whether or not the user has a username;<\/li>\n\n\n<li>made of the ISO 3166 alpha-2 country code, a period and up to 128 alphanumeric characters, e.g. <code>US.13491208655302741918<\/code>;<\/li>\n\n\n<li>unique per user + business portfolio pair (formerly Business Manager);<\/li>\n\n\n<li>regenerated when the user changes their phone number.<\/li>\n\n<\/ul>\n\n\n\n<p>Scope is what trips people up: a BSUID only works with business phone numbers in the same portfolio. In a SaaS, the BSUID received on customer A&#8217;s number cannot be used to send from customer B&#8217;s number.<\/p>\n\n\n\n<p>Businesses with several portfolios can ask Meta for a <strong>parent BSUID<\/strong>, valid across all enrolled portfolios. It has <code>ENT<\/code> after the country code (<code>US.ENT.11815799212886844830<\/code>) and arrives in the <code>parent_user_id<\/code> field. Enrollment depends on eligibility checked by your Meta point of contact.<\/p>\n\n\n\n<p>Meta states that BSUID support is mandatory for partners, directly integrated businesses and click-to-WhatsApp advertisers, because no one controls when a customer will turn on a username.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">New webhook fields<\/h2>\n\n\n\n<p>The BSUID shows up in every webhook that would normally carry the phone number. Documented fields:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Webhook<\/th><th>Field<\/th><th>Contains<\/th><\/tr><\/thead><tbody><tr><td>Incoming message<\/td><td><code>contacts[].user_id<\/code><\/td><td>User&#8217;s BSUID<\/td><\/tr><tr><td>Incoming message<\/td><td><code>contacts[].profile.username<\/code><\/td><td>Username, only if the user has one<\/td><\/tr><tr><td>Incoming message<\/td><td><code>messages[].from<\/code><\/td><td>Phone number (may be omitted)<\/td><\/tr><tr><td>Incoming message<\/td><td><code>messages[].from_user_id<\/code><\/td><td>BSUID<\/td><\/tr><tr><td>Status<\/td><td><code>statuses[].recipient_id<\/code><\/td><td>Phone number (may be omitted)<\/td><\/tr><tr><td>Status<\/td><td><code>statuses[].recipient_user_id<\/code><\/td><td>BSUID, always included (except <code>failed<\/code> sent to a phone number)<\/td><\/tr><tr><td>Any, if enabled<\/td><td><code>parent_user_id<\/code>, <code>from_parent_user_id<\/code>, <code>recipient_parent_user_id<\/code><\/td><td>Parent BSUID<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>An incoming message webhook from someone who turned on a username and whom you haven&#8217;t talked to in the last 30 days can arrive like this, with no phone number:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-json\">{\n  \"contacts\": [\n    {\n      \"profile\": { \"name\": \"Pablo M.\", \"username\": \"pablomorales\" },\n      \"user_id\": \"BR.13491208655302741918\"\n    }\n  ],\n  \"messages\": [\n    {\n      \"from_user_id\": \"BR.13491208655302741918\",\n      \"id\": \"wamid.HBgL...\",\n      \"timestamp\": \"1761650000\",\n      \"type\": \"text\",\n      \"text\": { \"body\": \"Hi, has my order arrived?\" }\n    }\n  ]\n}<\/code><\/pre>\n\n\n\n<p><code>user_preferences<\/code>, group and calling webhooks also gained these fields. A new <code>business_username_updates<\/code> webhook tells you when your business username status changes (<code>context: \"revoked\"<\/code> when Meta revokes it).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">When the phone number is still included<\/h3>\n\n\n\n<p>Even with a username on, the user&#8217;s number stays in the payload if at least one of these is true:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>you messaged or called that number in the last 30 days;<\/li>\n\n\n<li>you received a message or call from that number in the last 30 days;<\/li>\n\n\n<li>the user is in your contact book.<\/li>\n\n<\/ol>\n\n\n\n<p>The first two conditions are evaluated <strong>per business phone number<\/strong>, not per portfolio. If the customer talks to your sales number, the webhook on your support number may arrive without a phone number.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Number changes and BSUID changes<\/h3>\n\n\n\n<p>When a user changes numbers, the BSUID is regenerated and you get a system message on the <code>messages<\/code> field with <code>system.type<\/code> set to <code>user_changed_number<\/code>, carrying <code>user_id<\/code>, <code>previous_user_id<\/code> and <code>wa_id<\/code> when the number can be shared. If it can&#8217;t, the type is <code>user_changed_user_id<\/code> and only the identifiers change. Just subscribe to <code>messages<\/code> (<code>user_id_update<\/code> is not a subscribable field). For the general event format, see <a href=\"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-api-message-status-webhook\/\">WhatsApp API message status webhooks<\/a> and the <a href=\"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-api-glossary\/\">WhatsApp API glossary<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to send a message to a BSUID<\/h2>\n\n\n\n<p>Since July 2026, <code>POST \/&lt;PHONE_NUMBER_ID&gt;\/messages<\/code> accepts a <code>recipient<\/code> field with the BSUID instead of <code>to<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-bash\">curl -X POST 'https:\/\/graph.facebook.com\/&lt;API_VERSION&gt;\/&lt;PHONE_NUMBER_ID&gt;\/messages' \\\n  -H 'Authorization: Bearer &lt;ACCESS_TOKEN&gt;' \\\n  -H 'Content-Type: application\/json' \\\n  -d '{\n    \"messaging_product\": \"whatsapp\",\n    \"recipient_type\": \"individual\",\n    \"recipient\": \"BR.13491208655302741918\",\n    \"type\": \"text\",\n    \"text\": { \"body\": \"Your order is out for delivery.\" }\n  }'<\/code><\/pre>\n\n\n\n<p>Rules worth remembering:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Use the full value.<\/strong> Country code, period and every character. Any change makes the request fail.<\/li>\n\n\n<li><strong><code>to<\/code> beats <code>recipient<\/code>.<\/strong> If you send both, Meta uses the phone number.<\/li>\n\n\n<li><strong>Exception: authentication.<\/strong> One-tap, zero-tap and copy code authentication templates require the phone number. Sending them to a BSUID returns error <code>131062<\/code>.<\/li>\n\n\n<li><strong>Portfolio scope.<\/strong> A BSUID from another portfolio won&#8217;t work.<\/li>\n\n<\/ul>\n\n\n\n<p>The <a href=\"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-marketing-messages-api\/\">Marketing Messages API<\/a> has supported sending to BSUIDs since May 5, 2026, but Meta warns that delivery optimization doesn&#8217;t run on those sends and recommends using the phone number when you have it.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Asking the customer for their number<\/h3>\n\n\n\n<p>If a contact only has a BSUID and you need the number (for invoicing, billing or OTP), Meta created the <code>REQUEST_CONTACT_INFO<\/code> button. It can go in utility and marketing templates or be sent as an interactive message. When the user taps it, the number is shared in the chat and a contacts webhook arrives with <code>origin: \"contact_request\"<\/code>. The button label can&#8217;t be customized.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">The contact book Meta keeps for you<\/h2>\n\n\n\n<p>The contact book is hosted by Meta and needs no integration. Once the feature launches, every interaction (message or call, sent or received) between a portfolio number and a user stores that user&#8217;s phone number and BSUID. From then on, webhooks for that user include the phone number even if they turn on a username.<\/p>\n\n\n\n<p>Things to keep in mind:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>it isn&#8217;t retroactive: conversations from before the launch aren&#8217;t captured;<\/li>\n\n\n<li>the scope is the business portfolio;<\/li>\n\n\n<li>data is kept until you disable the feature (Meta Business Suite &gt; Business settings &gt; Business info) or deactivate the account; disabling deletes everything, and re-enabling doesn&#8217;t restore it;<\/li>\n\n\n<li>via the API, <code>GET \/&lt;PHONE_NUMBER_ID&gt;\/contact_book<\/code> tells you whether a number is stored for a BSUID (<code>present<\/code> field) without ever returning the number, and a <code>DELETE<\/code> removes the entry.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Impact on CRMs keyed on phone numbers<\/h2>\n\n\n\n<p>Most integrations use <code>wa_id<\/code> or <code>from<\/code> as the contact&#8217;s primary key. With usernames, messages may arrive without a phone number, and the BSUID changes when the customer changes numbers.<\/p>\n\n\n\n<p>A model that holds up:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Create an identities table<\/strong>, not a column. Each contact can have a phone number, one BSUID per portfolio and a parent BSUID.<\/li>\n\n\n<li><strong>Look up by BSUID first<\/strong>, then by phone. If both match different contacts, merge them.<\/li>\n\n\n<li><strong>Store the phone + BSUID pair whenever they arrive together.<\/strong> That&#8217;s how you recognize the customer when they later show up with only a BSUID.<\/li>\n\n\n<li><strong>Handle <code>user_changed_number<\/code> and <code>user_changed_user_id<\/code><\/strong> by updating the BSUID from <code>previous_user_id<\/code>.<\/li>\n\n\n<li><strong>Reply from the same business number<\/strong> when possible, because of the 30-day per-number rule.<\/li>\n\n\n<li><strong>Test before production.<\/strong> The App Dashboard has a <em>Test<\/em> button on the messages webhook with scenarios for users with and without usernames.<\/li>\n\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-js\">async function resolveContact(value) {\n  const c = value.contacts?.[0] ?? {};\n  const msg = value.messages?.[0] ?? {};\n  const bsuid = c.user_id ?? msg.from_user_id;\n  const phone = msg.from ?? c.wa_id; \/\/ may be empty\n\n  let contact = bsuid ? await db.contactByBsuid(bsuid) : null;\n  if (!contact &amp;&amp; phone) contact = await db.contactByPhone(phone);\n  if (!contact) contact = await db.createContact();\n\n  await db.link(contact.id, { bsuid, phone, username: c.profile?.username });\n  return contact;\n}<\/code><\/pre>\n\n\n\n<p>If your funnel depends on ads, the same care applies to attribution: see <a href=\"https:\/\/vectalk.com.br\/blog\/en\/track-click-to-whatsapp-ads\/\">how to track Click-to-WhatsApp ads<\/a>. Parallel account changes, like the <a href=\"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-account-messaging-account-waba\/\">new WABA structure<\/a>, also affect IDs your CRM stores.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Timeline confirmed in Meta&#8217;s documentation<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Date<\/th><th>What happened<\/th><\/tr><\/thead><tbody><tr><td>Early April 2026<\/td><td>BSUIDs start appearing in webhooks<\/td><\/tr><tr><td>May 5, 2026<\/td><td><code>\/marketing_messages<\/code> accepts BSUID recipients<\/td><\/tr><tr><td>June 29, 2026<\/td><td>Businesses can reserve and adopt a business username<\/td><\/tr><tr><td>July 2026<\/td><td>Cloud API accepts BSUID recipients; <code>REQUEST_CONTACT_INFO<\/code> button available<\/td><\/tr><tr><td>August 24, 2026<\/td><td>Contact book lookup (<code>GET ...\/contact_book<\/code>)<\/td><\/tr><tr><td>October 23, 2026<\/td><td>Username change limit (2 every 14 days) and error <code>130429<\/code><\/td><\/tr><tr><td>2026<\/td><td>WhatsApp rolls usernames out to users gradually<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Meta has not published a single date for all users to have usernames; the page only mentions a gradual rollout in 2026. We track upcoming changes in <a href=\"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-api-changes-2026\/\">WhatsApp API changes in 2026<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How it works with Vectalk<\/h2>\n\n\n\n<p>Vectalk is a proxy for the official <a href=\"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-cloud-api-en\/\">WhatsApp Cloud API<\/a>: webhooks you register with <code>POST \/api\/webhooks<\/code> receive the same payload Meta sends, so <code>user_id<\/code>, <code>from_user_id<\/code>, <code>username<\/code> and system messages arrive untouched. What has to change lives in your code, in the contact model above. The event reference is in the <a href=\"https:\/\/docs.vectalk.com.br\/concepts\/webhooks\">webhooks documentation<\/a>, and you can sign up at <a href=\"https:\/\/apps.vectalk.com.br\/register\">apps.vectalk.com.br\/register<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Frequently asked questions<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Will customers who turn on a username disappear from my CRM?<\/h3>\n\n\n\n<p>Not if your integration already reads the BSUID. It arrives in every webhook, with or without a username. What may be missing is the phone number, when there was no conversation on that number in the last 30 days and the customer isn&#8217;t in the contact book.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Can I send a marketing template to a BSUID?<\/h3>\n\n\n\n<p>Yes. Sending to a BSUID supports every message type except one-tap, zero-tap and copy code authentication templates. On the Marketing Messages API, BSUID sends don&#8217;t get delivery optimization.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Does the BSUID ever change?<\/h3>\n\n\n\n<p>It changes when the user changes their phone number. Changing a username doesn&#8217;t change the BSUID. The change arrives as a system message on the <code>messages<\/code> webhook.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Does a username hide my business phone number?<\/h3>\n\n\n\n<p>No. Meta says business usernames don&#8217;t hide the business number and aren&#8217;t meant as a privacy feature.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Does one BSUID work for all my SaaS customers?<\/h3>\n\n\n\n<p>No. It&#8217;s limited to the business portfolio where it was generated. Each customer will have its own BSUIDs for the same users.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><strong>Official sources consulted on October 28, 2026:<\/strong> <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/business-scoped-user-ids\" target=\"_blank\" rel=\"noreferrer noopener\">Business-scoped user IDs<\/a> (updated October 23, 2026), <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/changelog\" target=\"_blank\" rel=\"noreferrer noopener\">WhatsApp Business Platform changelog<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/marketing-messages\/send-marketing-messages\" target=\"_blank\" rel=\"noreferrer noopener\">Send marketing messages (Marketing Messages API)<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>With usernames, a customer&#8217;s phone number can disappear from your webhooks. Learn what a BSUID is, the new fields, and how to adapt your CRM.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[1],"tags":[],"class_list":["post-457","post","type-post","status-publish","format-standard","hentry","category-blog"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.7 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>WhatsApp Business Username and BSUID in the API | Vectalk<\/title>\n<meta name=\"description\" content=\"WhatsApp Business usernames and BSUIDs: new webhook fields, sending by BSUID, the contact book, and how to fix a CRM keyed on phone numbers.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"WhatsApp Business Username and BSUID in the API | Vectalk\" \/>\n<meta property=\"og:description\" content=\"WhatsApp Business usernames and BSUIDs: new webhook fields, sending by BSUID, the contact book, and how to fix a CRM keyed on phone numbers.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog Vectalk\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-28T16:00:32+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-10-28T16:00:43+00:00\" \/>\n<meta name=\"author\" content=\"wanderleyfcunha\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"wanderleyfcunha\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"9 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/en\\\/whatsapp-usernames-bsuid\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/en\\\/whatsapp-usernames-bsuid\\\/\"},\"author\":{\"name\":\"wanderleyfcunha\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"headline\":\"WhatsApp usernames and BSUIDs: what changes for API users\",\"datePublished\":\"2026-10-28T16:00:32+00:00\",\"dateModified\":\"2026-10-28T16:00:43+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/en\\\/whatsapp-usernames-bsuid\\\/\"},\"wordCount\":1596,\"articleSection\":[\"Blog\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/en\\\/whatsapp-usernames-bsuid\\\/\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/en\\\/whatsapp-usernames-bsuid\\\/\",\"name\":\"WhatsApp Business Username and BSUID in the API | Vectalk\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\"},\"datePublished\":\"2026-10-28T16:00:32+00:00\",\"dateModified\":\"2026-10-28T16:00:43+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"description\":\"WhatsApp Business usernames and BSUIDs: new webhook fields, sending by BSUID, the contact book, and how to fix a CRM keyed on phone numbers.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/en\\\/whatsapp-usernames-bsuid\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/en\\\/whatsapp-usernames-bsuid\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/en\\\/whatsapp-usernames-bsuid\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"WhatsApp usernames and BSUIDs: what changes for API users\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\",\"name\":\"Blog Vectalk\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\",\"name\":\"wanderleyfcunha\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"caption\":\"wanderleyfcunha\"},\"sameAs\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"WhatsApp Business Username and BSUID in the API | Vectalk","description":"WhatsApp Business usernames and BSUIDs: new webhook fields, sending by BSUID, the contact book, and how to fix a CRM keyed on phone numbers.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/","og_locale":"en_US","og_type":"article","og_title":"WhatsApp Business Username and BSUID in the API | Vectalk","og_description":"WhatsApp Business usernames and BSUIDs: new webhook fields, sending by BSUID, the contact book, and how to fix a CRM keyed on phone numbers.","og_url":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/","og_site_name":"Blog Vectalk","article_published_time":"2026-10-28T16:00:32+00:00","article_modified_time":"2026-10-28T16:00:43+00:00","author":"wanderleyfcunha","twitter_card":"summary_large_image","twitter_misc":{"Written by":"wanderleyfcunha","Est. reading time":"9 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/#article","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/"},"author":{"name":"wanderleyfcunha","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"headline":"WhatsApp usernames and BSUIDs: what changes for API users","datePublished":"2026-10-28T16:00:32+00:00","dateModified":"2026-10-28T16:00:43+00:00","mainEntityOfPage":{"@id":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/"},"wordCount":1596,"articleSection":["Blog"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/","url":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/","name":"WhatsApp Business Username and BSUID in the API | Vectalk","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/#website"},"datePublished":"2026-10-28T16:00:32+00:00","dateModified":"2026-10-28T16:00:43+00:00","author":{"@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"description":"WhatsApp Business usernames and BSUIDs: new webhook fields, sending by BSUID, the contact book, and how to fix a CRM keyed on phone numbers.","breadcrumb":{"@id":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vectalk.com.br\/blog\/en\/whatsapp-usernames-bsuid\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vectalk.com.br\/blog\/"},{"@type":"ListItem","position":2,"name":"WhatsApp usernames and BSUIDs: what changes for API users"}]},{"@type":"WebSite","@id":"https:\/\/vectalk.com.br\/blog\/#website","url":"https:\/\/vectalk.com.br\/blog\/","name":"Blog Vectalk","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vectalk.com.br\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b","name":"wanderleyfcunha","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","caption":"wanderleyfcunha"},"sameAs":["https:\/\/vectalk.com.br\/blog"]}]}},"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/457","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/comments?post=457"}],"version-history":[{"count":1,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/457\/revisions"}],"predecessor-version":[{"id":460,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/457\/revisions\/460"}],"wp:attachment":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/media?parent=457"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/categories?post=457"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/tags?post=457"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}