이메일용 외부 저장소 설정하기

이메일 채널을 사용하려면 외부 저장소를 설정해야 합니다. Cloud Storage 또는 Amazon S3를 외부 스토리지로 사용할 수 있습니다.

Cloud Storage 설정

이메일에 Cloud Storage를 설정하려면 Cloud Storage를 참조하세요.

JSON 서비스 계정 키에 다음 필드가 포함되어 있는지 확인합니다.

  • type: "service_account"

  • project_id

  • private_key_id

  • private_key

  • client_email

  • client_id

  • auth_uri

  • token_uri

  • auth_provider_x509_cert_url

  • Client_x509_cert_url

Amazon S3 스토리지 설정

Amazon S3에 대한 인증을 설정하면 Contact Center AI Platform(CCAI Platform)은 AWS 계정에서 만드는 Identity and Access Management(IAM) 역할을 가정합니다. 이 역할은 CCAI Platform에 Amazon S3 버킷에 액세스하는 데 필요한 권한을 부여합니다.

이 인증 방법의 JSON 서비스 계정 키에는 다음 필드가 필요합니다.

  • region: Amazon S3 버킷이 있는 AWS 리전(예: "us-east-1")

  • role_arn: CCAI Platform에서 사용하는 IAM 역할의 Amazon 리소스 이름(ARN)입니다. 이 ARN은 적절한 액세스 정책으로 구성된 역할을 고유하게 식별합니다.

  • external_id: 역할의 트러스트 정책을 만들 때 제공하는 식별자입니다. CCAI Platform은 역할을 맡도록 요청할 때 이 ID를 전달하여 의도한 항목만 역할을 맡을 수 있도록 합니다.

Amazon S3 JSON 서비스 계정 키를 만들려면 다음 단계를 따르세요.

  1. AWS 계정에 로그인합니다.

  2. IAM 대시보드로 이동합니다.

  3. IAM 대시보드에서 역할을 선택한 다음 역할 만들기를 선택합니다.

  4. 트러스트 관계를 구성하려면 다음 단계를 따르세요.

    1. 신뢰할 수 있는 항목으로 Another AWS account(다른 AWS 계정)을 선택합니다.

    2. 역할을 맡을 항목의 계정 ID를 입력합니다.

    3. 선택사항: 보안 강화를 위해 외부 ID를 추가할 수 있습니다.

  5. 권한을 설정하고 Amazon S3 버킷에 필요한 권한을 역할에 부여하는 정책을 연결합니다. Google 에서는 전체 Amazon S3 액세스 권한이 아닌 필요한 최소 권한(예: 특정 버킷에 대한 읽기 및 쓰기 액세스 권한)이 있는 정책을 사용하는 것이 좋습니다. 필수 Amazon S3 권한은 다음과 같습니다.

    • "s3:ListBucket"

    • "s3:GetObject"

    • "s3:PutObject"

    • "s3:DeleteObject"

  6. 나머지 메시지에 따라 역할을 만듭니다. 역할 ARN이 제공됩니다.

  7. JSON 파일을 만들려면 다음 예시와 같이 역할 ARN과 외부 ID(사용된 경우)를 사용합니다.

    {
  "region": "YOUR-AWS-REGION",
  "role_arn": "YOUR_ROLE_ARN",
  "external_id": "YOUR_EXTERNAL_ID"
}

이메일 저장용량 구성하기

Google Cloud 를 데이터 서버로 사용하는 경우 설정 중에 오류가 발생하지 않도록 Cloud Storage 역할을 스토리지 관리자로 설정해야 합니다. 자세한 내용은 Cloud Storage의 IAM 역할을 참조하세요.

이메일 저장용량을 구성하려면 다음 단계를 따르세요.

  1. CCAI Platform 포털에서 설정 > 개발자 설정을 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.

  2. 이메일 계정 관리 섹션으로 이동한 후 이메일 계정 관리를 클릭합니다.

  3. 데이터 관리 섹션에서 데이터 저장 기간을 선택합니다.

  4. 데이터 서버 섹션에서 Google Cloud 또는 Amazon S3를 선택합니다. 두 옵션 모두에 동일한 정보가 필요합니다.

    • 버킷 이름: 스토리지 버킷의 정확한 이름을 입력합니다.

    • 서비스 계정 키(JSON 파일):Google Cloud 또는 Amazon S3 서비스 계정의 JSON 키 파일을 업로드합니다.

    • 폴더 경로: 이 경로는 자동으로 생성됩니다. 이메일 계정을 연결하면 시스템이 지정된 버킷 내에 폴더를 자동으로 만듭니다.

  5. 연결 테스트를 클릭하여 사용자 인증 정보와 버킷 세부정보가 올바른지 확인합니다.

  6. 저장을 클릭합니다.

시스템은 연결된 이메일 계정의 이메일 데이터를 저장하도록 구성되어 있습니다. 다음과 같은 동작이 예상됩니다.

  • 자동 데이터 동기화: 시스템은 메타데이터 및 첨부파일을 포함한 이메일 데이터를 메일 서버에서 구성된 스토리지 버킷으로 45초마다 자동으로 동기화합니다.

  • 연결 모니터링: 시스템은 이메일 저장소 및 이메일 서버에 대한 연결을 지속적으로 모니터링합니다. 30분 이상 연결을 다시 설정할 수 없는 경우 인스턴스의 관리자에게 자동 알림 이메일이 전송됩니다. 또한 시스템에는 실패한 연결을 다시 설정하는 자동 재시도 로직이 있습니다.

이메일 보관 정책

데이터 관리 섹션에서 설정한 저장 기간은 이메일이 저장소 버킷에 보관되는 기간을 나타냅니다. 이 기간이 지나면 이메일이 저장소에서 삭제됩니다. 설정된 저장 시간 이후에 이메일 대화목록에 답장하는 경우(예: 저장 시간이 60일로 설정되어 있고 61일째에 답장하는 경우) 첨부파일을 포함한 전체 이메일 대화목록이 IMAP 서버에서 검색됩니다. 하지만 3년이 지난 이메일은 표시되지 않습니다.