

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

# 傳送 WhatsApp 流程給使用者
<a name="managing-flows-send"></a>

您可以使用現有的 `SendWhatsAppMessage` API，透過範本訊息將流程傳送給使用者。不需要變更傳送訊息 API。流程內嵌在範本訊息中，做為具有`flow`子類型的按鈕元件。

傳送流程之前，必須符合下列條件：
+ 流程必須處於 PUBLISHED 狀態。
+ 您必須擁有參考流程的訊息範本 （使用流程按鈕）。
+ 使用者必須已選擇接收來自您的訊息。

## 範例：透過範本訊息傳送流程
<a name="managing-flows-send-example"></a>

下列範例會傳送包含流程按鈕的範本訊息。`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 或任何其他唯一識別符。

## 設定流程的範本
<a name="managing-flows-send-template-setup"></a>

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

如需建立訊息範本的詳細資訊，請參閱 [在 AWS 最終使用者傳訊社交中使用訊息範本](managing-templates.md)。如需流程範本組態的資訊，請參閱 *Meta WhatsApp Business Platform 文件*中的[傳送流程](https://developers.facebook.com/docs/whatsapp/flows/gettingstarted/sendingaflow)。