View a markdown version of this page

흐름 응답 및 상태 변경 수신 - AWS최종 사용자 메시징 소셜
흐름 응답 메시지흐름 상태 변경 알림흐름 버전 만료 경고

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

흐름 응답 및 상태 변경 수신

사용자가 흐름을 완료하거나 흐름의 상태가 변경되면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는 흐름에서 사용하는 흐름 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을 업데이트한 다음 흐름을 다시 게시합니다.