Amazon Connect의 고객 응대 흐름 오류 문제를 해결하고 싶습니다.
해결 방법
고객 응대 흐름 로그 켜기
흐름 로그를 켭니다. 고객 응대 흐름 로그를 사용하면 통화가 고객 응대 흐름의 서로 다른 블록들을 거쳐 어떻게 진행되는지 파악할 수 있습니다. 또한, 고객 응대 흐름 로그를 사용해 문제를 해결하고 오류를 격리할 수 있습니다.
통화가 흐름을 거쳐 어떻게 진행되는지 확인하거나, 고객 응대 흐름 로그를 상호 연관시키거나, 샌드박스 환경에서 문제를 재현하려면 흐름 내보내십시오.
고객 응대 흐름 오류 식별
고객 응대 흐름 오류를 모니터링하고 식별하려면 ContactFlowErrors 및 ContactFlowFatalError Amazon CloudWatch 지표를 사용하십시오.
오류 관련 이벤트를 찾으려면 다음 단계를 완료하십시오.
- CloudWatch 콘솔을 엽니다.
- 탐색 창의 **Logs(로그)**에서 **Logs Insights(로그 인사이트)**를 선택합니다.
- Amazon Connect 인스턴스 로그의 로그 그룹 이름을 선택합니다. 형식은 /aws/connect/yourinstancename입니다.
- 오른쪽 상단에서 쿼리 기간을 지정합니다.
- 특정 시간 범위에 대해 다음 쿼리를 실행합니다.
fields @timestamp, @message| filter @message like 'Results'
| parse @message '"Results":"*","ContactId":"*","ContactFlowId":"*","ContactFlowName":"*","ContactFlowModuleType":"*"' as Results, ContactId, ContactFlowId, ContactFlowName, BlockType
| filter Results like 'rror' or Results like 'ailed' or Results like 'imeout' or Results like 'xception' or Results like 'No prompt provided' or Results like 'Instance has reached concurrent Lambda thread access limit' or Results like 'nsupported' or Results like 'nvalid' or Results like 'not found' or Results like 'execution limit reached'
| sort @timestamp asc
| display Timestamp, Results, ContactId, ContactFlowId, ContactFlowName, BlockType
-또는-
특정 고객 응대 ID에 대해 다음 쿼리를 실행합니다.
fields @timestamp, @message| sort @timestamp desc
| filter ContactId = "162faf0b-4e68-4a4b-bbde-96c9631f2a95"
참고: ContactId의 값을 사용자의 고객 응대 ID로 바꾸십시오.
고객 응대 흐름 오류를 해결하려면 CloudWatch 경보 구성 세부 정보를 검토하십시오. 경보 및 해당 경보와 연결된 고객 응대 흐름을 구성하는 데 ContactFlowErrors 지표와 ContactFlowFatalError 지표 중 어느 것을 사용했는지 확인하십시오.
경보 지표가 ContactFlowFatalError인 경우, 시스템 오류로 인해 흐름이 실행되지 못했기 때문에 서비스 문제일 수 있습니다. 경보 지표가 ContactFlowErrors인 경우, Amazon Connect가 고객 응대 흐름 블록을 오류 브랜치로 라우팅했음을 의미합니다.
그런 다음, 영향을 받은 고객 응대 흐름와 관련된 로그를 검토하여 오류를 발생시킨 블록을 식별합니다. 흐름 블록에 대한 자세한 내용은 Amazon Connect 흐름 디자이너의 흐름 블록 정의를 참조하십시오.
참고: 고객 응대 흐름 블록이 CloudWatch에 오류를 생성할 수 있지만, 이에 해당하는 CloudWatch 로그는 생성되지 않을 수 있습니다.
고객 응대 흐름의 Lambda 오류 문제 해결
Invoke Lambda Function(Lambda 함수 호출) 블록은 AWS Lambda를 직접적으로 호출하며, 선택적으로 고객 응대 흐름 속성을 설정하는 데 사용할 수 있는 키-값 쌍을 반환합니다. 이 블록은 고객 응대 흐름 오류를 일으킬 수 있습니다.
Lambda 함수 오류를 조사하려면 CloudWatch 로그 인사이트에서 다음 쿼리를 실행합니다.
fields @timestamp, @message| sort @timestamp desc
| filter Results LIKE "Error"
출력은 다음과 유사하게 표시됩니다.
{
"Results": "The Lambda Function Returned an Error.",
"ContactId": "alebb22a-93c4-4f90-8f22-b3718c4578E0",
"ContactFlowId": "contact-flow-id",
"ContactFlowName": "chat",
"ContactFlowModuleType": "InvokeExternalResource",
"Timestamp": "2023-12-20T14:14:13.794Z",
"Parameters": {
"FunctionARN": "arn:aws:lambda:us-west-2:1099999:function:Connect-Wallboard-Historical-Metrics",
},
"TimeLimit": "3000"
}
영향을 받은 ContactFlowModuletype 중 InvokeExternalResource는 Lambda 함수, 고객 응대 흐름 이름, 그리고 오류를 참조합니다. 영향을 받는 Lambda 함수를 찾습니다. 그런 다음 타임스탬프 또는 고객 응대 ID를 상호 연관시켜 Lambda 실행 로그에서 오류를 일으킨 정확한 이벤트를 확인합니다.
다음은 InvokeExternalResource 블록으로 인해 발생하는 고객 응대 흐름 로그 오류의 예입니다.
{
"Results": "Status Code: 403; Error Code: AccessDeniedException; RequestID: 435c21cc-19d8-4847-864e-e32867fe3a70
"ContactId": "alebb22a-93c4-4f90-8f22-b3718c4578E0",
"ContactFlowId": " arn:aws:lambda:us-west-2:1099999/contact-flow/65569e69-5c67-4061-8776-fd1d501c4838",
}
"Access Denied" 오류는 고객 응대 흐름에 Lambda 함수를 간접적으로 호출할 수 있는 권한이 없음을 의미합니다. 인스턴스에 함수를 추가하는 방법에 대한 자세한 내용은 Amazon Connect 인스턴스에 Lambda 함수 추가를 참조하십시오.
Amazon Connect의 고객 응대 흐름 로그 메시지와 Lambda 실행 로그를 연결해 주는 RequestId는 존재하지 않습니다. Lambda 함수가 호출 이벤트를 출력하는 경우 ContactID를 사용하여 고객 응대 흐름 로그와 Lambda 함수 실행 로그를 연관시키십시오. 함수가 호출 이벤트를 출력하지 않는 경우, 고객 응대 흐름 로그의 타임스탬프를 사용하여 Lambda 함수의 실행 로그를 필터링하십시오.
Invoke Lambda Function(Lambda 함수 호출) 블록이 오류를 반환하지만 Lambda 함수에 해당 항목이 없는 경우 다음 구성을 확인하십시오.
- Lambda 페이로드가 NULL일 수 있습니다.
- 함수에서 반환된 출력은 영숫자, 대시 및 밑줄 문자를 포함하는 값을 포함하는 키 및 값 쌍으로 구성된 플랫 객체여야 합니다.
- Lambda 함수 응답은 단순한 문자열 맵이 아니거나 응답이 32k보다 큽니다. Lambda 함수에서 반환된 출력을 테스트하여 Amazon Connect가 Lambda에서 반환된 함수를 올바르게 사용하는지 확인하는 것이 가장 좋습니다.
고객 응대 흐름 오류를 예방하기 위해 프로덕션에 고객 응대 흐름을 배포하기 전에 Amazon Connect의 기본 통화 시뮬레이션을 사용할 수 있습니다.