View a markdown version of this page

傳送 WhatsApp 流程給使用者 - AWS 最終使用者傳訊社交
範例：透過範本訊息傳送流程設定流程的範本

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

傳送 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 — 您為識別此流程工作階段而產生的唯一字符。當使用者完成流程時，此字符會在 Webhook 中傳回。

  • WELCOME_SCREEN — 流程 JSON 定義中第一個畫面的 ID。

注意

每個工作階段flow_token應該是唯一的，可讓您將流程回應與特定傳送事件建立關聯。您可以使用 UUID 或任何其他唯一識別符。

設定流程的範本

若要傳送流程，您需要已設定流程按鈕的訊息範本。建立範本時，請新增 類型的call-to-action按鈕FLOW，參考您發佈的流程 ID。

如需建立訊息範本的詳細資訊，請參閱 在 AWS 最終使用者傳訊社交中使用訊息範本。如需流程範本組態的資訊，請參閱 Meta WhatsApp Business Platform 文件中的傳送流程。