翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

フローレスポンスとステータス変更の受信

ユーザーがフローを完了するか、フローのステータスが変更されると、 AWS End User Messaging Social は、設定された既存のイベント送信先を通じてウェブフック通知を配信します。追加のセットアップや新しいイベントタイプは必要ありません — フローイベントは、メッセージと配信受信に使用するのと同じイベント送信先に自動的に配信されます。これらの通知を受信するには、イベント送信先が有効になっている必要があります。詳細については、「AWS End User Messaging Social にメッセージとイベントの送信先を追加する」を参照してください。

フローレスポンスメッセージ

ユーザーがフローを完了するinteractiveと、 タイプと サブタイプを含むインバウンドメッセージが表示されますnfm_reply。response_json フィールドには、ユーザーが JSON 文字列として送信したデータが含まれます。

次の例は、フローレスポンスのウェブフックペイロードを示しています。

{
    "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 には、フロー JSON で定義されたフォームフィールド名と、ユーザーが入力した値に対応するキーと値のペアが含まれます。この JSON 文字列を解析して、送信されたデータを抽出します。

フローステータス変更通知

Meta がフローのステータス (PUBLISHED から BLOCKED など) を変更すると、イベント送信先を通じて通知を受け取ります。次の例は、ステータス変更ペイロードを示しています。

{
    "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 がフローをブロックまたはスロットリングするタイミングを検出し、修正アクションを実行できるようにします。

エンドポイントのヘルス通知 (動的フロー)

エンドポイントを持つ動的フローの場合、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 がフローをブロックまたはスロットリングする前に、これらのイベントをモニタリングしてエンドポイントの問題を検出して解決します。動的フローの設定の詳細については、「」を参照してください動的フローのセットアップ。

フローバージョンの有効期限に関する警告

Meta は、フローで使用される Flow JSON バージョンがend-of-lifeに近づいたときに警告ウェブフックを送信します。バージョンの有効期限が切れると、新しいバージョンに更新するまでフローを送信できません。

{
    "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 UpdateWhatsAppFlowAssetsで を呼び出して、推奨バージョン (現在は 7.3) を使用するようにフロー JSON を更新し、フローを再発行します。