View a markdown version of this page

接收 Flow 响应和状态更改 - AWS最终用户消息社交
流响应消息流程状态变更通知Flow 版本到期警告

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

接收 Flow 响应和状态更改

当用户完成流程或流程的状态发生变化时，AWS最终用户消息社交会通过您现有配置的事件目的地发送 webhook 通知。无需额外的设置或新的事件类型 — Flow 事件会自动传送到您用于消息和传送回执的事件目的地。您必须启用事件目的地才能接收这些通知。有关更多信息，请参阅 将消息和事件目标添加到 AWS 最终用户消息社交。

流响应消息

当用户完成 Flow 时，您会收到一封包含类型interactive和子nfm_reply类型的入站消息。该response_json字段包含用户以 JSON 字符串形式提交的数据。

以下示例显示了 Flow 响应 webhook 有效负载：

{
    "messages": [
        {
            "from": "14085551234",
            "id": "wamid.XXX",
            "timestamp": "1234567890",
            "type": "interactive",
            "interactive": {
                "type": "nfm_reply",
                "nfm_reply": {
                    "response_json": "{\"name\":\"John Doe\",\"email\":\"john@example.com\",\"phone\":\"+14085551234\"}",
                    "body": "Sent",
                    "name": "flow"
                }
            }
        }
    ]
}

response_json包含与 Flow JSON 中定义的表单字段名称和用户输入的值相对应的键值对。解析此 JSON 字符串以提取提交的数据。

流程状态变更通知

当 Meta 更改流程的状态（例如，从 “已发布” 更改为 “已屏蔽”）时，您会通过活动目的地收到通知。以下示例显示了状态更改有效负载：

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "FLOW_STATUS_CHANGE",
                        "flow_id": "{FLOW_ID}",
                        "old_status": "PUBLISHED",
                        "new_status": "BLOCKED",
                        "reason": "Policy violation detected"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

监控这些状态更改事件，以检测 Meta 何时阻止或限制您的流程，以便您采取纠正措施。

Flow 版本到期警告

当你的 Flow 使用的 Flow JSON 版本即将到期时，Meta 会发送警告 webhook。版本过期后，只有更新到新版本后才能发送流程。

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "FLOW_VERSION_EXPIRY_WARNING",
                        "flow_id": "{FLOW_ID}",
                        "warning": "Your current Flow version will freeze in 21 days. You won't be able to send the Flow after it expires. Please migrate to the recommended version as soon as possible."
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

收到此警告后，请使用更新后的 JSON 进行调用，将您的 Flow JSON 更新为UpdateWhatsAppFlowAssets使用推荐版本（当前为 7.3），然后重新发布 Flow。