Amazon Connect를 Amazon Kinesis와 통합하려면 어떻게 해야 하나요?

4분 분량
0

Amazon Connect에서 Amazon Kinesis로 연락처 추적 레코드(CTR) 및 에이전트 이벤트를 스트리밍하고 싶습니다.

간략한 설명

Amazon Connect 인스턴스에서 데이터 스트림을 활성화하면 에이전트 이벤트와 CTR을 Amazon Kinesis Data Firehose나 Amazon Kinesis Data Streams로 스트리밍할 수 있습니다. 에이전트 이벤트는 인스턴스 내 에이전트 활동을 거의 실시간으로 보고합니다. CTR은 인스턴스의 음성 통화, 채팅 및 태스크와 같은 연락처 이벤트의 데이터를 거의 실시간으로 제공합니다.

Amazon Connect를 Kinesis Data Firehose 또는 Kinesis Data Streams와 통합하려면 다음 단계를 완료합니다.

  1. Kinesis Data Firehose 전송 스트림 또는 Kinesis 데이터 스트림을 생성합니다.
  2. 인스턴스의 데이터 스트리밍을 활성화합니다.
  3. 설정을 테스트합니다.

해결 방법

Kinesis Data Firehose 전송 스트림 생성

Amazon Connect를 Kinesis Data Firehose와 통합하려면 다음 단계를 완료합니다.

  1. Kinesis Data Firehose 전송 스트림의 소스, 대상 및 이름을 구성합니다.
    참고: Direct PUT을 사용하면 Kinesis 데이터 스트림을 생성하지 않고도 Amazon Connect에서 데이터를 스트리밍할 수 있는 Kinesis Data Firehose를 생성할 수 있습니다. Kinesis 스트림을 사용하려면 Amazon Connect 데이터에 대한 Kinesis 데이터 스트림을 생성해야 합니다.
  2. (선택 사항) 레코드 데이터를 전환하고 변환하도록 Kinesis Data Firehose를 구성합니다.
  3. (선택 사항) Kinesis Data Firehose 전송 스트림의 백업 및 고급 설정을 구성합니다.
  4. 인스턴스의 데이터 스트리밍을 활성화합니다.
  5. 샘플 데이터를 사용하여 전송 스트림을 테스트합니다.

Kinesis 데이터 스트림 생성

Amazon Connect를 Kinesis Data Streams과 통합하려면 다음 단계를 완료합니다.

  1. AWS Management Console을 사용하여 스트림을 생성합니다.
  2. 인스턴스의 데이터 스트리밍을 활성화합니다.
  3. 설정을 테스트하려면 사용 사례에 따라 다음 단계 세트 중 하나를 완료합니다.

연락처 이벤트에 대한 데이터 스트리밍을 활성화한 경우:

  1. 아웃바운드 또는 인바운드 통화를 걸어 인스턴스에 연락처 레코드를 생성합니다.
  2. 연락처 검색 UI에서 연락처 레코드가 생성되었는지 확인합니다.
  3. 전송 스트림에 구성된 대상에서 연락처 레코드 이벤트를 확인합니다. 연락처 이벤트는 대량으로 전송됩니다. 여러 연락처 ID가 동시에 대상으로 전송되는 것을 확인할 수 있습니다. 예시는 음성 통화가 에이전트와 연결된 경우의 샘플 연락처 이벤트를 참조하세요.

-또는-

에이전트 이벤트에 대한 데이터 스트리밍을 활성화한 경우:

  1. 에이전트가 상태를 변경하거나 연락처와 연결하여 에이전트 이벤트를 생성하도록 합니다.
  2. 에이전트 이벤트의 Kinesis 데이터 스트림에 대해 구성된 대상을 확인합니다. 에이전트 ARN은 데이터가 데이터 스트림으로 전송될 때 사용되는 파티션 키입니다. 단일 에이전트의 모든 이벤트는 동일한 샤드로 전송되며 스트림의 모든 리샤딩 이벤트는 무시됩니다. 예시는 샘플 에이전트 이벤트 스트림을 참조하세요.

오류 식별 및 문제 해결

Kinesis 전송 스트림 대상에 게시된 데이터가 보이지 않습니다.

게시된 데이터가 표시되지 않는 문제를 해결하려면 다음 조치 중 하나 이상을 수행합니다.

  • 선택한 Kinesis 데이터 스트림이 서버 측 암호화에 대해 활성화되었는지 확인합니다. kms:GenerateDataKey를 호출할 권한이 없어서 서버 측 암호화가 활성화된 경우 Amazon Connect는 데이터를 스트림에 게시할 수 없습니다. 이 문제를 해결하려면 Kinesis 스트림에 서버 측 암호화를 사용하는 단계를 수행합니다.
  • Kinesis Data Firehose의 데모 데이터 테스트 옵션을 사용하여 전송 스트림을 테스트하여 전송 스트림이 예상대로 구성되었는지 확인합니다.
  • Kinesis Data Firehose의 데이터 전송 빈도를 검토합니다. 데이터 전송 빈도는 선택한 대상에 따라 달라질 수 있습니다. 5분이 지나도 데이터가 전송되지 않으면 수신 레코드의 전송 스트림 지표를 검토합니다. Kinesis Data Firehose의 오류 로깅을 구성하여 데이터 전송 오류를 캡처할 수 있습니다.

Amazon Connect용 데이터 스트림을 활성화할 때 생성한 Kinesis Data Firehose나 Kinesis Data Stream을 선택할 수 없습니다.

먼저 Kinesis Data Firehose 또는 Kinesis Data Stream이 Amazon Connect 인스턴스와 동일한 AWS 리전에 존재하는지 확인합니다. 서비스가 동일한 리전에 있는 경우 스트림을 나열할 수 있는 권한이 누락되었을 수 있습니다. Kinesis Data Firehose용 ListDeliveryStreams 또는 Kinesis Data Streams용 ListStreams와 같은 권한이 부여되었는지 확인합니다.

AWS Command Line Interface(AWS CLI) 명령 associate-instance-storage-config를 사용하여 데이터 스트리밍을 활성화할 수도 있습니다.

참고: AWS Command Line Interface(AWS CLI) 명령을 실행할 때 오류가 발생할 경우 AWS CLI의 최신 버전을 사용하고 있는지 확인하세요.

어디에서 에이전트 이벤트 또는 연락처 추적 레코드(CTR)에 액세스할 수 있나요?

에이전트 이벤트 및 CTR이 Kinesis Data Streams로 전송되는 경우 Kinesis Console의 데이터 뷰어를 사용하여 데이터를 확인하세요. 또한 소비자가 Kinesis 데이터 스트림의 데이터를 처리하도록 구성할 수 있습니다. 예를 들어 Kinesis Data Firehose를 생성하여 Kinesis 데이터 스트림의 데이터를 에이전트 이벤트에 사용할 수 있습니다.

CTR이 Kinesis Data Firehose로 전송되면 전송 스트림에 대해 구성된 대상의 CTR에 액세스할 수 있습니다. 예를 들어 대상이 Amazon Simple Storage Service(S3) 버킷인 경우 선택한 S3 버킷의 CTR에 액세스할 수 있습니다. Kinesis Data Firehose를 생성할 때 Amazon S3 대상 버킷을 선택합니다.

연락처 추적 레코드(CTR)에 대해 두 개 이상의 Kinesis 전송 스트림을 구성할 수 있나요?

기본적으로 CTR에는 하나의 전송 스트림만 지원됩니다. 하지만 여러 소비자를 사용하여 Kinesis Data Stream에 대한 CTR을 위한 여러 전송 스트림을 보유할 수 있습니다. 이 구성을 사용하려면 Kinesis 데이터 스트림이 CTR 데이터의 생산자 역할을 해야 합니다. 그런 다음 여러 소비자가 데이터를 수집하도록 구성할 수 있습니다. Kinesis Data Streams의 소비자에 대한 자세한 내용은 Amazon Kinesis Data Streams의 데이터 읽기를 참조하세요.

내 Kinesis Data Streams 애플리케이션에 게시된 Amazon Connect의 데이터가 중복 표시됩니다.

생산자 재시도 및 소비자 재시도 때문에 중복 데이터가 발생할 수 있습니다. 재시도에 대한 복원력을 높이려면 최종 데이터의 대상이 중복을 처리하도록 하는 것이 가장 좋습니다.


관련 정보

Amazon Connect 에이전트 이벤트 스트림

Amazon Connect 연락처 이벤트

Amazon Kinesis Data Streams란 무엇인가요?

Amazon Kinesis Data Firehose란 무엇인가요?

AWS 공식
AWS 공식업데이트됨 일 년 전