WhatsAppユーザー名とBSUID: OTP、CRM、Webhookへの影響

ビジネススコープのユーザーID（BSUID）は、MetaがすべてのWhatsApp Webhookに含める識別子であり、これにより企業は電話番号を知ることなくユーザーにメッセージを送信できます。これが導入された理由は、WhatsAppがユーザー名を導入するためです。ユーザーがユーザー名を有効にすると、最近連絡を取っていない企業には電話番号が届かなくなる可能性があります。BroadNetエンジニアリングチームによるこのガイドでは、フォーマット、タイムライン、引き続き電話番号が必要な事項、およびWebhook、CRMレコード、OTPフローの移行方法について解説します。

主なポイント

• 2026年4月初旬より、ユーザーがユーザー名を使用しているかどうかにかかわらず、すべてのユーザーのWhatsApp WebhookにBSUIDが含まれるようになりました。
• BSUIDは「US.13491208655302741918」のような形式になります。これは、ISO 3166の2文字の国コード（alpha-2）、ピリオド、その後に続く最大128文字の英数字で構成されます。
• これは各ビジネスポートフォリオとユーザーのペアに対して一意であり、ユーザーが電話番号を変更した場合には再生成されます。
• 2026年7月以降、BSUIDへのメッセージ送信が可能になります。ただし、ワンタップ、ゼロタップ、およびコピーコード認証のテンプレートは例外であり、これらには引き続き電話番号が必要です。
• Metaによると、ユーザー名によるユーザーからのメッセージ処理能力を失わないために、パートナーおよび直接統合されたビジネスはBSUIDをサポートする必要があります。
• 検証済みのE.164電話番号を、OTP、SMSフォールバック、および不正チェックのためのアイデンティティアンカーとして保持してください。BSUIDをWhatsAppチャネルキーとして扱います。

ビジネススコープのユーザーIDとは何ですか？

Metaでは、BSUIDを「電話番号が不明な場合に、WhatsAppユーザーにメッセージを送信するために使用できる一意のユーザー識別子」と定義しています (Meta、ビジネススコープのユーザーID)。形式は、ユーザーの国をISO 3166 alpha-2コードで表したもの、ピリオド、および最大128文字の英数字です。例：US.13491208655302741918。

システム設計において重要な3つの特性があります：

• スコープ。BSUIDは、1つのビジネスポートフォリオと1人のユーザーに対して一意です。同一人物であっても、やり取りするビジネスポートフォリオごとに異なるBSUIDが割り当てられるため、無関係なポートフォリオ間で顧客を照合するために使用することはできません。
• 安定性。ユーザーが電話番号を変更すると、BSUIDは再生成されます。その際、Metaはタイプがuser_changed_user_idのシステムメッセージWebhookと、別途user_id_update Webhookを送信します。
• 親BSUID。複数のポートフォリオを持つ管理ビジネスは、Metaの担当者に親BSUIDへの登録を依頼できます。これにはENT（例：US.ENT.11815799212886844830）が含まれ、登録されたすべてのポートフォリオに適用されます。

なぜWhatsAppはユーザーネームを導入するのですか？

プライバシー保護のため。Metaは2026年6月29日、ユーザーが「年内」にユーザー名を予約できること、およびユーザーがユーザー名を有効にすると、初めてメッセージを送信する相手（個人または法人）に電話番号が表示されなくなることを発表しました (About Meta)。Metaの開発者向けドキュメントによると、ユーザー名は2026年に段階的に導入される予定です。

法人もユーザーネームを持つことができます。2026年6月29日より、法人はWhatsApp Manager、Meta Business Suite、またはUsername APIを通じて、WhatsAppが自社用に予約したユーザーネームを取得できます。承認されたユーザーネームは、機能のリリース時に有効になります。なお、法人用ユーザーネームを使用しても、法人の電話番号は非表示になりません。

タイムラインはどうなっていますか？

顧客の電話番号は失われますか？

場合によってはあります。すべてのメッセージWebhookにはBSUIDが表示されます。電話番号（wa_id、およびインバウンドメッセージの送信元）は、Metaに基づき、以下のいずれかが満たされている場合にのみ含まれます：

• Webhookがトリガーされる前の30日以内に、ユーザーの電話番号にメッセージを送信または電話をかけた場合
• その30日以内に、ユーザーの電話番号からメッセージまたは電話を受信した場合、または
• ユーザーが連絡先に登録されている場合

30日間のルックバックはビジネス電話番号ごとに評価されるため、営業ラインで認識されている顧客がサポートラインでは認識されない場合があります。コンタクトブックは、初回インタラクション後の電話番号とBSUIDを保存するMetaホスト機能です。これにより、ユーザーがユーザーネームを採用した後でも、後続のWebhookで電話番号を引き継ぐことができます。この機能はデフォルトでオンになっており、Meta Business Suiteの「ビジネス設定」＞「ビジネス情報」からオフに切り替えることが可能です。特別な理由がない限り、オンのままにしておくことを推奨します。

引き続き電話番号が必要なものは何ですか？

Metaの規定は明確です。BSUIDは「ユーザーの電話番号を必要とするワンタップ、ゼロタップ、およびコードコピー認証テンプレートを除く、あらゆる種類のメッセージの送信に使用できます」。WhatsApp以外でも、モバイルネットワーク上で動作するものはすべて電話番号が必要となります。

Webhookの変更前と変更後では、どのような形式になりますか？

BSUIDの導入前、messages Webhookのcontactsブロックでは、電話番号がwa_idに格納されており、ほとんどの連携においてそれが顧客キーとして使用されていました。Metaによる新しいcontactsオブジェクトの例では、ユーザー名、BSUID、および（有効な場合は）親のBSUIDが追加されています。wa_idは、番号の共有が可能な場合にのみ含まれます。

1"contacts": [
2  {
3    "profile": {
4      "name": "<USER_DISPLAY_NAME>",
5      "username": "<USERNAME>"
6    },
7    "wa_id": "<USER_PHONE_NUMBER>",
8    "user_id": "<BSUID>",
9    "parent_user_id": "<PARENT_BSUID>"
10  }
11]

受信メッセージにもfrom_user_id（および有効な場合はfrom_parent_user_id）が含まれ、status Webhookにはrecipient_user_idが含まれます。Metaによれば、これは常にユーザーのBSUIDに設定されます。送信する場合は、新しいrecipientパラメータにBSUIDを指定してください。toパラメータ（電話番号）、recipientパラメータ（BSUID）、またはその両方を設定できます。両方が存在する場合、電話番号が優先されます。

1{
2  "messaging_product": "whatsapp",
3  "recipient_type": "individual",
4  "recipient": "<BSUID>",
5  "type": "text",
6  "text": {
7    "body": "<BODY_TEXT>"
8  }
9}

送信レスポンスのcontacts配列にはuser_idが含まれるようになり、wa_idはオプションとなります。パーサーがwa_idが常に存在することを前提としている場合、最初のユーザー名ユーザーでエラーが発生します。実際のペイロードを当社のwebhook payload inspectorに貼り付けて、連携において実際にどのフィールドを受信するかを確認できます。

OTPにおいて、何が機能しなくなりますか？

ワンタップ、ゼロタップ、またはコードコピーボタンを備えた認証テンプレートは、BSUID宛に送信することはできません。ユーザーネームを使うユーザーがWhatsAppを通じて連絡してきた際にその電話番号を把握していない場合、そのようなタイプのWhatsApp OTPを送信することはできません。これにより、認証フローに2つの影響が生じます。

• サインアップ時に、E.164形式で電話番号を収集・検証し、アカウントの認証用アドレスとして保存してください。後でWhatsApp Webhookから電話番号が渡されることを前提にしないでください。E.164とはを参照してください。
• 電話番号自体で動作するチャネルを維持してください。SMS OTP、音声OTP、およびサイレントネットワークチェックはすべて電話番号に基づいて実行されるため、自動フォールバックを備えたマルチチャネル設計であれば、この変更による影響を受けません。当社のマルチチャネルOTPガイドおよびBroadNet OTP製品で、このパターンについて説明しています。

CRMと顧客の重複排除において、何が機能しなくなりますか？

多くのCRMでは、SMS、音声、WhatsAppがかつて共通して電話番号を使用していたため、電話番号をWhatsAppの連絡先キーとしています。ユーザー名の導入後、BSUIDのみを持つ新しいインバウンドの連絡先が届く可能性があります。そのために新しいCRMレコードを作成すると、徐々に顧客の重複が発生します。データをクリーンに保つための4つのルールは以下の通りです：

1. 1BSUIDを顧客IDではなく、チャネル識別子として定義してください。1人の顧客が複数のBSUID（ビジネスポートフォリオごとに1つ）を持つことがあり、電話番号変更後には新しいBSUIDが付与される場合もあります。
2. 2BSUID、ポートフォリオ、判明している電話番号、初回検知日、最終検知日のマッピングテーブルを保持し、user_id_updateを含むすべてのWebhookが発生するたびに更新してください。
3. 3推測ではなく、確実な証拠に基づいて統合してください：検証済みの電話番号、ログイン、またはチャット内で顧客が提示した注文リファレンスなど。
4. 4wa_idが欠落していることを、新しい顧客として扱わないでください。それは単に、そのイベントにおいて番号を共有できないことを意味するに過ぎません。

移行の方法は？ステップバイステップのチェックリスト

1. 1Webhookパーサーを更新して、user_id、from_user_id、recipient_user_id、およびusernameを読み取るようにし、wa_idとfromをオプションとして扱うように設定してください。
2. 2WhatsAppの連絡先を保存しているすべての場所に、BSUIDカラム（マネージドビジネスの場合は親のBSUIDも含む）を追加してください。
3. 3バックフィル：2026年4月初旬以降のすべてのインバウンドイベントに対して、BSUIDを既にお持ちの電話番号に紐付けてください。
4. 4user_changed_user_idシステムメッセージおよびuser_id_updateウェブフックを処理し、新しいBSUIDを顧客に再紐付けしてください。
5. 5送信パスに受信者パラメータを追加し、電話番号がない場合はそのパラメータにフォールバックしてください。
6. 6OTPは電話番号にルーティングし、決してBSUIDにルーティングしないでください。また、フォールバックチャネルとしてSMSまたは音声通話を維持してください。
7. 7WhatsApp Manager、Meta Business Suite、またはUsername APIを通じて、ビジネスユーザー名を予約してください。
8. 8ユーザー名が顧客に届く前に、ユーザー名が有効化されたアカウントでテストを行ってください。

BroadNetがお客様のWhatsAppプロバイダーである場合は、本番コードを変更する前に、テストアクセスを申し込み、お客様のアカウントのWebhookにBSUIDフィールドがどのように表示されるかを確認してください。詳細は、当社のデベロッパーハブおよびWhatsApp Business APIページに記載されています。また、オムニチャネルルーティングにより、現在の認証フローが依存しているSMSフォールバックに対応しています。

よくある質問

WhatsApp BSUIDとは何ですか？

ビジネススコープのユーザーIDです。Metaが各ビジネスポートフォリオのWhatsAppユーザーごとに割り当てる識別子であり、これにより企業はユーザーの電話番号を知ることなくメッセージを送信できます。Webhookではuser_idとして表示されます。

BSUIDはどのような形式ですか？

ISO 3166アルファ2国コード、ピリオド、その後に最大128文字の英数字が続きます（例：US.13491208655302741918）。管理対象ビジネスの親BSUIDにはENTが含まれます（例：US.ENT.11815799212886844830）。

ユーザーがユーザーネームを設定した場合、顧客の電話番号は失われますか？

一部のWebhookのみ該当します。過去30日間にその番号でメッセージのやり取りや通話を行っている場合、またはユーザーが連絡先に登録されている場合は、引き続き番号が含まれます。それ以外の場合はwa_idは省略され、BSUIDのみが受信されます。

BSUIDにメッセージを送信することはできますか？

はい、2026年7月以降、send APIの受信者パラメータを使用することで可能です。ワンタップ、ゼロタップ、およびコピーコード認証テンプレートを除くすべてのメッセージタイプが利用できます。これらのテンプレートにはユーザーの電話番号が必要です。

BSUIDに対して認証（OTP）テンプレートを送信できますか？

いいえ。ワンタップ、ゼロタップ、およびコピーコード認証テンプレートには電話番号が必要です。各アカウントに認証済みの電話番号を保持し、フォールバックとしてSMSまたは音声OTPを使用してください。

BSUIDはビジネスポートフォリオ間で共通して使用できますか？

いいえ。BSUIDは、1つのビジネスポートフォリオとユーザーのペアに対して一意に割り当てられます。管理対象のビジネスは、一緒に登録されているポートフォリオ間で機能する親BSUIDについてMetaに問い合わせることができます。

BSUIDが変更されることはありますか？

はい。ユーザーが電話番号を変更すると再生成されます。その際、Metaはuser_changed_user_idシステムメッセージとuser_id_updateウェブフックによってこれを通知します。

ビジネスユーザーネームを予約するにはどうすればよいですか？

2026年6月29日より、WhatsApp Manager、Meta Business Suite、またはユーザーネームAPIを通じてご利用いただけます。承認されたユーザーネームは、ユーザーネーム機能の開始とともに有効になり、ビジネス電話番号が非表示になることはありません。

出典

• Meta for Developers、「Business-scoped user IDs」（形式、タイムライン、Webhookフィールド、連絡先、送信パラメータ、認証テンプレートの例外）、2026年9月26日閲覧。
• Metaについて、WhatsAppユーザーネームを予約する時期が来ました、2026年6月29日、2026年9月26日閲覧。