View a markdown version of this page

接收 Flow 响应和状态更改 - AWS 最终用户社交消息
流量响应消息流量状态变更通知端点运行状况通知（动态流量）Flow 版本到期警告

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

接收 Flow 响应和状态更改

当用户完成 Flow 或 Flow 的状态发生变化时， AWS 最终用户消息 Social 会通过您现有配置的事件目的地发送 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，以便您采取纠正措施。

端点运行状况通知（动态流量）

对于带有端点的动态流，Meta 监控端点运行状况，并在检测到问题时发送通知。您可以通过配置的事件目的地接收这些信息。

端点错误率 -在过去 30 分钟内错误率超过阈值时发送：

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "ENDPOINT_ERROR_RATE",
                        "flow_id": "{FLOW_ID}",
                        "error_rate": 14.28,
                        "threshold": 10,
                        "alert_state": "ACTIVATED",
                        "errors": [
                            { "error_type": "CAPABILITY_ERROR", "error_rate": 66.66, "error_count": 2 },
                            { "error_type": "TIMEOUT", "error_rate": 33.33, "error_count": 1 }
                        ]
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

终端延迟 — 当 p90 延迟超过阈值时发送：

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "ENDPOINT_LATENCY",
                        "flow_id": "{FLOW_ID}",
                        "p90_latency": 8000,
                        "p50_latency": 500,
                        "requests_count": 34,
                        "threshold": 7000,
                        "alert_state": "ACTIVATED"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

端点可用性 — 当端点可用性降至阈值以下时发送：

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "ENDPOINT_AVAILABILITY",
                        "flow_id": "{FLOW_ID}",
                        "availability": 75,
                        "threshold": 90,
                        "alert_state": "ACTIVATED"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

在 Meta 封锁或限制您的 Flow 之前，监控这些事件以检测和解决端点问题。有关设置动态流的更多信息，请参阅设置动态流。

Flow 版本到期警告

当您的 Flow 使用的 Flow JSON 版本接近其生命周期结束日期时，Meta 会发送警告 webhook。版本到期后，在更新到较新版本之前，您无法发送 Flow。

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

当您收到此警告时，通过调UpdateWhatsAppFlowAssets用更新后的 JSON 来更新您的 Flow JSON 以使用推荐版本（目前为 7.3），然后重新发布该流程。