WhatsAppユーザー名とビジネススコープユーザーID

WhatsAppユーザー名は、ビジネスとのメッセージングにおいてユーザーの電話番号を非表示にするオプションのプライバシー機能です。Brazeはこれを自動的に処理するため、ほとんどのお客様にとってキャンペーンやキャンバスを変更する必要はありません。

WhatsAppユーザーがユーザー名を採用すると、メッセージを送信するビジネスに電話番号が自動的に共有されなくなります。代わりに、WhatsAppはビジネスにビジネススコープユーザーID（BSUID）を提供します。これは、各ビジネスポートフォリオとユーザーのペアに固有のユニークな識別子です。

BrazeはBSUIDを自動的に処理します。ユーザー名を採用したユーザーは、引き続きBrazeワークスペースに表示され、メッセージを受信し、キャンバスをトリガーし、イベントを生成します。一部のお客様は変更に備える必要がある場合があります。

ビジネススコープのユーザーID（BSUID）

BSUIDは、特定のビジネスポートフォリオ内でユーザーを表すためにWhatsAppが割り当てる一意で永続的な識別子です。電話番号を非公開にしたいユーザーのための代替電話番号と考えてください。

BSUIDには3つの主要な特性があります。

WhatsAppユーザータイプの変更

WhatsAppユーザーには2つのタイプがあります。

重要な違いは、ユーザー名を採用したユーザーは、以前にそのビジネスと会話したことがある場合、またはWhatsApp連絡先帳に登録されている場合にのみ、電話番号がビジネスに共有されるという点です。

BrazeにおけるBSUIDの処理方法

Brazeは、BSUIDをユーザープロファイル上のwhats_app_bsuidというラベルが付いたユーザーエイリアスとして保存します。つまり、BSUIDのみのユーザーも完全なBrazeユーザープロファイルを持ち、キャンバスへのエントリ、メッセージの受信、イベントの生成、APIを通じた更新が可能です。

メッセージの送信

BrazeがWhatsAppメッセージを送信する際、利用可能な場合は電話番号を使用します。ユーザーがBSUIDのみを持っている場合（ユーザー名を採用した後に初めてメッセージを送信してきたユーザーなど）、BrazeはBSUIDを使用して送信します。メッセージテンプレート、キャンペーン、またはキャンバスステップの変更は必要ありません。

受信メッセージとキャンバストリガー

ユーザー名を持つユーザーがWhatsAppで受信メッセージを送信すると、Brazeは以下の処理を行います。

1. BSUIDまたは電話番号（Webhookで利用可能な方）でユーザーを検索します。
2. 一致するユーザーが見つからない場合、BSUIDをユーザーエイリアスとして保存した新しい匿名ユーザープロファイルを作成します。
3. 受信WhatsAppメッセージで開始するように設定されたキャンバスまたはキャンペーンをトリガーします。

ユーザープロファイル

ユーザーのBSUIDは、BrazeユーザープロファイルのWhatsAppセクションで確認できます。

購読グループ

購読グループの管理は、BSUIDユーザーに対しても、ユーザーエイリアスで識別される他のユーザーと同じように機能します。BSUIDユーザーの購読ステータスは、以下の方法で更新できます。

• user_aliasを使用したusers/trackエンドポイント
• ユーザー更新キャンバスステップ（自動的に機能します）
• CSVアップロード

注

subscription/status/setエンドポイントはuser_aliasをサポートしていません。BSUIDのみのユーザーの購読ステータスを更新するには、users/trackエンドポイントを使用してください。

Currentsとイベントデータ

すべてのWhatsApp Currentsイベント（送信、配信、既読、失敗、受信、中止、リトライ）にはBSUIDフィールドが含まれます。電話番号とBSUIDの両方を持つユーザーの場合、両方のフィールドが含まれます。BSUIDのみを持つユーザーの場合、BSUIDフィールドのみが含まれます（電話番号フィールドは空になります）。

変更に備える方法

ほとんどの顧客の場合、対応は不要です。Brazeは BSUID のルーティング、ユーザー作成、イベントトラッキングを自動的に処理します。ただし、WhatsApp連絡先帳の有効化と、複数のWhatsApp Businessアカウント（WABA）を使用している場合はビジネスポートフォリオのリンクをお勧めします。

WhatsApp連絡先帳を有効にする

連絡先帳は、すでにやり取りしたユーザーの電話番号を記録するMetaの機能です。ユーザーがユーザー名を採用すると、連絡先帳に表示されている場合、そのユーザーの電話番号はビジネスに引き続き表示されます。これにより、ユーザーがユーザー名を有効にした後でも、Brazeは電話番号でユーザーを識別し続けることができます。

連絡先帳を有効にするには：

1. Meta Business Suite > ビジネス設定 > ビジネス情報に移動します。
2. 連絡先帳機能が有効になっていることを確認します。

ヒント

連絡先帳機能はデフォルトで有効になっていますが、Meta Businessの設定で確認することをお勧めします。連絡先帳が無効になっている場合、ユーザー名を採用したユーザーは、以前メッセージを送信したことがあっても、新しい BSUID のみのユーザーとして表示されます。

複数のWABAを使用している場合はビジネスポートフォリオをリンクする

BSUIDは単一のビジネスポートフォリオにスコープされます。組織が同じBrazeワークスペース内で複数のビジネスポートフォリオからWABAを管理している場合、同じユーザーがポートフォリオごとに異なるBSUIDを持つことになります。これにより、Brazeのユーザープロファイルが重複する可能性があります。

これを防ぐには、Metaの担当者に連絡して、ビジネスがポートフォリオをリンクする資格があるかどうかを確認してください。詳細については、ビジネスポートフォリオと親BSUIDのリンクを参照してください。

WABAがすべて同じビジネスポートフォリオ内にある場合、対応は不要です。

ビジネスポートフォリオと親BSUIDのリンク

組織が複数のWhatsApp Businessアカウント（WABA）を異なるビジネスポートフォリオで運用している場合、Metaの担当者にそれらのポートフォリオをリンクする資格があるかどうかを確認するよう依頼できます。資格はMetaが判断し、管理対象のビジネスが利用できます。

リンクされたポートフォリオの動作

ビジネスポートフォリオがリンクされると、WhatsAppはすべてのメッセージwebhookに通常のBSUIDとともに親BSUIDを含めます。親BSUIDはwebhookペイロードの新しいparent_user_idプロパティに割り当てられます。

親BSUIDは通常のBSUIDと同じプロパティを持ちますが、リンクされたポートフォリオのセット内のすべてのビジネス電話番号で共有されます。つまり、同じユーザーはメッセージを送信するWABAに関係なく、一貫した単一の識別子を持つことができ、ユーザープロファイルの重複リスクを回避できます。

親BSUIDには、国コードと英数字の識別子の間にENTが含まれます。例：

1

US.ENT.11815799212886844830

通常のBSUIDにはENTは含まれません。

Brazeが親BSUIDを使用する方法

webhookに通常のBSUIDと親BSUIDの両方が含まれている場合、Brazeは親BSUIDをプライマリ識別子として使用します。これにより、リンクされたポートフォリオ内の複数のWABAにメッセージを送信するユーザーが、同じBrazeユーザープロファイルに一貫してマッチングされます。

親BSUIDが存在しない場合（例えば、ポートフォリオがリンクされていない場合や、ユーザーがリンクされていないWABAにメッセージを送信している場合）、Brazeは通常のBSUIDを使用します。通常のBSUIDはすべてのケースで正常に機能し続けます。

注

ビジネスポートフォリオのリンクプロセスはMetaが管理しています。開始するには、Metaの担当者にお問い合わせください。ポートフォリオがリンクされている場合でも、通常のBSUIDを使用してユーザーにメッセージを送信できます。親BSUIDは追加的なものであり、代替ではありません。

よくある質問

既存のキャンペーンやキャンバスに影響はありますか？

いいえ。既存のキャンペーンやキャンバスは引き続き動作します。ユーザーネームを採用していないユーザーには一切影響がありません。ユーザーネームを採用し、ビジネスとの既存の会話履歴があるユーザーについては、Brazeは引き続き電話番号をプライマリ識別子として使用します。

ユーザーネームを採用したユーザーが、すでにビジネスにメッセージを送信していた場合はどうなりますか？

WhatsAppコンタクトブックが有効で、過去30日以内にそのユーザーとの会話（またはメッセージの送信）があった場合、Webhookペイロードには電話番号がBSUIDとともに引き続き表示されます。Brazeはそのユーザーを既存のユーザープロファイルに照合します。重複プロファイルは作成されません。

ユーザーネームを採用したユーザーが、ビジネスとの過去の会話がない場合はどうなりますか？

BrazeはインバウンドwebhookでユーザーのBSUIDを受信し、既存のユーザープロファイルに照合するか（BSUIDを以前に保存していた場合）、BSUIDをユーザーエイリアスとして保存した新しい匿名ユーザープロファイルを作成します。そのユーザーはキャンバスに入り、アウトバウンドメッセージを受信し、Brazeの標準的なアイデンティティ解決ツールを使用して他のプロファイルと識別またはマージできます。

BSUIDユーザーをセグメントでターゲットできますか？

BSUIDユーザーは完全なBrazeユーザープロファイルであるため、標準的なオーディエンスフィルター（「WhatsAppメッセージを受信した」や購読グループのメンバーシップなど）を通じてターゲットできます。ただし、BSUID値に基づく特定のセグメンテーション（「BSUIDが存在する」や「BSUIDがXと等しい」など）はサポートされていません。

BSUIDユーザーのWhatsApp料金はどのように決まりますか？

WhatsAppの会話料金はユーザーの国によって決まります。電話番号で識別されるユーザーの場合、Metaは電話番号の国コードから国を判定します。BSUIDで識別されるユーザーの場合、国はBSUID自体に直接エンコードされています。たとえば、USで始まるBSUIDはアメリカのユーザーを表します。

これは、ユーザーが電話番号またはBSUIDのどちらで識別されていても、料金の動作が一貫していることを意味します。会話レートの計算に使用される国はMetaが提供する識別子によって決定され、Brazeはこれを変更せずにそのまま渡します。特別な対応は必要ありませんが、BSUIDのみのユーザーにメッセージを送信する場合、Metaの国ベースの料金は電話番号ではなく、ユーザーのBSUIDにエンコードされた国に基づくことにご注意ください。

API呼び出しでBSUIDユーザーを参照するにはどうすればよいですか？

user_aliasパラメーターを使用し、alias_label: "whats_app_bsuid"とalias_nameにユーザーのBSUID値を設定します。例：

1
2
3
4
5
6

{
  "user_alias": {
    "alias_label": "whats_app_bsuid",
    "alias_name": "DDC91135R"
  }
}

これはusers/track、users/identify、CSVアップロード、およびUser Updateキャンバスステップで使用できます。

Currentsデータパイプラインに影響はありますか？

WhatsAppのCurrentsイベントには、既存の電話番号フィールドとともにbsuidフィールドが含まれます。BSUIDのみを持つユーザーの場合、電話番号フィールドは空になります。ダウンストリームのパイプラインが電話番号フィールドに厳密な要件を持っている場合、nullまたは空の値を処理できることを確認してください。

異なるビジネスポートフォリオにまたがる複数のWABAを持っています。同じユーザーがBrazeで2つの異なるプロファイルとして表示されますか？

ポートフォリオがリンクされていない場合、はい。同じWhatsAppユーザーはビジネスポートフォリオごとに異なるBSUIDを持ち、Brazeはそれぞれに別のプロファイルを作成します。

これを解決するには、Metaの担当者に連絡してポートフォリオリンクの対象かどうかを確認してください。リンクされると、Metaはすべてのポートフォリオで共有される親BSUIDを提供し、BrazeはこれをWABA全体でユーザーを一貫して識別するために使用します。詳細については、ビジネスポートフォリオと親BSUIDのリンクを参照してください。

コンタクトブックを無効にできますか？

コンタクトブックを有効のままにすることを強くお勧めします。コンタクトブックを無効にすると、ユーザーの過去の電話番号レコードがすべて失われます。ユーザーネームを採用したユーザーは、以前にメッセージを送信していたとしても、新しいBSUIDのみのユーザーとして表示されます。

その他のリソース

• WhatsAppの設定
• ユーザーエイリアス
• WhatsApp購読グループ
• WhatsApp Currentsイベント
• Meta: Business-scoped user IDs