View a markdown version of this page

WhatsApp フローをユーザーに送信する - AWS エンドユーザーメッセージングソーシャル
例: テンプレートメッセージ経由でフローを送信するFlows のテンプレートのセットアップ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

WhatsApp フローをユーザーに送信する

既存の SendWhatsAppMessage API を使用して、テンプレートメッセージを通じてフローをユーザーに送信します。送信メッセージ API の変更は必要ありません。フローは、flowサブタイプのボタンコンポーネントとしてテンプレートメッセージに埋め込まれます。

フローを送信する前に、次の条件を満たしている必要があります。

  • フローは PUBLISHED ステータスである必要があります。

  • フローを参照するメッセージテンプレートが必要です (フローボタンを使用）。

  • ユーザーからメッセージを受信するには、ユーザーがオプトインしている必要があります。

例: テンプレートメッセージ経由でフローを送信する

次の の例では、フローボタンを含むテンプレートメッセージを送信します。flow_token は、セッションを追跡するために指定する一意の識別子であり、開始画面と初期データflow_action_dataを指定します。

aws socialmessaging send-whatsapp-message \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --meta-api-version v20.0 \
    --message '{
        "messaging_product": "whatsapp",
        "to": "+14085551234",
        "type": "template",
        "template": {
            "name": "flow_template_name",
            "language": {"code": "en_US"},
            "components": [
                {
                    "type": "button",
                    "sub_type": "flow",
                    "index": "0",
                    "parameters": [
                        {
                            "type": "action",
                            "action": {
                                "flow_token": "unique-session-token-123",
                                "flow_action_data": {
                                    "screen": "WELCOME_SCREEN",
                                    "data": {}
                                }
                            }
                        }
                    ]
                }
            ]
        }
    }'

前述のコマンドで、以下を置き換えます。

  • {PHONE_NUMBER_ID} — 発信元の電話番号の ID。

  • +14085551234 — 国際形式の受信者の電話番号。

  • flow_template_name — フローボタンを含む承認済みメッセージテンプレートの名前。

  • unique-session-token-123 — このフローセッションを識別するために生成する一意のトークン。このトークンは、ユーザーがフローを完了するとウェブフックに返されます。

  • WELCOME_SCREEN — Flow JSON 定義の最初の画面の ID。

注記

フローレスポンスを特定の送信イベントに関連付けることができるように、 はセッションごとに一意flow_tokenである必要があります。UUID または他の一意の識別子を使用できます。

Flows のテンプレートのセットアップ

フローを送信するには、フローボタンが設定されたメッセージテンプレートが必要です。テンプレートを作成するときは、公開されたフロー ID を参照FLOWする call-to-actionボタンを追加します。

メッセージテンプレートの作成の詳細については、「」を参照してくださいAWS End User Messaging Social でのメッセージテンプレートの使用。フローテンプレート設定の詳細については、Meta WhatsApp Business Platform ドキュメントの「フローの送信」を参照してください。