Skip to content

WhatsApp Flows

WhatsApp Flowsは、既存のWhatsAppチャネルの拡張機能であり、インタラクティブでダイナミックなメッセージングエクスペリエンスを作成できます。このページでは、WhatsApp Flowsの使用方法をステップごとに説明します。

WhatsApp Flowsの設定

  1. Metaアカウントにログインします。
  2. 以下の2つの主要な場所のいずれかからFlowsを作成します。
    • アカウントツール: Flowsタブに移動して、Flow IDを確認し、新しいFlowを作成します。
    • テンプレートの管理: Flowsを作成するための推奨方法です。ここでは、テンプレートを生成し、テンプレート作成プロセス中にFlowオプションを選択できます。

Flowsテンプレートを作成するページが表示されたWhatsApp Manager。

  1. 既存のFlowを選択するか、新しいFlowを作成します。Flowを作成する場合は、以下の2つのオプションから選択します。
    • カスタムフォーム: 特定の要件がある場合
    • 事前デザイン済み要素: より迅速なセットアップの場合

WhatsApp Flowメッセージとレスポンスの設定

  1. BrazeのCanvasで、該当するFlowを含むテンプレートメッセージを使用するWhatsAppメッセージステップを作成します。
  2. テンプレートの作成を続けます。必要に応じて、メディア、変数コンテンツ、またはその両方をメッセージに追加します。Flowの選択はテンプレート作成時に行われるため、Flowエクスペリエンスに関する追加情報は不要です。

WhatsApp Flowテンプレートを使用したWhatsAppメッセージ作成画面。

  1. BrazeのCanvasで、レスポンスメッセージとFlowメッセージを使用するWhatsAppメッセージステップを作成します。

WhatsAppレスポンスメッセージタイプとFlowメッセージレイアウトのメッセージステップ。

  1. 該当するFlowを選択し、メッセージの作成を続けます。

Flowを選択するためのドロップダウンが展開されたFlowメッセージレスポンス作成画面。

Flowのプレビュー

Flowを含むCanvasを起動する前に、Preview Flowを選択して、Braze内で直接Flowをプレビューし、期待どおりに動作することを確認できます。プレビューでFlowを操作して、ユーザーがFlowをどのようにナビゲートするかを体験し、リアルタイムで調整を行うこともできます。Flowに複数のページが含まれている場合は、各ページを操作できます。

ユーザーがサインアップを完了するためのフォームが表示されたプレビューウィンドウ。

Flowレスポンス全体の保存

WhatsApp FlowメッセージをBrazeのCanvasやCampaignに組み込む際、ユーザーがFlowを通じて送信した特定の情報をキャプチャして活用したい場合があります。Brazeは、ユーザーレスポンスの構造に関する追加情報、具体的にはJSONレスポンスの期待される形状を受け取る必要があり、これにより必要な階層化カスタム属性（NCA）スキーマを生成します。

ステップ 1: Flowカスタム属性の生成

レスポンス構造に関する情報をBrazeに提供する最も簡単な方法は、Flowレスポンスをカスタム属性として保存し、テスト送信を完了することです。

Brazeで使用されたことのないFlowを使用する場合

Braze内で以前使用されたことのないFlowを使用している場合、メッセージの作成でFlowカスタム属性セクションを表示すると、情報が表示されないことがあります。これは、スキーマがまだ生成されていないことを意味します。

Flowカスタム属性を表示するオプションがあるMeta Flowセクション。

これを解決するには、以下の手順を実行します。

  1. WhatsAppメッセージステップの設定を完了します。
  2. Flowレスポンスをカスタム属性として保存にチェックが入っていることを確認します。

Flowレスポンスをカスタム属性として保存するチェックボックスがあるMeta Flowセクション。

  1. 自分自身にテストメッセージを送信し、ユーザーとしてFlowを完了します。

これで、BrazeはFlowレスポンスJSONの形状を取得し、カスタム属性を生成できます。

高度なJSONエディターを使用してFlowレスポンスの属性をカスタム属性に保存するか、マルチステップCanvasを使用してレスポンスを階層化カスタム属性に保存します。

高度なJSONエディターで、{"attributes": [{"flow_1": {{whats_app.${inbound_flow_response}}}}]} と入力します。ここで「flow_1」は、Flowの保存先となるカスタム属性です。

高度なJSONエディターを使用したユーザーの更新ステップ。

  1. ワークスペースのデータ設定内に、オブジェクトデータタイプのカスタム属性（この例では「flow_1」）がすでに作成されていることを確認します。
  2. UIエディターで、Liquid {{whats_app.${inbound_flow_response}}} を使用してカスタム属性にデータを入力し、ユーザーのFlowレスポンス全体を保存します。作成したカスタム属性を選択する前に、キー値を {{whats_app.${inbound_flow_response}}} として入力する必要があります。

UIエディターを使用したユーザーの更新ステップ。

BrazeがFlowレスポンスを受信すると、指定された命名規則で階層化カスタム属性をユーザープロファイルに保存します。そのカスタム属性は、Canvasの構築時に取得できます。

「flow_1」カスタム属性の内容を表示するウィンドウ。

ステップ 2: 保存されたFlowレスポンスの表示

Flowが完了すると、BrazeはFlow IDに基づいた名前でFlowカスタム属性を自動的に作成します。その後、ユーザープロファイルに移動して、カスタム属性セクションで保存されたFlowレスポンスをネストされたオブジェクトとして表示できます。

スキーマが生成されると、Flowカスタム属性セクションに、各レスポンスの予想されるデータタイプ（例：「文字列」や「文字列配列」）を含む期待される構造が表示されます。

スキーマドロップダウンが表示されたFlowカスタム属性の詳細ウィンドウ。

考慮事項

  • 既存の属性: 特定のFlowのカスタム属性がすでに生成されている場合、Flowはその属性情報を読み込んだ状態で表示されます。この場合、Brazeはすでに期待されるレスポンスメッセージを認識しているため、スキーマを生成するためにテストメッセージを送信する必要はありません。
  • Flowの変更: スキーマ生成後にFlowに変更を加えた場合、Flowレスポンスの形状が変更されたことをBrazeが理解し、属性構造を適切に調整できるように、追加のテストメッセージを送信する必要があります。このアクションは24時間に1回に制限されています。
  • 一貫性: 生成されたFlowカスタム属性は一貫しており、使用されるCanvasに関係なく、この特定のFlowに対して同じ属性になります。
  • 手動オプション: Flowレスポンスをカスタム属性として保存チェックボックスを選択する必要はありません。Flowレスポンスから特定のフィールドを特定のカスタム属性に保存することで、カスタム属性を手動で生成でき、ユーザーステップの重複を回避できます。

Flowレスポンスから特定のフィールドを特定のカスタム属性に保存する

ステップ 1: アクションパスの作成

アクションパスのCanvasステップまたはアクションベースのCampaignを作成します。WhatsAppインバウンドメッセージを送信トリガーとFlowに応答条件を選択し、該当するFlowまたは任意のFlowを選択します。

WhatsAppインバウンドメッセージを送信し、任意のFlowに応答したユーザーのトリガー。

ステップ 2: Flowレスポンスからフィールドを抽出する

階層化カスタム属性またはjson_parse Liquidタグを使用して、Flowレスポンスから特定のフィールドを抽出できます。

ユーザーのFlowレスポンスの特定の部分を保存するには、Canvasの起動を含むFlowレスポンス全体の保存のすべてのステップを完了します。Canvasを起動して、参照する階層化カスタム属性を作成する必要があります。Canvasを起動してFlowを完了した後、以下のステップを実行します。

  1. UIエディターを使用する後続のユーザーの更新ステップを作成します。
  2. パーソナライゼーションを追加を選択し、階層化カスタム属性とFlowが保存されている対応するトップレベル属性を選択します。

階層化カスタム属性のパーソナライゼーションを使用したユーザーの更新ステップ。

  1. 保存したいキー属性を選択し、キー値フィールドにLiquidを挿入します。

選択可能な属性が表示された「flow_1」のウィンドウ。

  1. 保存先の属性を選択します。
  2. テストメッセージを送信してFlowをテストします。

json_parse Liquidタグを使用して、Flowから特定のレスポンスを抽出します。例えば、Flowトークンと選択されたオプションを取得して、フォローアップメッセージをカスタマイズできます。

UIエディターで、以下を選択します。

  • 属性名: YOUR_CUSTOM_ATTRIBUTE（この例では「First_name」）
  • アクション: 更新
  • キー値: {% assign parsed_json = {{whats_app.${inbound_flow_response}}} | json_parse %}{{ parsed_json.FIELDS_THAT_APPLY }}

カスタム属性「inbound_flow_response」を使用したWhatsAppプロパティのパーソナライゼーションを挿入する「パーソナライゼーションを追加」コンポーネントが表示されたWhatsAppメッセージ作成画面。

準備ができたら、テストメッセージを送信してFlowをテストします。その後、Canvasを起動しましょう！

Flowパーソナライゼーションタグの追加

サポートされているパーソナライゼーションタグを使用してLiquidでFlowレスポンスを利用するには、以下のステップを完了します。

  1. WhatsAppメッセージの作成時に、プラスアイコンを選択してパーソナライゼーションを追加ウィンドウを開きます。
  2. パーソナライゼーションタイプとしてWhatsApp Propertiesを選択し、カスタム属性としてinbound_flow_responseを選択します。これを使用して、ユーザープロファイルに情報を保存したり、メッセージに含めたり、webhookなどの他のサービスに転送したりできます。

カスタム属性inbound_flow_responseを使用したWhatsAppプロパティのパーソナライゼーションを挿入する「パーソナライゼーションを追加」コンポーネントが表示されたWhatsAppメッセージ作成画面。

ご質問やサポートが必要な場合は、サポートにお問い合わせください。
New Stuff!