View a markdown version of this page

向用户发送 WhatsApp 流程 - AWS 最终用户社交消息
示例：通过模板消息发送流程为流程设置模板

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

向用户发送 WhatsApp 流程

您可以使用现有 SendWhatsAppMessage API 通过模板消息向用户发送流程。无需对发送消息 API 进行任何更改。Flow 作为带有flow子类型的按钮组件嵌入到模板消息中。

在发送 Flow 之前，必须满足以下条件：

  • 流程必须处于 “已发布” 状态。

  • 您必须有一个引用 Flow 的消息模板（带有 Flow 按钮）。

  • 用户必须已选择接收您的消息。

示例：通过模板消息发送流程

以下示例发送了一条包含 Flow 按钮的模板消息。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— 您为识别此 Flow 会话而生成的唯一令牌。当用户完成流程时，此令牌将在 webhook 中返回。

  • WELCOME_SCREEN— Flow JSON 定义中第一个屏幕的 ID。

注意

每个会话都flow_token应该是唯一的，这样您就可以将 Flow 响应与特定的发送事件相关联。您可以使用 UUID 或任何其他唯一标识符。

为流程设置模板

要发送 Flow，您需要一个配置了 Flow 按钮的消息模板。创建模板时，请添加一个引用您发布的 Flow ID FLOW 的号召性用语按钮。

有关创建消息模板的更多信息，请参阅在 AWS 最终用户消息社交中使用消息模板。有关流程模板配置的信息，请参阅 Meta B WhatsApp usiness Platform 文档中的发送流程。