本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

設定動態流程

動態流程會在執行時間呼叫您自己的 HTTPS 端點，以擷取畫面內容並決定導覽。靜態流程定義流程 JSON 中的所有畫面。動態流程會改為在每次使用者在畫面之間導覽時，使用 data_exchange動作從您的端點請求資料。這可實現個人化、資料驅動的體驗，例如向使用者顯示其開啟的訂單、驗證輸入伺服器端，或根據後端決策進行分支。

當使用者與動態流程互動時，中繼會使用加密請求直接呼叫您的端點。您的端點會解密請求、執行您的商業邏輯、加密回應，並將其傳回 Meta。加密的請求和回應會直接在中繼和端點之間傳遞，因此 AWS 最終使用者傳訊社交永遠無法存取這些交換的解密內容。 AWS 最終使用者傳訊社交會管理控制平面：建立和更新流程、上傳加密公有金鑰，以及交付流程運作狀態 Webhook。

若要設定動態流程，請完成下列步驟：

步驟 1：部署 HTTPS 端點

您的端點必須符合下列要求：

您可以使用任何提供公有 HTTPS URL 的運算選項。常見的方法包括：

您的端點必須實作 Meta 的資料交換合約，該合約會處理下列請求類型：

如需完整的端點實作指南，包括多種語言的加密和解密程式碼範例，請參閱 Meta for Developers 網站上的實作您的流程端點。

步驟 2：上傳商業公有金鑰

Meta 會使用 RSA (Rivest-Shamir-Adleman) 公有金鑰end-to-end的資料交換請求。您的端點會使用對應的私有金鑰解密請求。 AWS 使用者傳訊社交會代表您將公有金鑰上傳至 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 驗證儲存的金鑰並檢查中繼的簽署狀態：

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

回應包含存放的 PEM 和中繼簽署狀態 (VALID 或 MISMATCH)。MISMATCH 狀態表示儲存的金鑰與 Meta 預期不相符。如果您看到此狀態，請上傳新的金鑰。

步驟 3：使用端點建立流程

建立動態流程時，請提供 --endpoint-uri 參數與您的 HTTPS 端點 URL。流程 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"

您也可以使用 在現有的 DRAFT 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}

回應包含endpointUri中繼保留的 、流程 JSON 中dataApiVersion宣告的 ，以及目前連接的 application。

步驟 4：連接您的 Meta 應用程式以進行請求驗證

根據預設，當您透過 AWS 最終使用者傳訊社交建立流程時，它會與服務的中繼應用程式相關聯。若要驗證對端點的資料交換請求是否來自 Meta，請將您自己的 Meta 應用程式連接到 流程。如果沒有連接您自己的應用程式，就無法進行請求來源驗證。連接您的應用程式可讓您存取驗證 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 商業帳戶 (WABA) 的相同企業所擁有。

您可以在相同通話--meta-app-id或個別通話中設定 --endpoint-uri和 。這兩個欄位是獨立的。

連接應用程式後，請呼叫 GetWhatsAppFlow並檢查回應中的 application 欄位，以驗證組態。application.id 應該符合您提供的中繼應用程式 ID。

保護您的端點

由於 Meta 會直接呼叫您的端點，請考慮下列安全實務：

撰寫動態流程 JSON

動態流程 JSON 與靜態流程 JSON 有兩種不同之處：

下列範例顯示具有兩個畫面的最小動態流程 JSON。第一個畫面會收集使用者名稱，並將其傳送至端點。端點會在第二個畫面上傳回個人化問候語。

{
    "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": {}
                        }
                    }
                ]
            }
        }
    ]
}

如需完整的流程 JSON 結構描述參考，請參閱 Meta for Developers 網站上的流程 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 流程給使用者。