기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

흐름 응답 및 상태 변경 수신

사용자가 흐름을 완료하거나 흐름의 상태가 변경되면 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"
                }
            }
        }
    ]
}

에는 흐름 JSON에 정의된 양식 필드 이름과 사용자가 입력한 값에 해당하는 키-값 페어가 response_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가 흐름을 차단하거나 제한하는 시기를 감지하여 수정 조치를 취할 수 있습니다.

엔드포인트 상태 알림(동적 흐름)

엔드포인트가 있는 동적 흐름의 경우 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는 흐름에서 사용하는 흐름 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으로를 호출하여 권장 버전(현재 7.3)을 사용하도록 흐름 JSONUpdateWhatsAppFlowAssets을 업데이트한 다음 흐름을 다시 게시합니다.