Chat App Message Service：關於業務範圍使用者編號（BSUID）能力的相容通知

使用者名稱

使用者名稱是 WhatsApp 使用者可以設定的唯一可選名稱，以便在應用中顯示使用者名稱而非電話號碼。在為特定使用者個人化訊息內容時，可以使用帳號代替個人首頁名稱。

WhatsApp 使用者僅限使用 1 個使用者名稱，能夠定期更改。更改使用者名稱不會影響使用者的電話號碼或業務範圍使用者編號（BSUID），也不會影響該使用者在 WhatsApp Business 開放平台上與其他 WhatsApp 使用者或企業溝通。

使用者名稱會被賦值到 API 響應和 Webhook Payload 中的 username 屬性。啟用後，WhatsApp 使用者的使用者名稱會顯示在所有收到的訊息 Webhook，以及所有已送達和已讀狀態訊息 Webhook 中。

業務範圍使用者編號（BSUID）

BSUID 是一種唯一使用者識別碼，可在您不知道某 WhatsApp 使用者的電話號碼時用來向該使用者發訊息。BSUID 將分配至 user_id 參數，並顯示在所有訊息 Webhook 中，無論使用者是否已啟用帳號功能。

BSUID 在單個業務資產組合（BM）內有效。這意味著，資產組合內的任何商家電話號碼都可以用於向同一資產組合範圍內的 BSUID 發訊息，使用其他資產組合擁有的商家號碼向該 BSUID 發訊息會失敗。

BSUID 的特點如下：

• 系統自動產生。

• 首碼為使用者的 ISO 3166 alpha-2⁠ 雙字母國家/區域碼和一個英文句點，後跟最多 128 個字母數字字元（例如 US.13491208655302741918）。

• 在每個“業務資產組合 - 使用者”匹配維度內保持唯一（業務資產組合⁠之前稱為“商務管理平台”）。

• 如果使用者更改電話號碼（這會觸發系統狀態訊息 Webhook），則會重建 BSUID。

BSUID 可用於發送任何類型的訊息，除了一鍵輕觸、零輕觸和複製驗證碼身分識別驗證模板，身分識別驗證模板仍然需要使用電話號碼發送。

使用 BSUID 發出 API 請求時，應使用完整的 BSUID 值：國家/區域碼、英文句點和所有字母數字字元。如果您省略或更改國家/區域碼、英文句點或字母數字字元，請求將失敗。如果您是擁有多個業務組合的企業，並且希望使用可在所有業務組合中使用的 BSUID，請參閱“父級業務範圍使用者識別碼”。

父級業務範圍使用者識別碼（Parent BSUID）

如果您是擁有多個業務組合的企業，您可以通過工單或聯絡您的業務對接人確認您是否符合 Meta 申請條件，提供Meta 所需的申請材料並通過申請且您的業務資產組合已完成關聯後，父級 BSUID 將會包含在所有訊息 Webhook 中，並被賦值到新的 parent_user_id 屬性。
父級 BSUID 可以替代常規 BSUID 來向使用者發訊息。在功能上，父級 BSUID 與常規 BSUID 的屬性相同，但可被關聯資產組合中的任意商家電話號碼使用。
請注意，您仍可使用限定在您業務資產組合範圍內的常規 BSUID 向使用者發送訊息。

電話號碼

如果 WhatsApp 使用者啟用使用者名稱功能，則除非您之前與該使用者有過互動（見下方說明），否則該使用者的電話號碼不會包含在 Webhook 中。因此，無論使用者是否已啟用該功能，使用者的 BSUID 都會包含在通常包含其電話號碼的任何 Webhook 中，並被賦值新的 user_id 屬性。

為降低與啟用使用者名稱功能的現有使用者丟失對話內容相關的機率，當滿足以下任意條件時，Webhook 中將包含使用者電話號碼：

• 在 Webhook 觸發後的 30 天內，您向使用者的電話號碼發送了訊息或發起了通話。

• 在 Webhook 觸發後的 30 天內，您曾收到使用者的電話號碼發來的訊息或來電。

• 您在使用者的 WhatsApp 連絡人名單中。

• 使用者在您的通訊錄中。

自 2026 年 3 月 31 日起，Meta 返回的 Webhook 中將開始出現 BSUID。但是，Meta API 在 2026 年 5 月（確切日期待定）之前暫不支援向 BSUID 定向發送訊息。5 月份 Meta API 支援 BSUID 後，您將能使用使用者的 BSUID、電話號碼或同時使用這兩者向使用者發訊息。

請求使用者提供電話號碼

為了更方便地向 WhatsApp 使用者請求電話號碼，新增了一種按鈕 REQUEST_CONTACT_INFO，可以添加到 utility 和 marketing 模板中。
如果使用者輕觸此按鈕，他們的虛擬連絡人名片和 WhatsApp 電話號碼將在訊息對話中共用，並將觸發連絡人 Webhook，其中包含使用者的電話號碼和虛擬連絡人名片 (vcard)⁠。
如果企業使用通訊錄功能，若未啟用本機存放區，使用者的電話號碼會自動添加到您的通訊錄中。如果您已啟用本機存放區功能，在請求使用者提供電話號碼成功後還需要向使用者的電話號碼發送訊息才能將使用者的電話號碼和 BSUID 添加到您的通訊錄。

通訊錄

2026 年 4 月初，為支援訊息對話的連續性，Meta 將推出用於儲存 WhatsApp 使用者連絡方式的通訊錄功能。

此功能可用後，如果您向某個使用者的電話號碼發送訊息/發起通話，或者從某個使用者的電話號碼接收訊息/接聽通話，該使用者的電話號碼和 BSUID 將添加到您的通訊錄中。系統記錄此資料後，會將其用於填充包含該使用者電話號碼或 BSUID 的任何 Webhook Payload 和 API 響應，無論該使用者是否已啟用使用者名稱功能。

通訊錄資料將保留至您禁用此功能或停用賬戶為止。您可以根據意願，在 2026 年 3 月 16 日之後隨時禁用此功能，路徑為：Meta Business Suite > 業務設定 > 商務資訊⁠面板。禁用通訊錄後，它將停止儲存使用者資訊，任何已儲存的現有使用者資訊也將被刪除。如果您之後重新啟用通訊錄，它會再次開始儲存使用者資訊，但之前儲存的資訊無法恢複。

限制：

• 如果您使用本機存放區功能，且使用者通過輕觸“請求連絡方式”按鈕與您共用其電話號碼，則該使用者的連絡方式不會被添加到您的通訊錄。您可以在使用者與您共用其電話號碼後，向該電話號碼發訊息。這樣一來，其電話號碼和 BSUID 就會被記錄到您的通訊錄中。

• 通訊錄的作用範圍限定於業務資產組合。也就是說，如果您有多個關聯的資產組合，使用者的電話號碼和 BSUID 必須單獨記錄到每個資產組合的通訊錄中；使用者連絡方式不會在各個關聯的資產組合之間共用或同步。

國家/區域碼

如果 WhatsApp 使用者啟用使用者名稱功能，其電話號碼（以及省/地區撥打代碼）可能不會出現在 Webhook 中。在這種情況下，使用者的 BSUID 將改為以使用者的 ISO 3166 alpha-2⁠ 雙字母國家/區域碼作為首碼（例如 US.13491208655302741918）。

商家使用者名稱

商家也可以啟用商家使用者名稱。如果您啟用該功能，不會使您的商家電話號碼在 WhatsApp 或 WhatsApp Business App中隱藏。

在整個 WhatsApp 體系內中，一個商家使用者名稱對應單一商家電話號碼，也就是說一個電話號碼在任何時候只能有一個使用者名稱，並且兩個 WhatsApp 電話號碼（包括消費者或企業號碼）不能使用相同使用者名稱。

業務帳號必須遵循以下格式：

• 只能包含英文字母 (a-z)、數字 (0-9)、句點 (.) 和底線 (_) 字元

• 長度須介於 3 至 35 個字元之間

• 須包含至少一個英文字母 (a-z、A-Z)

• 不得以句點開頭或結尾，亦不得包含連續 2 個句點

• 不得以 www 開頭

• 不得以網域結尾（如 .com、.org、.net、.int、.edu、.gov、.mil、.us、.in、.html 等）

• 對比帳號時，會忽略大小寫，但不會忽略英文句點和底線；例如，myID 和 myid 視為相同 *帳號，但 myid、my.id 和 my_id 視為不同帳號