WhatsAppのユーザー名とBSUIDについて

WhatsAppのユーザー名とは何ですか？

WhatsAppのユーザー名は、オプションの一意の識別子であり、アプリ内で電話番号の代わりに表示するために、以下のいずれかが設定できます。WhatsAppユーザー（WhatsAppコンシューマーアプリにログインしているユーザー）または企業（WhatsApp BusinessアプリまたはWhatsApp Business APIプラットフォームにログインしている企業）です。ユーザー名の仕組みは、Facebook MessengerやInstagramのハンドル名と同様です。

ここでは、2つの異なるアクターとユースケースがあります：

俳優 なぜユーザー名を選ぶのか 電話番号の表示への影響
WhatsAppユーザー（WhatsAppコンシューマーアプリにログインしているユーザー） プライバシー：企業や他のユーザーに自分の電話番号を知られないようにするため Webhook では、電話番号は企業には非表示になります（特定の条件を満たす場合を除く）。
ビジネス（WhatsApp BusinessアプリまたはWhatsApp Business API Platformにログインしている場合） ブランディング：ユーザーが自社を見つけやすく、認識しやすくするため 電話番号は非表示になっていません。ユーザー名は単なる追加の識別子にすぎません。

ユーザー名は電話番号の上に追加された機能であり、その代わりになるものではありません。WhatsApp Accountを作成するには、依然として電話番号が必要です。

BSUIDとは何ですか？

ビジネススコープのユーザーID（BSUID）とは、Metaが各WhatsAppユーザーに割り当てる一意の識別子であり、特定のビジネスポートフォリオに紐付けられています。これは、ユーザーの電話番号が不明な場合に、そのユーザーを特定してメッセージを送信するための主要な手段です。

BSUIDの主な特性：

  • 形式：ISO 3166 アルファ-2 国コードのプレフィックスに、ピリオドを挟んで最大 128 文字の英数字が続く形式。例：US.13491208655302741918
  • 適用範囲：ビジネスポートフォリオとユーザーの組み合わせごとに一意です。あるポートフォリオの BSUID を、別のポートフォリオが所有する電話番号と組み合わせて使用することはできません。
  • 利用状況：WhatsAppユーザー（一般ユーザー）には常に表示されます。企業の場合、導入していない限り常に表示されるとは限りません。また、ユーザー名やBSUIDにかかわらず、企業の電話番号は常に表示されます。
  • 再生成：ユーザーが電話番号を変更した場合、BSUIDが再生成されます。
  • 制限事項：BSUID を使用して、ワンタップ認証、ゼロタップ認証、またはコードコピー認証のテンプレートを送信することはできません。これらのメッセージタイプには電話番号が必要です。

「親BSUID」とは何ですか？

親BSUIDとは、複数のMetaビジネスポートフォリオがリンクされている管理対象企業向けに提供される、BSUIDの特別なバリエーションです。これにより、登録済みのすべてのポートフォリオで単一の識別子を使用することが可能になります。

  • 形式： {COUNTRY_CODE}.ENT.{ALPHANUMERIC_ID} — 例えば、 US.ENT.11815799212886844830
  • 利用条件：Metaの親BSUID Accountに登録されている企業のみが対象です。利用資格については、MetaまたはVonageの担当者にお問い合わせください。
  • 適用範囲：登録済みのすべてのポートフォリオで機能します。通常のBSUIDは、親BSUIDと並行して引き続き機能します。

BSUIDと電話番号、それぞれいつ受け取れるのでしょうか？

以下の表は、ユーザーの種類ごとに、Vonage からどの識別子が確認できるかをまとめたものです：

ユーザーの種類 電話番号は表示されていますか？ BSUIDは表示されていますか？ ユーザー名は表示されますか？
ユーザー名のないユーザー はい はい（常に） いいえ
ユーザー名「adopted」のユーザー 条件付きで（下記参照） はい（常に） はい
ユーザー名のない取引 はい いいえ いいえ
ユーザー名を用いた取引が採用された はい いいえ はい（ブランディングのみ）

ユーザー名として電話番号を採用しているユーザーの場合、電話番号はいつまで表示されるのでしょうか？

Metaは、以下の条件のいずれかが満たされる場合（ビジネス電話番号ごとに評価されます）、Webhookにユーザーの電話番号を含めます：

  • 過去30日以内に、そのユーザーの電話番号にメッセージを送信したり、電話をかけたりしています
  • 過去30日以内に、そのユーザーの電話番号からメッセージまたは電話を受け取っています
  • そのユーザーはあなたの連絡先リストに登録されています

これらの条件のいずれも満たされない場合、 wa_id このフィールドは、Webhookのペイロードから除外されます。 from このフィールドには、電話番号の代わりにBSUIDが入力されます。

連絡先帳

Metaは、連絡先帳機能（2026年4月上旬より利用可能）を提供しています。この機能では、ユーザーの電話番号とBSUIDを、その電話番号との間でメッセージの送受信や通話をした際に自動的に保存します。一度保存されると、ユーザーがユーザー名を採用しているかどうかに関わらず、その電話番号は引き続きWebhookのペイロードに表示されます。

連絡先リストはビジネスポートフォリオレベルで利用可能であり、Metaによってホストされています。Metaによってデフォルトで有効化されているため、有効化するための統合作業は不要です。いつでも以下の場所で無効化できます。 Meta Business Suite > ビジネス設定 > ビジネス情報.

新しいエラーコード

BSUIDを受信者としてサポートしていないメッセージタイプを送信しようとすると、新しいエラーコードが返されます：

エラーコード 詳細
131062 このメッセージでは、ビジネススコープのユーザー ID (BSUID) の受信者はサポートされていません。

詳細情報

WhatsAppのユーザー名とBSUIDの取り扱い