WhatsApp BSUIDのみのユーザーに連絡先情報をリクエストする
電話番号が空白の WhatsApp BSUIDのみのインバウンドユーザーを検出し、連絡先情報の共有を依頼して、共有された電話番号を Brazeプロファイルに保存するワークフローを構築します。これにより、必要に応じて重複ユーザーをマージできます。
WhatsAppユーザーがユーザー名を使用し、過去の会話履歴がない状態でビジネスにメッセージを送信すると、Brazeは BSUIDを持ち電話番号のないプロファイルを作成またはマッチングする場合があります。連絡先情報をリクエストすると、そのプロファイルに電話番号を保存し、ワークスペースにそのユーザーがすでに存在するかどうかを確認して、必要に応じて重複ユーザーをマージできます。
要件
このワークフローを構築する前に、以下を確認してください。
| 要件 | 説明 |
|---|---|
| WhatsAppの設定 | WhatsApp Businessアカウントが Brazeに接続されており、購読グループでインバウンドメッセージを受信できること。WhatsAppの設定を参照してください。 |
| 連絡先リクエストのメッセージング | WhatsAppのメッセージ作成画面で連絡先情報のリクエスト応答レイアウトを選択するか、連絡先情報のリクエストテンプレートを作成または選択できること。 |
| インバウンド連絡先共有の Liquid | ユーザー更新ステップで {{whats_app.${contact_shared_phone_number}}} を使用できること。属性の詳細については、連絡先共有の電話番号を参照してください。 |
| マージ計画 | 共有された電話番号を既存のプロファイルとどのように照合するかの計画があること。重複ユーザーのマージを参照してください。 |
フローの仕組み
sequenceDiagram
participant User
participant Braze
User->>Braze: Inbound WhatsApp message (BSUID only)
Note over Braze: Entry audience: Phone Number is blank
Braze->>User: Request Contact Info response (Share Contact Info)
User->>Braze: Responded to contact info request
Braze->>Braze: User Update sets Phone Number from contact_shared_phone_number
Note over Braze: Optional: merge duplicate profiles
- ユーザーが WhatsAppのインバウンドメッセージを送信します。
- Brazeは、電話番号が空白の場合にのみユーザーをキャンバスにエントリさせます。つまり、インバウンドの送信者は電話番号が保存されていない BSUIDを使用しています。
- Brazeは、WhatsAppに組み込まれた連絡先情報を共有ボタンを含む連絡先情報のリクエスト応答メッセージで返信します。
- ユーザーが連絡先情報を共有すると、アクションパスステップが連絡先情報リクエストに応答したに一致します。
- ユーザー更新ステップが
{{whats_app.${contact_shared_phone_number}}}をプロファイルの電話番号属性に書き込みます。 - ステップ 5 で説明するように、そのプロファイルを同じ電話番号を使用する既存のプロファイルとマージします。

共有された番号は WhatsAppの連絡先共有レスポンスから取得されたものであり、Brazeによって独自に検証されたものではありません。アカウント復旧、不正チェック、ワンタイムパスコードなど、セキュリティ上重要なワークフローで信頼できる IDとして扱う前に、番号を検証してください。属性の詳細については、連絡先共有の電話番号を参照してください。
キャンバスを構築する
ステップ 1: アクションベースのキャンバスを作成する
- メッセージング > キャンバスに移動し、キャンバスを作成を選択します。
- キャンバスに名前を付けます (例: 「WhatsApp — BSUIDユーザーへの連絡先情報リクエスト」)。
- エントリスケジュールでアクションベースを選択します。
- アクションベースのオプションで、エントリトリガー WhatsAppインバウンドメッセージを送信を追加し、購読グループを選択します。
- 特定のキーワードでのみこのフローを開始したい場合を除き、一致する条件でなしを選択します。
- ターゲットオーディエンスに進みます。フィルターグループに電話番号が空白を追加します。
インバウンドの WhatsAppメッセージと空白の電話番号を組み合わせることで、BSUIDでメッセージを送信しており、まだ Brazeプロファイルに電話番号がないユーザーをターゲットにできます。

共有を断ったりスキップしたりしたユーザーに後で再度依頼したい場合にのみ、再エントリを許可してください。再エントリを許可する場合は、インバウンドメッセージのたびにユーザーへ依頼が表示されないよう、フォローアップの頻度に合わせた期間を設定してください。
ステップ 2: 連絡先情報のリクエスト応答メッセージを送信する
ユーザーはすでにビジネスにメッセージを送信しているため、24時間の会話ウィンドウが開いています。そのため、テンプレートではなく応答メッセージの使用をお勧めします。以下の手順でリクエストを送信します。
- メッセージステップを追加します。
- WhatsApp > 購読グループ > 応答メッセージを選択します。
- 連絡先情報のリクエストレイアウトを選択します。
- 電話番号を求める理由を説明する本文を作成します。
- たとえば、ユーザーがすでにアカウントを持っている可能性があり、連絡先情報を共有すると WhatsAppの会話をそのプロファイルに紐付けられることを説明します。
- 組み込みの連絡先情報を共有ボタンはそのまま残します。WhatsAppはユーザーの番号を一貫した形式で提供するため、手入力や書式の問題を減らせます。
他の応答メッセージと同様に、本文をパーソナライズしたり、コピーをローカライズしたりすることもできます。


自分から会話を開始する必要がある場合 (最近のインバウンドメッセージがない場合) は、代わりに Metaが承認した連絡先情報のリクエストテンプレートを使用してください。このテンプレートタイプは、マーケティングおよびユーティリティのカテゴリーで利用できます。このインバウンドの識別ユースケースでは、通常は応答メッセージのほうが適しています。コピーを変更する際に Metaの承認が不要で、より柔軟なローカライゼーションに対応しており、一般的にテンプレートで会話を開始するよりも低コストだからです。
ステップ 3: 連絡先情報の応答を待つ
- メッセージの後にアクションパスステップを追加します。
- 同じ WhatsApp購読グループを使用するグループを作成します。
- 条件を連絡先情報リクエストに応答したに設定します。
この条件は、連絡先情報リクエストへの返信である WhatsAppインバウンドメッセージに一致するため、共有された電話番号をインバウンドイベントで利用できます。

ステップ 4: プロファイルの電話番号を更新する
連絡先情報リクエストに応答したのアクションパスの Branchで、共有された電話番号を使ってユーザープロファイルを更新します。
- ユーザー更新ステップを追加します。
- 標準の電話番号属性を更新します。
- パーソナライゼーションで WhatsAppプロパティを開き、連絡先共有の電話番号属性を選択して、値が
{{whats_app.${contact_shared_phone_number}}}になるようにします。
このステップの後、それまで匿名だった BSUIDプロファイルに電話番号が設定され、そのプロファイルの WhatsAppメッセージ履歴も保持されます。

{{whats_app.${contact_shared_phone_number}}} 属性は、{{whats_app.${contact_share_origin}}} が contact_request の場合 (ユーザーが連絡先情報を共有をタップした場合) にのみ入力されます。それ以外の連絡先共有では、電話番号の Liquid属性は空になります。詳細については、連絡先共有の発生元を参照してください。

ステップ 5: 重複ユーザーをマージする
電話番号を保存しても、プロファイルは自動的にはマージされません。BSUIDプロファイルに番号が設定されたら、既存の重複解決プロセスを使用して、一致するユーザーが存在する場合にそのプロファイルをメインユーザーに統合します。
次の方法があります。
- プロファイルを個別にマージする
- 重複を一括マージする
- ルールベースのマージを使用して、電話番号の一致をワークスペースの他の部分と一貫した方法で処理する
他のチャネルや IDソースから作成された重複をすでにマージしている方法と同じように扱ってください。
代替設定: フロー全体をキャンペーンとキャンバスに分割する
1つのガイド付きジャーニーのためにキャンバスフロー全体を構築する代わりに、同じワークフローをキャンペーンとキャンバスに分割することもできます。複数の上流メッセージで連絡先情報を依頼でき、共通の更新ファネルを1つにまとめたい場合は、この分割方法を使用します。
- 電話番号が空白の場合にWhatsAppインバウンドメッセージを送信でユーザーをエントリさせ、連絡先情報のリクエスト応答メッセージを送信するキャンペーンを構築します。
- 条件が連絡先情報リクエストに応答したの場合にWhatsAppインバウンドメッセージを送信でユーザーをエントリさせ、ユーザー更新ステップ (および自動化するマージのフォローアップ) を実行するキャンバスを構築します。