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

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

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

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

Business-scoped user 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エンドポイント
• User Updateキャンバスステップ（自動的に機能します）
• 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日以内にそのユーザーとの会話があった場合（またはメッセージを送信した場合）、電話番号はBSUIDとともにwebhookペイロードに引き続き表示されます。Brazeはそのユーザーを既存のユーザープロファイルに照合します。重複プロファイルは作成されません。

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

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

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: ビジネススコープのユーザー ID