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

動的フローのセットアップ

動的フローは、実行時に独自の HTTPS エンドポイントを呼び出して、画面コンテンツを取得し、ナビゲーションを決定します。静的フローは、フロー JSON のすべての画面を定義します。動的フローは代わりに data_exchangeアクションを使用して、ユーザーが画面間を移動するたびにエンドポイントにデータをリクエストします。これにより、オープンオーダーの表示、入力サーバー側の検証、バックエンドの決定に基づく分岐など、パーソナライズされたデータ駆動型のエクスペリエンスが可能になります。

ユーザーが動的フローとやり取りすると、Meta は暗号化されたリクエストでエンドポイントを直接呼び出します。エンドポイントはリクエストを復号し、ビジネスロジックを実行し、レスポンスを暗号化して、Meta に返します。暗号化されたリクエストとレスポンスは Meta とエンドポイントの間で直接渡されるため、 AWS End User Messaging Social はこれらの交換の復号されたコンテンツにアクセスできません。 AWS End User Messaging Social は、フローの作成と更新、暗号化パブリックキーのアップロード、フローヘルスウェブフックの配信のコントロールプレーンを管理します。

動的フローを設定するには、次の手順を実行します。

ステップ 1: HTTPS エンドポイントをデプロイする

エンドポイントは、次の要件を満たしている必要があります。

パブリック HTTPS URL を提供する任意のコンピューティングオプションを使用できます。一般的なアプローチは次のとおりです。

エンドポイントは、次のリクエストタイプを処理する Meta のデータ交換契約を実装する必要があります。

複数の言語での暗号化および復号コードサンプルを含むエンドポイント実装ガイドの詳細については、Meta for Developers ウェブサイトの「フローエンドポイントの実装」を参照してください。

ステップ 2: ビジネスパブリックキーをアップロードする

Meta は、RSA (Rivest-Shamir-Adleman) パブリックキーを使用して、すべてのデータ交換リクエストをend-to-endで暗号化します。エンドポイントは、対応するプライベートキーを使用してリクエストを復号します。 AWS End User Messaging Social は、ユーザーに代わってパブリックキーを Meta にアップロードしますが、プライベートキーにアクセスまたは保存することはありません。

PutWhatsAppBusinessPublicKey API を使用して、電話番号のパブリックキーをアップロードします。次のいずれかを指定する必要があります。

両方を指定するか、どちらも を返しますInvalidParametersException。

PEM モード

RSA キーペアを生成し、パブリックキーをアップロードします。

# Generate a key pair
openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -pubout -out public.pem

# Upload the public key
aws social-messaging put-whatsapp-business-public-key \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --business-public-key "$(cat public.pem)"

プライベートキーを安全に保存し、エンドポイントで復号化できるようにします。

AWS KMS モード

非対称 RSA KMS キーを作成し、その ARN をアップロードします。

# Create the KMS key
KMS_KEY_ARN=$(aws kms create-key \
    --key-spec RSA_2048 \
    --key-usage ENCRYPT_DECRYPT \
    --description "WhatsApp Dynamic Flow encryption key" \
    --query KeyMetadata.Arn --output text)

# Upload the KMS key ARN
aws social-messaging put-whatsapp-business-public-key \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --kms-key-arn $KMS_KEY_ARN

KMS キーポリシーは、次のアクセス許可を付与する必要があります。

キーの検証

GetWhatsAppBusinessPublicKey API を使用して、保存されたキーを確認し、Meta の署名ステータスを確認します。

aws social-messaging get-whatsapp-business-public-key \
    --origination-phone-number-id {PHONE_NUMBER_ID}

レスポンスには、保存された PEM と Meta の署名ステータス (VALID または ) が含まれますMISMATCH。MISMATCH ステータスは、保存されたキーが Meta の予想と一致していないことを示します。このステータスが表示された場合は、新しいキーをアップロードします。

ステップ 3: エンドポイントを使用してフローを作成する

動的フローを作成するときは、HTTPS エンドポイント URL で --endpoint-uriパラメータを指定します。フロー JSON も を宣言する必要があります。これによりdata_api_version、フローセッション中にエンドポイントを呼び出すよう Meta に指示します。

aws social-messaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "my_dynamic_flow" \
    --categories '["OTHER"]' \
    --flow-json fileb://flow.json \
    --endpoint-uri "https://your-endpoint.example.com/flow"

を使用して、既存のドラフトフローでエンドポイントを追加または変更することもできますUpdateWhatsAppFlow。

aws social-messaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --endpoint-uri "https://your-endpoint.example.com/flow"

フロー用に設定されたエンドポイントとデータ API バージョンを確認するには、 を使用しますGetWhatsAppFlow。

aws social-messaging get-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

レスポンスには、Meta endpointUriが保持している 、Flow JSON でdataApiVersion宣言されている 、および現在アタッチされている が含まれますapplication。

ステップ 4: Meta アプリをアタッチしてリクエストを検証する

デフォルトでは、フロースルー AWS エンドユーザーメッセージングソーシャルを作成すると、サービスの Meta アプリに関連付けられます。エンドポイントへのデータ交換リクエストが Meta から発信されていることを確認するには、独自の Meta アプリを Flow にアタッチします。独自のアプリをアタッチしないと、リクエストオリジンの検証はできません。アプリをアタッチすると、Meta が各リクエストに含める X-Hub-Signature-256 HMAC ヘッダーを検証するために必要なアプリシークレットにアクセスできます。

aws social-messaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --meta-app-id "{YOUR_META_APP_ID}"

Meta アプリは、WhatsApp Business Account (WABA) を所有するのと同じビジネスによって所有されている必要があります。

--endpoint-uri と は、同じ呼び出し--meta-app-idまたは別々の呼び出しで設定できます。2 つのフィールドは独立しています。

アプリをアタッチしたら、 を呼び出しGetWhatsAppFlowてレスポンスの applicationフィールドを確認して設定を確認します。は、指定した Meta アプリ ID と一致するapplication.id必要があります。

エンドポイントの保護

Meta はエンドポイントを直接呼び出すため、次のセキュリティプラクティスを検討してください。

動的フロー JSON の記述

動的フロー JSON は、静的フロー JSON と 2 つの点で異なります。

次の例は、2 つの画面を持つ最小限の動的フロー JSON を示しています。最初の画面はユーザー名を収集し、エンドポイントに送信します。エンドポイントは、2 番目の画面でパーソナライズされた挨拶を返します。

{
    "version": "6.0",
    "data_api_version": "3.0",
    "routing_model": {
        "INPUT": ["RESULT"],
        "RESULT": []
    },
    "screens": [
        {
            "id": "INPUT",
            "title": "Welcome",
            "data": {
                "greeting": {
                    "type": "string",
                    "__example__": "Tell us your name"
                }
            },
            "layout": {
                "type": "SingleColumnLayout",
                "children": [
                    {
                        "type": "TextBody",
                        "text": "${data.greeting}"
                    },
                    {
                        "type": "Form",
                        "name": "input_form",
                        "children": [
                            {
                                "type": "TextInput",
                                "name": "user_name",
                                "label": "Your name",
                                "input-type": "text",
                                "required": true
                            },
                            {
                                "type": "Footer",
                                "label": "Submit",
                                "on-click-action": {
                                    "name": "data_exchange",
                                    "payload": {
                                        "user_name": "${form.user_name}"
                                    }
                                }
                            }
                        ]
                    }
                ]
            }
        },
        {
            "id": "RESULT",
            "title": "Hello",
            "terminal": true,
            "data": {
                "message": {
                    "type": "string",
                    "__example__": "Hello, World!"
                }
            },
            "layout": {
                "type": "SingleColumnLayout",
                "children": [
                    {
                        "type": "TextBody",
                        "text": "${data.message}"
                    },
                    {
                        "type": "Footer",
                        "label": "Done",
                        "on-click-action": {
                            "name": "complete",
                            "payload": {}
                        }
                    }
                ]
            }
        }
    ]
}

Flow JSON スキーマの完全なリファレンスについては、Meta for Developers ウェブサイトの「Flow JSON」を参照してください。

エンドツーエンドの例

次の例は、動的フローを設定して公開するための API コールの完全なシーケンスを示しています。

# 1. Upload the business public key (KMS mode)
aws social-messaging put-whatsapp-business-public-key \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --kms-key-arn {KMS_KEY_ARN}

# 2. Create the Dynamic Flow with an endpoint
FLOW_ID=$(aws social-messaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "my_dynamic_flow" \
    --categories '["OTHER"]' \
    --flow-json fileb://flow.json \
    --endpoint-uri "https://your-endpoint.example.com/flow" \
    --query flowId --output text)

# 3. Attach your Meta app for signature verification
aws social-messaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id $FLOW_ID \
    --meta-app-id "{YOUR_META_APP_ID}"

# 4. Publish the Flow
aws social-messaging publish-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id $FLOW_ID

# 5. Verify the configuration
aws social-messaging get-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id $FLOW_ID

公開後、フローはテンプレートメッセージで使用できます。フローの送信の詳細については、「」を参照してくださいWhatsApp フローをユーザーに送信する。