こんにちは。
2026 年後半、WhatsApp ではユーザー名機能が導入されます。この変更により、メッセージ Webhook 内でのユーザー アイデンティティの表示方法が変わり、既存のユーザー識別子の保存およびマッピングに関するロジックに影響を与える可能性があります。当社プラットフォームでは完全な互換性を確保するための更新を実施しています。統合が完了次第、詳細な移行ガイドを含む別の通知を公開する予定です。今後のアナウンスにご注意ください。
ユーザー名機能は、個人ユーザーおよびビジネスのいずれにとってもオプションです。WhatsApp ユーザーがこの機能を有効にすると、アプリ内に電話番号の代わりにユーザー名が表示されます。ただし、ビジネスの場合、ユーザー名はプライバシー保護の目的を果たしません。ビジネスアカウントでユーザー名を有効にしても、アプリ内でビジネスの電話番号が非表示になることはありません。
以下のセクションは、Meta 社によるこの機能の公式説明に基づいています。詳細については、「ビジネススコープユーザー ID」をご参照ください。
ユーザー名
ユーザー名とは、WhatsApp ユーザーが電話番号の代わりにアプリ内に表示するために設定できる、一意かつ任意の名前です。特定のユーザー向けにメッセージ本文をパーソナライズする際には、プロファイル名の代わりにユーザー名を使用できます。
WhatsApp ユーザーは一度に 1 つのユーザー名しか持てませんが、定期的に変更可能です。ユーザー名を変更しても、ユーザーの電話番号やビジネススコープユーザー ID (BSUID) には影響せず、WhatsApp Business Platform 上で他のユーザーまたはビジネスと通信する能力にも影響しません。
ユーザー名は、API 応答および Webhook ペイロード内の username プロパティに割り当てられます。有効化後、ユーザーのユーザー名はすべての受信メッセージ Webhook およびすべての配信ステータス・読み取りステータス Webhook に表示されます。
ビジネススコープユーザー ID (BSUID)
BSUID は、電話番号を知らない状態でも WhatsApp ユーザーにメッセージを送信できるようにする一意のユーザー識別子です。BSUID は user_id パラメーターに割り当てられ、ユーザーがユーザー名を有効にしているかどうかに関係なく、すべてのメッセージ Webhook に表示されます。
BSUID は単一のビジネスポートフォリオ内でのみ有効です。つまり、同一ポートフォリオにスコープされた BSUID に対しては、そのポートフォリオ内の任意のビジネス電話番号からメッセージを送信できます。異なるビジネスポートフォリオに属するビジネス電話番号からその BSUID へメッセージを送信しようとすると失敗します。
BSUID には以下の特徴があります。
システムによって自動生成されます。
ユーザーの 2 文字の ISO 3166 alpha-2 国別コードとピリオドで始まり、その後に最大 128 文字の英数字が続きます（例：
US.13491208655302741918）。特定のビジネスポートフォリオ内で各ユーザーに一意です。ビジネスポートフォリオは以前「Business Manager」と呼ばれていました。
ユーザーが電話番号を変更すると再生成され、その際にシステムステータスメッセージ Webhook がトリガーされます。
BSUID を使用して、ワンタップ認証テンプレート、ゼロタップ認証テンプレート、およびコピー コード認証テンプレートを除くすべてのメッセージタイプを送信できます。認証テンプレートには引き続き電話番号が必要です。
BSUID を使用して API リクエストを行う際には、国別コード、ピリオド、およびすべての英数字を含めた完全な値を使用する必要があります。この値の一部を省略または変更すると、リクエストは失敗します。ビジネスに複数のビジネスポートフォリオがあり、すべてのポートフォリオで共通に使用できる BSUID が必要な場合は、「親 BSUID」をご確認ください。
親 BSUID
ビジネスで複数のビジネスポートフォリオを使用している場合、Meta 社のビジネス担当者に連絡するか、サポートチケットを起票して、資格要件を確認してください。必要な資料を提出し、申請が承認され、ビジネスポートフォリオがリンクされると、親 BSUID がすべてのメッセージ Webhook に含まれ、新しい parent_user_id プロパティに割り当てられます。
親 BSUID は通常の BSUID の代わりとしてユーザーへのメッセージ送信に使用できます。機能的には通常の BSUID と同じ特性を持ちますが、リンクされたポートフォリオ内の任意のビジネス電話番号から使用可能です。
引き続き、ご利用のビジネスポートフォリオにスコープされた通常の BSUID を使用してユーザーにメッセージを送信することもできます。
電話番号
WhatsApp ユーザーがユーザー名機能を有効にした場合、以下に記載する事前のやり取りがない限り、Webhook に電話番号は含まれません。そのため、ユーザーの BSUID は通常電話番号が含まれる Webhook に代わりに含まれ、ユーザーがユーザー名を有効にしているかどうかに関係なく、新しい user_id プロパティに割り当てられます。
ユーザー名を有効にした既存ユーザーとの会話コンテキストが失われるリスクを軽減するため、以下のいずれかの条件を満たす場合、Webhook にユーザーの電話番号が含まれます。
Webhook がトリガーされる30日以内に、ユーザーの電話番号にメッセージを送信したか、呼び出しを開始しました。
Webhook がトリガーされる 30 日以内に、ユーザーの電話番号からメッセージまたは通話を受信したことがある。
ユーザーがご利用の WhatsApp 連絡先に登録されている。
ご利用の連絡先にユーザーが登録されている。
2026 年 3 月 31 日より、BSUID が Meta 社からの Webhook に表示され始めます。ただし、Meta API が BSUID 宛ての直接メッセージ送信をサポートするのは 2026 年 5 月（正確な日付は未定）以降となります。Meta API が 5 月に BSUID サポートを追加した後は、ユーザーの BSUID、電話番号、またはその両方を使用してメッセージを送信できます。
ユーザーの電話番号のリクエスト
WhatsApp ユーザーから電話番号をリクエストするには、ユーティリティテンプレートおよびマーケティングテンプレートに新しい REQUEST_CONTACT_INFO ボタンタイプを追加できます。
ユーザーがこのボタンをタップすると、vCard および WhatsApp 電話番号がメッセージスレッド内で共有されます。この操作により、ユーザーの電話番号および vCard を含む連絡先 Webhook がトリガーされます。
ローカル記憶域を無効にして連絡先機能を使用している場合、ユーザーの電話番号は自動的に連絡先に追加されます。ローカル記憶域を有効にしている場合は、ユーザーが情報を共有した後にその電話番号宛てにメッセージを送信することで、電話番号および BSUID が連絡先に追加されます。
連絡先
2026 年 4 月初旬、会話の継続性をサポートするため、Meta 社は WhatsApp ユーザーの連絡先情報を保存するための連絡先機能を導入します。
このデータが記録されると、ユーザーがユーザー名を有効にしているかどうかに関係なく、そのユーザーに関するすべての Webhook ペイロードおよび API 応答に反映されます。
連絡先データは、機能を無効にするかアカウントを停止するまで保持されます。2026 年 3 月 16 日以降、いつでも Meta Business Suite > ビジネス設定 > ビジネス情報 に移動してこの機能を無効化できます。無効化すると、連絡先機能によるユーザー情報の保存が停止され、保存済みのすべての情報が削除されます。後で再度有効化した場合、ユーザー情報の保存は再開されますが、以前に保存されていた情報は復旧できません。
制限事項：
ユーザーが情報を共有した後に電話番号宛てにメッセージを送信して、連絡先に電話番号および BSUID を記録する必要があります。
連絡先機能は単一のビジネスポートフォリオにスコープされます。複数のリンク済みポートフォリオがある場合、ユーザーの電話番号および BSUID は各ポートフォリオの連絡先に個別に記録する必要があります。ユーザーの連絡先情報は、リンク済みのビジネスポートフォリオ間で共有または同期されません。
国別コード
WhatsApp ユーザーがユーザー名を有効にした場合、電話番号（およびその国番号）が Webhook に表示されない可能性があります。この場合、ユーザーの BSUID はユーザーの 2 文字の ISO 3166 alpha-2 国別コードで始まります（例：US.13491208655302741918）。
ビジネスユーザー名
ビジネスもビジネスユーザー名を有効にできます。この機能を有効にしても、WhatsApp または WhatsApp Business アプリ内でビジネスの電話番号が非表示になることはありません。
WhatsApp エコシステム全体において、ビジネスユーザー名は単一のビジネス電話番号に紐付けられます。つまり、1 つの電話番号につき同時に 1 つのユーザー名しか持てず、消費者用またはビジネス用を問わず、2 つの WhatsApp 電話番号が同じユーザー名を持つことはできません。
ビジネスユーザー名は以下のフォーマットルールに従う必要があります。
英数字（a～z、0～9）、ピリオド（.）、アンダースコア（_）のみを使用可能。
長さは 3～35 文字であること。
少なくとも 1 文字以上の英字（a～z、A～Z）を含むこと。
ピリオドで始まったり終わったりしてはならず、連続する 2 つのピリオドを含んではならない。
wwwで始まってはならない。ドメイン拡張子（例：.com、.org、.net、.int、.edu、.gov、.mil、.us、.in、.html）で終わってはならない。
ユーザー名は大文字小文字を区別しませんが、ピリオドおよびアンダースコアは区別されます。たとえば、
myIDとmyidは同一のユーザー名と見なされますが、myid、my.id、my_idは異なるユーザー名と見なされます。
予約済みユーザー名
ユーザー名機能が正式に利用可能になる前に、WhatsApp が予約済みのユーザー名を取得できます。または、ブランドに合った別のユーザー名を選択することも可能です。WhatsApp Manager または Meta Business Suite で予約済みユーザー名を取得できます。ユーザー名機能が利用可能になった後、承認済みの取得済みユーザー名がアクティブなアカウントになります。
予約済みユーザー名がすでにご利用の Facebook ページまたは Instagram アカウントで使用中の場合、そのユーザー名を取得する前にビジネス電話番号を該当ページまたはアカウントにリンクする必要があります。
Meta Business Suite または WhatsApp Manager で取得時に電話番号をリンクすることもできますし、Facebook ページまたは Instagram アカウントにアクセスして電話番号を直接追加することもできます。
電話番号をリンクするには、該当ページまたはアカウントに対する完全制御権、または manage_phone 権限を持つ部分的アクセス権が必要です。アクセスレベルおよび権限の詳細については、「ビジネスポートフォリオおよびビジネス資産の権限の概要」をご参照ください。
チャット内の表示優先度
チャットスレッド内でビジネスプロファイルを表示する際、WhatsApp は以下の表示名の優先度（降順）を使用します。ビジネス電話番号は常にビジネスプロファイルページに表示されます。
保存済みの連絡先名。
認証済みビジネス名または公式ビジネスアカウント (OBA) 名。
ビジネスユーザー名。
電話番号。