> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/gong-gao/whatsapp-shi-yong-zhe-ming-cheng-yu-bsuid.md).

# WhatsApp 使用者名稱與 BSUID

改動內容與 Omnichat 的功能調整

### 改動內容

自 2026 年 7 月起,WhatsApp 用戶可逐步自行建立選用的 @使用者名稱。當顧客啟用使用者名稱後,其電話號碼將不再自動提供給企業。

為確保企業仍能識別顧客,WhatsApp 將推出 Business-Scoped User ID(BSUID),這是一組穩定、保障隱私、且專屬於您企業的識別碼。使用者名稱將於 2026 年 7 月下旬起在部分市場(包括新加坡與馬來西亞)率先推出,並於 2026 年 9 月起全面上線,涵蓋香港及其他市場。

想進一步了解 WhatsApp 使用者名稱與 BSUID,歡迎閱讀我們的部落格文章:[WhatsApp Usernames 與 BSUID 全攻略：你在 2026 必須掌握的通訊新準則](https://blog.omnichat.ai/hk/meta-whatsapp-usernames-bsuid-tutorial-zh/)

### 對您業務的影響

* 啟用使用者名稱的顧客,傳訊息給您時可能不會提供電話號碼
* 若未提前準備,可能產生重複聯絡人,並影響依賴電話號碼運作的流程
* 只要 BSUID 已擷取並與電話號碼綁定,顧客啟用使用者名稱對該聯絡人完全沒有影響,訊息傳送、聯絡人資料與對話紀錄皆維持正常

### Omnichat 的功能調整

*已上線*

* 自動擷取 BSUID:涵蓋所有顧客傳入的訊息(自 2026 年 4 月 8 日起)及所有成功送達的傳出訊息(自 2026 年 6 月 17 日起),無需任何設定
* BSUID 現已顯示於您的聯絡人資料及受眾名單中
* 所有 webhook 及 Open API 回應均包含 bsuid 欄位,與電話號碼並列
* 自動聯絡人比對:當顧客以使用者名稱傳訊息給您,Omnichat 會透過已擷取的 BSUID 自動比對其現有聯絡人,避免產生重複聯絡人
* 透過 BSUID 於所有流程傳送訊息( 對話、OMO、推播訊息、旅程、自動化、API (不包括 broadcast api) )
* BSUID 聯絡人適用 QR code 會員點數兌換 
* BSUID 資料單向同步至 Salesforce / HubSpot 
* 於渠道聯絡人以 BSUID 搜尋聯絡人 
* Get Contact Info 訊息卡:聊天機器人流程內建原生分享按鈕,顧客一鍵即可分享電話號碼

### 分享聯絡人

{% hint style="info" %}
支援機器人新卡片「分享聯絡人」，讓商家可以將該卡片設置於機器人中，建立取得顧客資料流程
{% endhint %}

#### 功能規格

{% hint style="info" %}
位置：進階自動化 > 機器人 > 新增/編輯WhatsApp 機器人 > 新增模組 > 新增卡片
{% endhint %}

* 卡片格式：
  * 內文
    * 必要
    * 上限 1024 字元。
  * 不支援標題以及頁尾。
  * 不支援按鈕編輯。
    * 客戶端固定為官方翻譯，WhatsApp 系統會根據用戶手機目前設定的語系，自動轉換成對應的官方標準翻譯：

      e.g.

      * 繁體中文：分享聯絡資訊
      * 英文：Share Contact Info
  * 無法設定 Additional Actions, 因為點擊按鈕當下無法收到 meta webhook，需要 user 另點擊「send」
    * Additional Actions:
      * 貼上標籤
      * 設為自訂屬性

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FshVTQBEElMNIOutlp8uF%2Fimage.png?alt=media&amp;token=b7a5155e-0ede-4cbe-a8e2-5fd83f5e82c1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2Fn0xMe6GqI8yl8cg9bSHS%2Fimage.png?alt=media&amp;token=9a617da7-a6f7-4b1d-96d9-f0423cc752a8" alt=""><figcaption></figcaption></figure>

* 卡片預覽樣式
  * 按鈕顯示文字依團隊語言決定
    * 繁中：分享聯絡資訊
    * 簡中：分享联系信息
    * 英文：Share Contact Info
    * 日文：連絡先を共有する

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FN6nQo9KSWNYezhwitk7O%2Fimage.png?alt=media&amp;token=0af26530-cb37-408e-bea8-e97b9b7c6a3a" alt=""><figcaption></figcaption></figure>

* 舊版機器人的處理
  * 不支援新增以及編輯「取得聯絡資訊卡片」。
  * 當該卡片曾經在新版機器人有建立過時，支援以下功能：
    * 查看「取得聯絡資訊卡片」(不包含設定內容)
    * 拖曳順序
    * 刪除卡片

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FUul4P7rGZg9dvEvcz3O6%2Fimage.png?alt=media&amp;token=3866ce62-03a9-4e7e-9344-6872eb94b99d" alt=""><figcaption></figcaption></figure>

**支援發送「分享聯絡資訊卡片」的相關功能頁**

* 對話
  * 預存回覆發送機器人
  * 關鍵字觸發機器人
* 群發
  * 群發一般訊息 - 預存回覆機器人
* 旅程
  * 觸發機器人
* 支援對話類型：
  * ＷhatsApp 對話
  * WhatsApp Coexistence 對話

**聯絡人 Webhook 相關處理**

時機：當用戶分享聯絡資訊時，將觸發聯絡人 Webhook。

* 收到 Webhook 之後，會即時更新聯絡人資料 (顧客姓名、電話)。
* 對話內的聯絡人資訊也會同步即時更新，包含以下位置：
  * 對話列表姓名 (電話)
  * 對話聊天室中發送者姓名
  * 對話右側顧客資料

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2F9zHudtGXY8ty9Zu3cCph%2Fimage.png?alt=media&amp;token=37065a7f-6f0e-4ef7-b8b3-cfa19116c826" alt=""><figcaption></figcaption></figure>

### 您現在可以做事

向現有聯絡人名單發送群發訊息或範本訊息。每一次成功送達(即使顧客未回覆)都會自動擷取 BSUID 並綁定至該電話號碼聯絡人。在使用者名稱上線前觸及越多聯絡人,日後出現的重複聯絡人就越少。

對您的設定有任何疑問?請聯繫您的 Omnichat 客服團隊。