Amazon Connect 고객 응대 흐름에서 Lambda 함수 실패 문제를 해결하려면 어떻게 해야 하나요?

3분 분량

고객 응대 흐름이 Amazon Connect에서 함수를 호출하려고 할 때 AWS Lambda 함수가 호출되지 않는 이유를 알고 싶습니다.

해결 방법

Lambda 함수의 리소스 기반 정책이 Amazon Connect에 함수 호출 권한을 부여하는지 확인합니다.

1. 아직 설정하지 않은 경우 Amazon Connect 인스턴스의 고객 응대 흐름 로깅을 활성화합니다.

2. AccessDeniedException 오류 메시지를 고객 응대 흐름 로그에서 검색합니다. 함수의 AWS Identity and Access Management(IAM) 리소스 기반 정책에서 Amazon Connect에 함수 호출 권한을 부여하지 않는 경우 이 오류가 표시됩니다.

참고: 함수의 리소스 기반 정책을 수동으로 검토하여 필요한 권한이 포함되어 있는지 확인할 수도 있습니다. 자세한 내용은 AWS Lambda에 리소스 기반 정책 사용을 참조하세요.

필요한 권한 추가하기

add-permission AWS CLI 명령을 실행합니다. 주요 connect.amazonaws.com과 Amazon Connect 인스턴스의 Amazon 리소스 이름(ARN)을 포함합니다.

참고: AWS Command Line Interface(AWS CLI) 명령을 실행할 때 오류 메시지가 표시되는 경우 AWS CLI 최신 버전을 사용 중인지 확인합니다.

자세한 내용은 Amazon Connect 관리자 가이드의 Lambda 함수 만들기를 참조하세요. 또한 Lambda 개발자 가이드의 Granting function access to AWS services(함수에 AWS 서비스 액세스 권한 부여)를 참조하세요.

Amazon Connect에 함수 호출 권한을 부여하는 Lambda 함수에 대한 리소스 기반 정책 예시

중요: 함수의 ARN을 으로 바꾸세요. 을 Amazon Connect 인스턴스의 ARN으로 바꾸세요.

{
  "Version": "2012-10-17",
  "Id": "default",
  "Statement": [
    {
      "Sid": "100",
      "Effect": "Allow",
      "Principal": {
        "Service": "connect.amazonaws.com"
      },
      "Action": "lambda:InvokeFunction",
      "Resource": "<Qualified AWS Lambda ARN>",
      "Condition": {
        "ArnLike": {
          "AWS:SourceArn": "<Amazon Connect ARN>"
        }
      }
    }
  ]
}

Lambda 함수의 응답 확인

Amazon Connect 관리자 가이드의 함수 응답 확인에 나와 있는 지침을 따릅니다. Lambda 함수가 반환한 출력을 테스트할 때 다음 사항을 확인합니다.

출력이 키 값 쌍의 플랫 객체이어야 합니다.
키 값 쌍에는 영숫자, 대시, 밑줄 문자만 사용할 수 있습니다.
객체가 중첩되거나 복잡하지 않아야 합니다.
반환된 데이터는 32KB 미만의 UTF-8 데이터여야 합니다.

Lambda 함수의 제한 시간 설정이 함수가 호출될 수 있을 만큼 충분히 높게 설정되어 있는지 확인합니다.

함수가 구성된 Timeout(제한 시간) 설정 내에서 호출되지 않는 경우 고객 응대는 Invoke AWS Lambda function(AWS Lambda 함수 호출)의 Error(오류) 분기 아래로 라우팅됩니다. Timeout(제한 시간) 설정 기본값은 3초입니다. Timeout(제한 시간) 설정 최댓값은 8초입니다.

함수가 호출되는 데 걸리는 시간을 확인하려면 Amazon CloudWatch에서 함수의 기간 지표를 검토하세요.

Lambda 함수의 Timeout(제한 시간) 설정을 검토하고 편집하려면 고객 응대 블록: AWS Lambda 함수 호출을 참조하세요.

참고: 호출 시간이 8초를 초과하는 Lambda 함수를 고객 응대 흐름에 포함하려면 Amazon Connect에서 비동기 Lambda 함수를 사용하세요.

여러 Lambda 함수를 호출하는 경우 함수 시퀀스의 기간이 20초 미만인지 확인하세요.

Amazon Connect는 Lambda 함수 시퀀스의 기간을 20초로 제한합니다.

자세한 내용은 Amazon Connect 관리자 가이드의 Amazon Connect 모범 사례에서 Lambda 섹션을 참조하세요.

함수 실패 문제를 일으키는 기타 오류 식별 및 해결

Lambda 함수 실패 문제를 해결하려면 어떻게 해야 합니까?에 나와 있는 지침을 따릅니다.